Checkly ORG

Code, test, and deploy synthetic monitoring at scale.

77 repos
262 followers
0 following

JavaScript 32%
TypeScript 30%
Go 8%
Vue 8%
HTML 6%

Checkly Go SDK This project is a Go SDK for Checkly monitoring service. It allows you to handle your checks, check groups, snippets, environments variables and everything you can do…

Checkly Go SDK

!Contributor Covenant
![Tests](https://github.com/checkly/checkly-go-sdk/actions/workflows/test.yml)
![GoDoc](http://godoc.org/github.com/checkly/checkly-go-sdk)
![Go Report Card](https://goreportcard.com/report/github.com/checkly/checkly-go-sdk)
!GitHub go.mod Go version
!GitHub tag (latest by date)

This project is a Go SDK for Checkly monitoring service. It allows you to handle your checks, check groups, snippets, environments variables and everything you can do with our REST API.

Installation

To use the client library with your Checkly account, you will need an API Key for the account. Go to the Account Settings: API Keys page and click 'Create API Key'.

Make sure your project is using Go Modules (it will have a go.mod file in its root if it already is):

bash
$ go mod init

Then, add the reference of checkly-go-sdk in a Go program using import:

go
import checkly &quot;github.com/checkly/checkly-go-sdk&quot;

Run any of the normal go commands (build/install/test) and the Go toolchain will resolve and fetch the checkly-go-sdk module automatically.

Alternatively, you can also explicitly go get the package into a project:

bash
$ go get -u github.com/checkly/checkly-go-sdk

Getting Started

Create a new checkly Client by calling checkly.NewClient() (you will need to set your Checkly API Key and Account ID)

go
baseUrl := &quot;https://api.checklyhq.com&quot;
apiKey := os.Getenv(&quot;CHECKLY_API_KEY&quot;)
accountId := os.Getenv(&quot;CHECKLY_ACCOUNT_ID&quot;)

client := checkly.NewClient(
	baseUrl,
	apiKey,
	nil, //custom http client, defaults to http.DefaultClient
	nil, //io.Writer to output debug messages
)

client.SetAccountId(accountId)

> Note: if you don't have an API key, you can create one at here

Create your first checks

Once you have a client, you can create a check. See here how to create your first API & Browser checks.

go
apiCheck := checkly.Check{
	Name:                 &quot;My API Check&quot;,
	Type:                 checkly.TypeAPI,
	Frequency:            5,
	Activated:            true,
	Locations: []string{
		&quot;eu-west-1&quot;,
		&quot;ap-northeast-2&quot;,
	},
	Tags: []string{ &quot;production&quot; },
	Request: checkly.Request{
		Method: http.MethodGet,
		URL:    &quot;https://api.checklyhq.com/v1&quot;,
	},
}

browserCheck := checkly.Check{
	Name:          &quot;My Browser Check&quot;,
	Type:          checkly.TypeBrowser,
	Frequency:     5,
	Activated:     true,
	Locations:     []string{&quot;eu-west-1&quot;},
	Script: `const assert = require(&quot;chai&quot;).assert;
	const puppeteer = require(&quot;puppeteer&quot;);

	const browser = await puppeteer.launch();
	const page = await browser.newPage();
	await page.goto(&quot;https://example.com&quot;);
	const title = await page.title();

	assert.equal(title, &quot;Example Site&quot;);
	await browser.close();`,
}

ctx := context.WithTimeout(context.Background(), time.Second * 5)
client.CreateCheck(ctx, apiCheck)
client.CreateCheck(ctx, browserCheck)

> A complete example program! You can see an example program which creates a Checkly check in the [demo](demo/main.go) folder.

Questions

For questions and support please open a new discussion. The issue list of this repo is exclusively for bug reports and feature/docs requests.

Issues

Please make sure to respect issue requirements and choose the proper issue template when opening an issue. Issues not conforming to the guidelines may be closed.

Contribution

Please make sure to read the Contributing Guide before making a pull request.

License

MIT

Members

All public repos (77)

Show forks Show archived

More creators on gitmyhub

llSourcell dmalan mouredev taylorotwell wesbos