dogstatsd-local

README

dogstatsd-local

A local DogStatsD protocol inspector. Listen on a UDP socket, parse metrics, service checks, and events, and print them to stdout in your choice of format.

Why?

Datadog is great for production metric aggregation. dogstatsd-local lets you inspect and debug metrics before sending them to Datadog — no account required, no agent needed, no metrics polluted.

Quick Start

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

printf "page.views:1|c|#env:dev" | nc -u -w1 localhost 8125

COUNT      page | views                                      1.00           env:dev

Features

• All DogStatsD message types — metrics, service checks, events
• 4 output formats — pretty, json, short, raw
• Forwarding — proxy datagrams to an upstream DogStatsD server
• Catppuccin colors — pretty format adapts to light/dark terminal themes
• Zero dependencies — single binary, no Datadog account needed

Documentation

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

• Installation
• Configuration
• Output Formats
• Forwarding
• Protocol Reference
• Contributing

Acknowledgments

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.