Skip to content
FluxtailDocs

StatsD

Fluxtail accepts StatsD and DogStatsD lines over UDP and stores each sample as a log event. It is not a time-series metrics database.

Prerequisites

Section titled “Prerequisites”

Create a StatsD receiver, add the sender’s public IPv4 or CIDR, wait for active, and copy its exact hostname and assigned port. StatsD has no token or encryption.

Send a known sample

Section titled “Send a known sample”
Terminal window
export FLUXTAIL_STATSD_HOST='YOUR_POOL_HOSTNAME'
export FLUXTAIL_STATSD_PORT='YOUR_ASSIGNED_PORT'


printf 'api.requests:1|c|#env:prod,service:checkout\nrequest.latency:320|ms|@0.5\n' |
  nc -u -w1 "$FLUXTAIL_STATSD_HOST" "$FLUXTAIL_STATSD_PORT"

Verify

Section titled “Verify”

Open the receiver’s stream in Live Tail and filter for api.requests.

Troubleshooting

Section titled “Troubleshooting”
  • Confirm the receiver endpoint is active.
  • Confirm the sender’s public IPv4 matches a source rule.
  • Confirm outbound UDP to the assigned port is allowed.
  • Do not put secrets in metric names, values, or tags.

Use a shared HTTP receiver if the sender needs authenticated, encrypted delivery.

Next steps

Section titled “Next steps”

Confirm metric names and tags with search and filters, then decide whether UDP’s delivery tradeoffs fit the workload. The StatsD project’s metric type reference documents the supported line formats.