About

PyMunin Multigraph Munin Plugin for monitoring Asterisk Telephony Server.

Multigraph Plugin: Yes
Multi-instance Plugin: Yes

Graphs

The plugin implements the following graphs:

  • asterisk_calls

  • asterisk_channels

  • asterisk_peers_sip

  • asterisk_peers_iax2

  • asterisk_voip_codecs

  • asterisk_conferences

  • asterisk_voicemail

  • asterisk_trunks

  • asterisk_queue_len

  • asterisk_queue_avg_hold

  • asterisk_queue_avg_talk

  • asterisk_queue_calls

  • asterisk_queue_abandon_pcent

  • asterisk_fax_attempts

Samples

Sample graphs for plugin:

Asterisk Calls Asterisk Trunks
Asterisk SIP Peers Asterisk IAX2 Peers
Asterisk Channels Asterisk VoIP Codecs

Configuration

Configuration variables are passed to the Munin Plugins using environment variables. The environment variables for plugins are usually set in the plugin configuration files in the folder: /etc/munin/plugin-conf.d

The configuration variables implemented by the plugin are listed in the following table:

Variable Description
amihost IP of Asterisk Server.
(Default: 127.0.0.1)
amiport Asterisk Manager Interface Port.
(Default: 5038)
amiuser Asterisk Manager Interface User.
amipass Asterisk Manager Interface Password.
list_channels List of channels that will be shown in channel stats.
(Default: dahdi,zap,sip',iax2,local)
Note: Channel expressions are case insensitive.
list_codecs List of codecs that will be shown in VoIP channel stats.
Any codec that is not in the list will be counted as 'other'.
(Default: alaw,ulaw,gsm,g729)
Note: Channel expressions are case insensitive.
list_trunks Comma separated search expressions of the following formats:
- "Trunk Name"="Regular Expr"
- "Trunk Name"="Regular Expr with Named Group 'num'"="MIN"-"MAX"
Check Python Regular Expressions docs for help on writing regular expressions: http://docs.python.org/library/re.html
Note: Trunk expressions are case insensitive.
include_queues Comma separated list of queues to include in graphs.
(All queues included by default.)
exclude_queues Comma separated list of queues to exclude from graphs.
include_graphs Comma separated list of enabled graphs.
(All graphs enabled by default.)
exclude_graphs Comma separated list of disabled graphs.

Additionally the following configuration variables are implemented by the plugin for Multi Instance support:

Variable Description
instance_name Name of instance.
instance_label Graph title label for instance. (Default is the same as instance name.)
instance_label_format Controls how the instance label will be added to the graph title:
  • suffix (Default)
  • prefix
  • none

Credits

Asterisk Telephony Server Plugin ( asteriskstats ) has been developed by Ali Onur Uyar ([aouyar @ GitHub] (https://github.com/aouyar)).

License

Asterisk Telephony Server Plugin ( asteriskstats ) is copyrighted free software made available under the terms of the GPL License Version 3 or later.

See the file COPYING that acompanies the code for full licensing information.