DataDog / datadog-api-client-go

datadog-api-client-go This repository contains a Go API client for the Datadog API. Requirements • Go 1.22+ Layout This repository contains per-major-version API client packages. Right now, Datadog has two API versions, , and the common package. The API v1 Client The client library for Datadog API v1 is located in the directory. Import it with The API v2 Client The client library for Datadog API v2 is located in the directory. Import it with The Datadog Package The datadog package for Datadog API is located in the directory. Import it with Getting Started Here's an example creating a user: Save it to , then run . Set the and to your Datadog credentials, and then run . Unstable Endpoints This client includes access to Datadog API endpoints while they are in an unstable state and may undergo breaking changes. An extra configuration step is required to enable these endpoints: where is the name of the method used to interact with that endpoint. For example: , or Changing Server When talking to a different server, like the instance, change the : Disable compressed payloads If you want to disable GZIP compressed responses, set the flag on your configuration object: Enable requests logging If you want to enable requests logging, set the flag on your configuration object: Enable retry If you want to enable retry when getting status code rate-limited or , set to The default max retry is , you can change it with Configure proxy If you want to configure proxy, set env var , and or set custom with proxy configured on configuration object: Pagination Several listing operations have a pagination method to help consume all the items available. For example, to retrieve all your incidents: Encoder/Decoder By default, datadog-api-client-go uses the Go standard library to encode and decode data. As an alternative users can opt in to use by specifying the go build tag . In comparison, there was a significant decrease in cpu time with with an increase in memory overhead. For further benchmark information, see benchmark section. Documentation Developer documentation for API endpoints and models is available on Github pages. Released versions are available on pkg.go.dev. Contributing As most of the code in this repository is generated, we will only accept PRs for files that are not modified by our code-generation machinery (changes to the generated files would get overwritten). We happily accept contributions to files that are not autogenerated, such as tests and development tooling. Author support@datadoghq.com