Asterisk

check_peer_status – Check Asterisk SIP/IAX Peer Status

Description:

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]

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.
-H HOSTNAME, –host=HOSTNAME
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.

EXAMPLES:

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

CHANGELOG:
– 0.2.2 it can monitor the unknown status of the peers, generally when a peer is configured but never connected

Current Version

0.2.2

Last Release Date

2013-02-14

Compatible With

  • Nagios 3.x

Owner


Project Files
Project Notes
Reviews (6) Add a Review
Timeout
by gerdesj, May 31, 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: socket.setdefaulttimeout(30) ... 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.



how to enable nrpe agent in manager.conf
by maticue, January 31, 2015

I dont know what to do at manager.conf to accept connections from the nrpe agent on the localhost. Could you help me ?



Great work
by karl67l, June 30, 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



Excellent
by stuartm, June 30, 2014

Very well written code useful to monitor my Asterisk



It worked very well
by stuartb, June 30, 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



not working
by sach3000, July 31, 2013

Critical - Cannot contact Asterisk! and all



Add a Review

You must be logged in to submit a review.

Thank you for your review!

Your review has been submitted and is pending approval.

Recommend

To:


From:


Thank you for your recommendation!

Your recommendation has been sent.

Project Stats
Rating
4.3 (12)
Favorites
0
Views
63,119