mroyme/dogstatsd-local repository overview

⁠dogstatsd-local

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

⁠Features

• 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

⁠Quick Start

Run with Docker:

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

Point your service at it:

export DD_AGENT_HOST=127.0.0.1
export DD_DOGSTATSD_PORT=8125

⁠Documentation

Full documentation is available at dogstatsd.mroy.dev⁠.

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