StatsD

Agent Check

Supported OS:

Overview

This check monitors the availability and uptime of non-Datadog StatsD servers. It also tracks the number of metrics, by metric type, received by StatsD.

This check does NOT forward application metrics from StatsD servers to Datadog. It collects metrics about StatsD itself.

Setup

Installation

The StatsD check is included in the Datadog Agent package, so you don’t need to install anything else on any servers that run StatsD.

Configuration

Host

Follow the instructions below to configure this check for an Agent running on a host. For containerized environments, see the Containerized section.

Edit the statsd.d/conf.yaml in the conf.d/ folder at the root of your Agent’s configuration directory. See the sample statsd.d/conf.yaml for all available configuration options:
```
    init_config:

    instances:
        - host: localhost
        port: 8126 # or wherever your statsd listens
```
Configuration Options
- host (Optional) - Host to be checked. This will be included as a tag: host:<host>. Defaults to localhost.
- port (Optional) - Port to be checked. This will be included as a tag: port:<port>. Defaults to 8126.
- timeout (Optional) - Timeout for the check. Defaults to 10 seconds.
- tags (Optional) - Tags to be assigned to the metric.
Restart the Agent to start sending StatsD metrics and service checks to Datadog.

Containerized

For containerized environments, see the Autodiscovery Integration Templates for guidance on applying the parameters below.

Parameter	Value
`<INTEGRATION_NAME>`	`statsd`
`<INIT_CONFIG>`	blank or `{}`
`<INSTANCE_CONFIG>`	`{"host": "%%host%%", "port":"8126"}`

Validation

Run the Agent’s status subcommand and look for statsd under the Checks section.

Data Collected

Metrics

statsd.counters.count (gauge)	The number of counter metrics currently seen by StatsD
statsd.gauges.count (gauge)	The number of gauge metrics currently seen by StatsD
statsd.timers.count (gauge)	The number of timer metrics currently seen by StatsD

Events

The StatsD check does not include any events.

Service Checks

statsd.is_up:

Returns CRITICAL if the StatsD server does not respond to the Agent’s health status request, otherwise OK.

statsd.can_connect:

Returns CRITICAL if the Agent cannot collect metrics about StatsD, otherwise OK.

Troubleshooting

Need help? Contact Datadog support.