StatsD is an industry standard for communicating arbitrary statistics and other metrics in a vendor-independent way via UDP. Dynatrace OneAgent comes with a StatsD daemon out of the box. This means that any application or library that supports StatsD can send metrics to Dynatrace. You only need to install OneAgent and make sure that your StatsD client uses the right port (18125 by default).

Enable DynatraceStatsD

The DynatraceStatsD listener comes with OneAgent version 1.201+. You only need to enable DynatraceStatsD metric ingestion at the environment or host level. Note that the host-level configuration overrides the environment configuration.

Communication port

The default DynatraceStatsD UDP listening port is 18125. If necessary, you can use oneagentctl command-line interface to check or change the metric ingestion port. Changing the port requires restart of OneAgent. Add –restart-service to the command to restart OneAgent automatically.

Check the ingestion port

Use the --get-extensions-statsd-port parameter to show the current DynatraceStatsd UDP listening port (default = 18125).

  • Linux: ./oneagentctl --get-extensions-statsd-port
  • Windows: .\oneagentctl.exe --get-extensions-statsd-port

Set a custom ingestion port

Use the --set-extensions-statsd-port=<arg> parameter to set a custom DynatraceStatsd UDP listening port.

  • Linux: ./oneagentctl --set-extensions-statsd-port=18125 –restart-service
  • Windows: .\oneagentctl.exe --set-extensions-statsd-port=18125 –restart-service

Topology awareness

Using the DynatraceStatsD, the host ID and host name context are added as dimensions to each metric automatically. For more information, see Metric ingestion. Note that we're already working on more automatic metric enrichments.


The DynatraceStatsD listener only accepts input from localhost addresses. This means that only processes that are running on the same host as OneAgent can leverage the interface. This ensures that no unauthorized programs are sending data to your Dynatrace environment.

StatsD metric format

DynatraceStatsD accepts the gauge and count metrics in the native StatsD format

<metric name>:<value>|g

where g is a gauge metric value.

DynatraceStatsD extends the original protocol to enable you to also send dimensions. Use the following format:

<metric name>:<value>|g|#<Dimension1>:<value>,<Dimension2>:<value>