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.
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.
To configure this check for an Agent running on a host:
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
Restart the Agent to start sending StatsD metrics and service checks to Datadog.
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"} |
Collecting logs is disabled by default in the Datadog Agent, you need to enable it in datadog.yaml:
logs_enabled: true
Add this configuration block to your statsd.d/conf.yaml file to start collecting your Supervisord Logs:
logs:
- type: file
path: /path/to/my/directory/file.log
source: statsd
Change the path parameter value and configure it for your environment.
See the sample statsd.d/conf.yaml for all available configuration options.
Run the Agent’s status subcommand and look for statsd under the Checks section.
| 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 |
The StatsD check does not include any events.
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.
Need help? Contact Datadog support.
If you don’t know what StatsD is and how does it work, check out our blog post about it
To get a better idea of how (or why) to visualize StatsD metrics with Counts Graphing with Datadog, check out our series of blog posts about it.