res_statsd

Since 12.0.0 Module Configuration

StatsD client

Last reviewed 2026-04-14

Description

The res_statsd module provides an API that allows Asterisk and its modules to send statistics to a StatsD server. It only provides a means to communicate with a StatsD server and does not send any metrics of its own.

An example module, res_chan_stats, is provided which uses the API exposed by this module to send channel statistics to the configured StatsD server.

More information about StatsD can be found at https://github.com/statsd/statsd

statsd.conf

[global]

Global configuration settings

enabled - Enable/disable the StatsD module
server - Address of the StatsD server
prefix - Prefix to prepend to every metric
add_newline - Append a newline to every event. This is useful if you want to fake out a server using netcat (nc -lu 8125)
meter_support - Enable/disable the non-standard StatsD Meter type, if disabled falls back to counter and will append a "_meter" suffix to the metric name

User Notes

No notes yet. Be the first to contribute a tip or example.

Contribute a note

Share a tip, gotcha, or practical example. Keep it under 2000 characters. No questions (use the Asterisk community forums for support). Wrap code in backticks.