CI Trivy Release Docker Pulls

A local DogStatsD protocol inspector for debugging metrics, service checks, and events

• All DogStatsD message types — metrics (count, gauge, set, timer, histogram, distribution), service checks, events
• Multiple output formats — pretty, json, short, raw
• Metric forwarding — proxy datagrams to an upstream DogStatsD server while inspecting locally
• Catppuccin colors — pretty format adapts to your terminal's light/dark theme

Install with Homebrew:

brew install mroyme/tap/dogstatsd-local

Or with Go:

go install github.com/mroyme/dogstatsd-local/cmd/dogstatsd-local@latest

Or run with Docker:

docker run -it -e "TERM=$TERM" -p 8125:8125/udp mroyme/dogstatsd-local

Or download a prebuilt binary for Linux, macOS, or Windows (x86-64 and ARM64).

Then start it up and point your service at it:

export DD_AGENT_HOST=127.0.0.1
export DD_DOGSTATSD_PORT=8125

Or test manually with netcat:

# Metric
printf "page.views:1|c|#env:dev" | nc -u -w1 localhost 8125
# Service check
printf "_sc|Redis connection|2|#env:dev|m:Timeout" | nc -u -w1 localhost 8125
# Event
printf "_e{21,21}:An exception occurred|Cannot parse CSV file|t:warning|#err_type:bad_file" | nc -u -w1 localhost 8125

Pretty format output

Machine-readable, one JSON object per line. Pipe through jq for pretty printing:

{
 "namespace": "page",
 "name": "views",
 "path": "page.views",
 "value": 1,
 "sample_rate": 1,
 "tags": ["env:dev"]
}

Compact human-readable:

metric:count|page.views|1.00 env:dev
service_check:Redis connection|CRIT|msg:Timeout env:dev
event:title|text|priority:normal|alert:info

Passthrough of the original datagram:

page.views:1|c|#env:dev

Run as a middleware between your app and the Datadog agent:

Application → dogstatsd-local (8126) → Datadog agent (8125)

dogstatsd-local -port 8126 -forward 127.0.0.1:8125

All datagrams are forwarded as-is — no modification, no data loss.

Full documentation is available at mroyme.github.io/dogstatsd-local.

• Installation
• Configuration
• Connecting Your Service
• Output Formats
• Forwarding
• Protocol Reference
• Contributing

Started as a fork of jonmorehouse/dogstatsd-local, which was no longer receiving updates. Since then, this project has diverged significantly — adding service check and event support, multiple output formats, Catppuccin-themed colors, metric forwarding, and more.