Go datadog statsd
Need help with datadog-go?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.
DataDog

Description

go dogstatsd client library for datadog

219 Stars 100 Forks MIT License 194 Commits 20 Opened issues

Services available

Need anything else?

Build Status

Datadog Go

Godoc license

datadog-go
is a library that provides a DogStatsD client in Golang.

Go 1.12+ is officially supported. Older versions might work but are not tested.

The following documentation is available:

Installation

Get the code with:

$ go get github.com/DataDog/datadog-go/statsd

Then create a new DogStatsD client:

package main

import ( "log" "github.com/DataDog/datadog-go/statsd" )

func main() { statsd, err := statsd.New("127.0.0.1:8125") if err != nil { log.Fatal(err) } }

Find a list of all the available options for your DogStatsD Client in the Datadog-go godoc documentation or in Datadog public DogStatsD documentation.

Supported environment variables

  • If the
    addr
    parameter is empty, the client uses the
    DD_AGENT_HOST
    and (optionally) the
    DD_DOGSTATSD_PORT
    environment variables to build a target address.
  • If the
    DD_ENTITY_ID
    environment variable is found, its value is injected as a global
    dd.internal.entity_id
    tag. The Datadog Agent uses this tag to insert container tags into the metrics. To avoid overwriting this global tag, only
    append
    to the
    c.Tags
    slice.

To enable origin detection and set the

DD_ENTITY_ID
environment variable, add the following lines to your application manifest:
env:
  - name: DD_ENTITY_ID
    valueFrom:
      fieldRef:
        fieldPath: metadata.uid
  • DD_ENV
    ,
    DD_SERVICE
    , and
    DD_VERSION
    can be used by the statsd client to set
    {env, service, version}
    as global tags for all data emitted.

Unix Domain Sockets Client

Agent v6+ accepts packets through a Unix Socket datagram connection. Details about the advantages of using UDS over UDP are available in the DogStatsD Unix Socket documentation. You can use this protocol by giving a

unix:///path/to/dsd.socket
address argument to the
New
constructor.

Usage

In order to use DogStatsD metrics, events, and Service Checks, the Agent must be running and available.

Metrics

After the client is created, you can start sending custom metrics to Datadog. See the dedicated Metric Submission: DogStatsD documentation to see how to submit all supported metric types to Datadog with working code examples:

Metric names must only contain ASCII alphanumerics, underscores, and periods. The client will not replace nor check for invalid characters.

Some options are suppported when submitting metrics, like applying a sample rate to your metrics or tagging your metrics with your custom tags. Find all the available functions to report metrics in the Datadog Go client GoDoc documentation.

Events

After the client is created, you can start sending events to your Datadog Event Stream. See the dedicated Event Submission: DogStatsD documentation to see how to submit an event to your Datadog Event Stream.

Service Checks

After the client is created, you can start sending Service Checks to Datadog. See the dedicated Service Check Submission: DogStatsD documentation to see how to submit a Service Check to Datadog.

Performance / Metric drops

Monitoring this client

This client automatically injects telemetry about itself in the DogStatsD stream. Those metrics will not be counted as custom and will not be billed. This feature can be disabled using the

WithoutTelemetry
option.

See Telemetry documentation to learn more about it.

Tweaking kernel options

In very high throughput environments it is possible to improve performance by changing the values of some kernel options.

Unix Domain Sockets

  • sysctl -w net.unix.max_dgram_qlen=X
    - Set datagram queue size to X (default value is usually 10).
  • sysctl -w net.core.wmem_max=X
    - Set the max size of the send buffer for all the host sockets.

Maximum packets size in high-throughput scenarios

In order to have the most efficient use of this library in high-throughput scenarios, default values for the maximum packets size have already been set to have the best usage of the underlying network. However, if you perfectly know your network and you know that a different value for the maximum packets size should be used, you can set it with the option

WithMaxBytesPerPayload
. Example:
package main

import ( "log" "github.com/DataDog/datadog-go/statsd" )

func main() { statsd, err := statsd.New("127.0.0.1:8125", WithMaxBytesPerPayload(4096)) if err != nil { log.Fatal(err) } }

Development

Run the tests with:

$ go test

License

datadog-go is released under the MIT license.

Credits

Original code by ooyala.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.