Monitoring Asterisk with Munin

I had a few requests for these munin plugins after some discussion on one of the Asterisk lists and thought people might like them.

There are four scripts (three of which are based on a script by Paul McCormack.

Basically you just add them the same way as normal munin plugins.

By the way, if you're using Debian, installing munin is as simple as apt-get install munin and apt-get install munin-node.

So, the plugins:

asterisk_channels

This plugin displays concurrent Asterisk channels.

asterisk_iax_peers

This plugin shows IAX peers (online/offline/unmonitored online/offline)

asterisk_sip_peers

This plugin shows SIP peers (online/offline/unmonitored online/offline)

munin_asr_php

This one connects to the MySQL CDR database and shows how things have been over the last hour (number of calls answered, not answered, busy, congested).

You'll need to set your CDR database/table and the MySQL connection details in this one.

Let me know if you have any questions.

Current Rating: 9.78/10 (9 votes)

Comments (12 posted)

Install Problem
Written by switch - http://lynks.ru (January 8, 2010, 11:37 am)

How correctly to put plug-ins?
I have copied them in /usr/share/munin/plugins,
Has made symbolical references in /etc/munin/plugins, then

/usr/share/munin/munin-update - force-root
/usr/share/munin/munin-html - force-root
/usr/share/munin/munin-graph - force-root
service munin-node restart

Graphs have appeared, but the data - is not present.
What to do?

How To Install And Configure Plugins
Written by Adrian (January 8, 2010, 11:37 am)

how to install and configure these plugins? you have a tutorial?

Plugins
Written by Matt Riddell - http://www.venturevoip.com (January 8, 2010, 11:39 am)

Yeah, sounds like you're doing the right thing - basically just symlink the plugins like any other.

Note that the plugins can be run on their own too - you don't need munin.

So, first step is to make sure they're executable (i.e. chmod +x filename)

Next, just run the plugin (i.e. ./munin_asr_php)

It should return the data - if it doesn't something's not right - although I suspect it's just a permissions issue.

Same Issue
Written by pguima (January 12, 2010, 3:31 pm)

I did the same thing as switch, but still no graph and no data. I'm trying to run this on trixbox. Any help?

Plugins
Written by Matt Riddell - http://www.venturevoip.com (January 12, 2010, 3:33 pm)

Did you run the plugins manually?

I.E. change to their location and type ./astersk_sip_peers

Restart Munin
Written by UKnewWho (January 25, 2010, 11:49 am)

After you install the scripts to the munin folder (/usr/share/munin/plugins) then symbolic link (ln -s /user/share/munin/plugs/munin_asr_php /etc/munin/plugsins) your need to restart the munin service /etc/init.d/munin restart for munin to see the new scripts

Jrobin Files
Written by Sarika Bhosale - http://Opennms (May 24, 2010, 1:30 pm)

Hi This is Sarika
How to open Jrobin file in windows..
the comamand given in Opennms documentation is not working in windows.. anybody knows how to do it?

Contribute To Munin-exchange
Written by Troex - http://elrte.org (February 25, 2011, 2:55 pm)

Why don't you post this plugins to http://exchange.munin-monitoring.org/ ? It was hard to find them.

Alternative Asterisk/Munin Plugin Source
Written by GMc - http://rodolphe.quiedeville.org/hack/munin/asterisk-1.4/ (February 25, 2011, 2:55 pm)

http://rodolphe.quiedeville.org/hack/munin/asterisk-1.4/

Graphs
Written by Matt Riddell - http://www.venturevoip.com (April 11, 2011, 11:48 am)

Hmmm strange, looks like the script is returning the correct data - you sure the file is executable and in the right place?

Written by varnav (July 1, 2011, 11:45 am)

Maybe user, under which the script is run, has insufficient permissions.

Add to plugins.conf

[asterisk*]
user root

Multigraph Munin Asterisk Plugin
Written by Ali Onur Uyar - http://aouyar.github.com/PyMunin (July 1, 2011, 11:45 am)

I've recently published some python code for a Multigraph Munin Plugin for monitoring Asterisk. I have not added any detailed installation instructions yet, but you might still give a try. Just make sure the pysysinfo folder is copied to a directory in the Python module search path.

Bye

Similar Articles (Based on Title)

Asterisk Installation CD set. with 24/7 monitoring - March 27, 2005
Paul Mahler of signate.com has posted a note to the Asterisk-Users list on a new commercial Asterisk CD Set.

*starShop: Open Source Calling Shop Monitoring System - August 19, 2005
The writers of a new open source call shop monitoring system have mailed us to let you know of their first release.

New GTK Gui for Monitoring and Administration - July 12, 2006
j has posted details of a new GUI for Asterisk.

Tutorial: Simple queue and agent debug monitoring - October 11, 2006
Lenz has posted another tutorial, this one on receiving just the information you need in a call center.

Asterisk RTP Monitoring - September 25, 2009
Tzafrir has committed some documentation to his branch for RTP Monitoring.

Monitoring Asterisk with OpenNMS - January 8, 2010
The OpenNMS blog has an article on monitoring Asterisk with OpenNMS using SNMP.

Asterisk Monitoring with iPhone and iPod touch - February 12, 2010
For the past couple of weeks I have been working on an app that allows you to monitor and restart Asterisk servers.

Interview With Flash Operator Panel Developer - September 19, 2004
Interview with Nicolas Gudino, the author of the Flash Operator Panel for Asterisk.

Interview With FreeBSD Developer - September 21, 2004
Interview With Dr Rich Murphy of FreeBSD and Asterisk FreeBSD fame

Link: Article with Asterisk running home server - October 2, 2004
Running a Wireless network in your neighbourhood with Asterisk terminating VOIP calls.

Asterisk-Users: Request for IAX debug session transcript with IAXy - October 11, 2004
Held needed getting IAXy debug's for phone manufacturer's implementation of IAX

DUNDi is available for use with v1-0 - October 23, 2004
BKW has released a .tar.gz file so that you can use DUNDi with Asterisk 1.0

Asterisk-Dev: patch for chan_capi to compile with latest CVS - November 18, 2004
Frank Sautter has created a patch to allow chan_capi-0.3.5 to compile against CVS-HEAD and adds capiAnswerFax patch

Interview with Mark Spencer - November 26, 2004
We have managed to get an interview with Mark Spencer AKA Markster. Mark Spencer is the creator of Asterisk and by far the most active developer.