Configuration¶
All options are CLI flags. Run dogstatsd-local -h to see defaults.
Flags¶
| Flag | Default | Description |
|---|---|---|
-host |
0.0.0.0 |
Bind address |
-port |
8125 |
UDP listen port |
-out |
pretty |
Output format: pretty, json, short, raw |
-forward |
(disabled) | Forward raw datagrams to an upstream DogStatsD server (e.g. 127.0.0.1:8126) |
-tags |
(empty) | Extra tags to append, comma-delimited |
-max-name-width |
50 |
Max name length for pretty format (values below 50 have no effect) |
-max-value-width |
15 |
Max value length for pretty format |
-debug |
false |
Enable debug logging |
By default, dogstatsd-local listens on port 8125 — the same port the Datadog agent uses. If you're already running an agent on that port, use -port to listen on a different port and -forward to send traffic to the agent.
Examples¶
Default pretty output on port 8125:
dogstatsd-local
JSON output with extra tags:
dogstatsd-local -out json -tags env:dev,team:platform
Listen on port 8126 and forward to the Datadog agent on 8125:
dogstatsd-local -port 8126 -forward 127.0.0.1:8125
Custom column widths for long metric names:
dogstatsd-local -max-name-width 80 -max-value-width 20