res_statsd

Since 12.0.0 Module Configuration Found this useful? Upvote it. ×

StatsD client

Last reviewed 2026-08-22

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 channelA single call leg passing through Asterisk. Channels represent connections to endpoints and are what dialplan applications act on. 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

Know a tip or gotcha for this topic? Share it below and help others.

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.

Moderated before publishing. Email never shown.