Skip to content

StatsD agent

If your application supports the StatsD protocol, you can quickly deploy the Zenoss backend for the gostatsd server to monitor the application with Zenoss Cloud. If it does not, you can either configure the gostatsd server to supply the information Zenoss Cloud requires, or make some lightweight modifications to your application code. Zenoss provides application code examples for 5 widely-used programming languages.


Events are written to STDOUT (dropped).

StatsD metric types

The Zenoss backend supports the StatsD gauge metric type directly, while the other metric types (counter, set, and timing) are converted to gauge equivalents.

For more information about StatsD metric types, refer to the StatsD documentation.

Counter (count and rate)

The StatsD counter metric syntax:


The Zenoss backend converts counter metrics into two separate metrics:

<counter-name>.total = <value>
<counter-name>.rate = <rate>

Gauge (arbitrary value)

The StatsD gauge metric syntax:


The Zenoss backend converts gauge metrics into one metric:

<gauge-name> = <value>

Set (unique occurrences since last flush)

The StatsD set metric syntax:


In the Zenoss backend, the number of elements in the set is the value:

<set-name> = <value>

Timing (milliseconds)

The syntax of the StatsD timing metric varies by the type of calculation gostatsd performs. The Zenoss backend converts the timing metrics it receives into separate metrics for each enabled subtype:

<timer-name>.lower (lower boundary)
<timer-name>.upper (upper boundary)
<timer-name>.count_ps (count per second)
<timer-name>.std (standard deviation)
<timer-name>.<percentile> (for each enabled percentile)

Configuration variables

The configuration variables for the Zenoss backend for the gostatsd server

  • configure the server for interaction with Zenoss Cloud
  • specify tags that create a Zenoss Cloud entity to represent the server
  • specify tags that associate the server's internal metrics with the server's entity

For information about general gostatsd server configuration settings, refer to the gostatsd README file.


For the Zenoss backend for the gostatsd server, the value of the reserved tag name source-type must be com.atlassian.gostatsd. For more information, see Using entities.

Variables for interaction with Zenoss Cloud

Zenoss API endpoint

The Zenoss API endpoint. Replace the default with the endpoint for your organization, if necessary. For the list of alternate endpoints, see Zenoss API endpoints.

Configuration variable address
Environment variable ZENOSS_ADDRESS
Required Yes

Authentication key

The authentication key for this server.

Configuration variable api-key
Environment variable ZENOSS_API_KEY
Required Yes
Default (none)


Control TLS. Use one or both of these variables when a proxy server is required in your environment.

Configuration variables disable-tls,
Environment variables ZENOSS_DISABLE_TLS,
Required No
Default false

Metrics per batch

The number of metrics in a batch. In testing, values greater than the default increased the error rate.

Configuration variable metrics-per-batch
Environment variable ZENOSS_METRICS_PER_BATCH
Required No
Default 1000

Models per batch

The number of entity models in a batch. In testing, values greater than the default increased the error rate.

Configuration variable models-per-batch
Environment variable ZENOSS_MODELS_PER_BATCH
Required? No
Default 100

Entity dimensions

The names of entity dimension tags, which uniquely identify the entity that represents the server.

Configuration variable model-dimension-tags
Required No
Default (none)

Entity metadata

The names of entity metadata tags.

Configuration variable model-metadata-tags
Required No
Default (none)

Metric dimensions

The names of metric dimension tags. This value must match the value assigned to the model-dimension-tags variable.

Configuration variable metric-dimension-tags
Required Yes
Default (none)

Metric metadata

The names of metric metadata tags.

Configuration variable metric-metadata-tags
Required No
Default (none)