statsd

Pushes metrics using the StatsD protocol. Supported tagging formats are 'none', 'datadog' and 'influxdb'.

Common

# Common config fields, showing default values
metrics:
  statsd:
    address: "" # No default (required)
    flush_period: 100ms
    tag_format: none
  mapping: ""

Advanced

# All config fields, showing default values
metrics:
  statsd:
    address: "" # No default (required)
    flush_period: 100ms
    tag_format: none
    send_queue_capacity: 10
    buf_pool_capacity: 20
    send_loop_count: 1
  mapping: ""

Fields

address

The address to send metrics to.

Type: string

flush_period

The time interval between metrics flushes.

Type: string
Default: "100ms"

tag_format

Metrics tagging is supported in a variety of formats.

Type: string
Default: "none"
Options: none, datadog, influxdb.

send_queue_capacity

The size of the internal queue of packets ready to be sent over UDP. Increase this if you see '[STATSD] N packets lost (overflow)' warnings under high throughput or CPU-constrained environments.

Type: int
Default: 10

buf_pool_capacity

The size of the pre-allocated UDP packet buffer pool.

Type: int
Default: 20

send_loop_count

The number of goroutines sending UDP packets. Increase under high throughput.

Type: int
Default: 1