You are viewing docs on Elastic's new documentation system, currently in technical preview. For all other Elastic docs, visit

StatsD Input

StatsD Input Package

Beta feature

This functionality is in beta and is subject to change. The design and code is less mature than official generally available features and is being provided as-is with no warranties. Beta features are not subject to the support service level agreement of official generally available features.

What is an Elastic integration?

This integration is powered by Elastic Agent. Elastic Agent is a single, unified way to add monitoring for logs, metrics, and other types of data to a host. It can also protect hosts from security threats, query data from operating systems, forward data from remote services or hardware, and more. Refer to our documentation for a detailed comparison between Beats and Elastic Agent.

Prefer to use Beats for this use case? See Filebeat modules for logs or Metricbeat modules for metrics.

The statsd input package spawns a UDP server and listens for metrics in StatsD compatible format. This input can be used to collect metrics from services that send data over the StatsD protocol. To tailor the data you can provide custom mappings and ingest pipelines through Kibana.

Metric types

The input supports the following types of metrics:

Counter (c):: Measurement which accumulates over a period of time until flushed (value set to 0).

Gauge (g):: Measurement which can increase, decrease or be set to a value.

Timer (ms):: Time measurement (in milliseconds) of an event.

Histogram (h):: Time measurement, an alias for the Timer.

Set (s):: Measurement which counts unique occurrences until flushed (value set to 0).


Node.js version v18.12.1 is used to test the Statsd input package


Enhancement View pull request
Improve documentation for the package.
Enhancement View pull request
Add system tests for the package.
Bug fix View pull request
Fix config to take host instead of hosts
Enhancement View pull request
Update Kibana version to 8.8.0
Enhancement View pull request
Rename ownership from obs-service-integrations to obs-infraobs-integrations
Enhancement View pull request
Add base fields mappings
Enhancement View pull request
Added categories and/or subcategories.
Enhancement View pull request
Initial draft of the Statsd Input