Home Directory Plugins Telephony Asterisk check_peer_status - Check Asterisk SIP/IAX Peer Status

Search Exchange

Search All Sites

Nagios Live Webinars

Let our experts show you how Nagios can help your organization.

Contact Us

Phone: 1-888-NAGIOS-1
Email: sales@nagios.com


Remember Me

Directory Tree

check_peer_status - Check Asterisk SIP/IAX Peer Status

12 votes
Current Version
Last Release Date
Compatible With
  • Nagios 3.x
Network Monitoring Software - Download Nagios XI
Log Management Software - Nagios Log Server - Download
Netflow Analysis Software - Nagios Network Analyzer - Download
This plugin works with Nagios NRPE to check the status of a selected SIP/IAX peer on Asterisk or in alternative it can list all peers.

Then it Returns the Status (OK, Lagged, Unreachble or Unknown) with a proper Sig code (ok, warning, critical, unknown).

* Contact me if you need help: a.zorzetto AT gmail DOT com *

USAGE: Check_peer_status [options]

--version show program's version number and exit
-h, --help show this help message and exit
-u USER, --username=USER
username for AMI.
-s SECRET, --secret=SECRET
password for AMI.
the host to connect to. The default is localhost.
-P PORT, --port=PORT the port to contact. Default is 5038.
-t TYPE, --type=TYPE sip or iax are allowed values.
-p PEER, --peer=PEER the peer name to check.
-a, --all print the whole output.
-v, --verbose print the whole output.


to check an IAX peer:
$PATH/check_peer_status -H ip_asterisk -u username -s secret -t iax -p peername

to check an SIP peer:
$PATH/check_peer_status -H ip_asterisk -u username -s secret -t sip -p peername

to list all peers
$PATH/check_peer_status -H ip_asterisk -u username -s secret -t iax -a
$PATH/check_peer_status -H ip_asterisk -u username -s secret -t sip -a

- 0.2.2 it can monitor the unknown status of the peers, generally when a peer is configured but never connected
Reviews (6)
bygerdesj, May 18, 2017
It seems that by default the socket will not timeout if the PBX is unreachable or the Manager permissions are incorrect. Add something like this, before the line starting mysocket=. The number is in seconds:
mysocket = socket.socket(socket.AF_INET, socket.SOCK_STREAM)

Returning performance data would be nice as well but given the plugin is clearly written that is not too hard to add in yourself. Good stuff - thank you.
I dont know what to do at manager.conf to accept connections from the nrpe agent on the localhost.
Could you help me ?
Owner's reply

You can try something like this:

enabled = yes
port = 5038
bindaddr =
webenabled = no

secret = password
permit= #the network address where the nagios server is
read = system,call,log,verbose,command,agent,user,originate

bykarl67l, June 25, 2014
A little of time to understand how to use it to discover that all has been weel explained in the description.

OK for me
bystuartm, June 25, 2014
Very well written code useful to monitor my Asterisk
bystuartb, June 25, 2014
In a few minutes I configured my Asterisk manager and got my trunks monitored on my the Nagios instance of my company.

I big thank you Andrea
bysach3000, July 29, 2013
1 of 1 people found this review helpful
Critical - Cannot contact Asterisk! and all
Owner's reply

You have to configure your manager.conf to accept connections from the nrpe agent on the localhost