Skip to content

StatsD Input

Listens for StatsD metrics over UDP and converts them to JSON.

How it works

  1. Binds a UDP socket on the configured address.
  2. Parses incoming StatsD line protocol (metric:value|type|@rate|#tags).
  3. Each metric is converted to a JSON object with name, value, type, sample_rate, and tags fields.
  4. Namespace convention: statsd.

Configuration

yaml
data_sources:
  source:
    Statsd:
      listen_address: "0.0.0.0:8125"

Configuration variables

VariableDefaultDescription
listen_address0.0.0.0:8125UDP address to listen on
formatjsonData format

Authentication

No connector-specific authentication is required.

Troubleshooting

SymptomFix
port already in useChoose a different listen address or stop the process currently using that UDP port.
metrics are missingCheck sender configuration, network reachability, and any host firewall rules blocking UDP traffic.

This site is source-available under PolyForm Shield 1.0.0