![]() * [datadog] Update go-datadog-api library Involves one breaking API change. Also some `gofmt`ing. * [datadog] Add support for new_host_delay to the datadog_monitor resource New API parameter that Datadog added for monitors to ignore new hosts for the specified time period in monitor evaluation. |
||
---|---|---|
.. | ||
integration | ||
LICENSE | ||
Makefile | ||
README.md | ||
alerts.go | ||
checks.go | ||
client.go | ||
comments.go | ||
convert_types.go | ||
dashboards.go | ||
downtimes.go | ||
events.go | ||
monitors.go | ||
ratelimit.go | ||
request.go | ||
screen_widgets.go | ||
screenboards.go | ||
search.go | ||
series.go | ||
snapshot.go | ||
tags.go | ||
users.go |
README.md
Datadog API in Go
Hi!
This is a Go wrapper for the Datadog API. You should use this library if you need to interact with the Datadog system. You can post metrics with it if you want, but this library is probably mostly used for automating dashboards/alerting and retrieving data (events, etc).
The source API documentation is here: http://docs.datadoghq.com/api/
USAGE
To use this project, include it in your code like:
import "github.com/zorkian/go-datadog-api"
Then, you can work with it:
client := datadog.NewClient("api key", "application key")
dash, err := client.GetDashboard(10880)
if err != nil {
log.Fatalf("fatal: %s\n", err)
}
log.Printf("dashboard %d: %s\n", dash.Id, dash.Title)
That's all; it's pretty easy to use. Check out the Godoc link for the available API methods and, if you can't find the one you need, let us know (or patches welcome)!
DOCUMENTATION
Please see: http://godoc.org/github.com/zorkian/go-datadog-api
BUGS/PROBLEMS/CONTRIBUTING
There are certainly some, but presently no known major bugs. If you do find something that doesn't work as expected, please file an issue on Github:
https://github.com/zorkian/go-datadog-api/issues
Thanks in advance! And, as always, patches welcome!
DEVELOPMENT
- Run tests tests with
make test
. - Integration tests can be run with
make testacc
. Run specific integration tests withmake testacc TESTARGS='-run=TestCreateAndDeleteMonitor'
The acceptance tests require DATADOG_API_KEY and DATADOG_APP_KEY to be available in your environment variables.
Warning: the integrations tests will create and remove real resources in your Datadog account.
COPYRIGHT AND LICENSE
Please see the LICENSE file for the included license information.
Copyright 2013 by authors and contributors.