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.