Table of Contents

Asterisk SNMP Monitoring

Asterisk includes the res_snmp.so module designed to provide monitoring information via SNMP. Particularly useful when used together with Zabbix remote monitoring.

Note: AstLinux 1.1.2 or later is required

System SNMP Configuration

Example: /mnt/kd/snmp/snmpd.conf

com2sec notConfigUser default public

group notConfigGroup v1  notConfigUser
group notConfigGroup v2c notConfigUser

view all included .1
view system included .iso.org.dod.internet.mgmt.mib-2.system

access notConfigGroup "" any noauth exact all none none

syslocation Omaha, NE
syscontact AstLinux - www.astlinux-project.org

agentaddress udp:127.0.0.1:161

master agentx
agentXSocket /var/agentx/master
agentXPerms 0660 0550

sysObjectID .1.3.6.1.4.1.22736.1

Edit syslocation and syscontact for your location.

Apply snmpd.conf changes, restart snmpd service using CLI:

service snmpd stop
service snmpd init

With the system snmpd.conf changes applied, you should see useful information with the following commands.

Example snmp commands using CLI:

# Linux uname -a
snmpget -OQv -v2c -c public 127.0.0.1 SNMPv2-MIB::sysDescr.0

# System uptime
snmpget -OQv -v2c -c public 127.0.0.1 SNMPv2-MIB::sysUpTime.0

# List network interfaces
snmpwalk -OQv -v2c -c public 127.0.0.1 IF-MIB::ifDescr

Asterisk SNMP Configuration

Enable SNMP in Asterisk by editing /etc/asterisk/res_snmp.conf in the [general] section:

;
; Configuration file for res_snmp
;---------------------------------
;
; -- snip --

[general]
; We run as a subagent per default -- to run as a full agent
; we must run as root (to be able to bind to port 161)
subagent = yes
; SNMP must be explicitly enabled to be active
enabled = yes

Apply the res_snmp.conf change in Asterisk, unload and load the res_snmp.so module, or restart the asterisk service.

With both the system snmpd.conf and Asterisk res_snmp.conf changes applied, you should see useful information with the following commands.

Example snmp commands using CLI:

# Walk Asterisk SNMP tree
snmpwalk -v2c -c public 127.0.0.1 ASTERISK-MIB::asterisk

# Asterisk Version
snmpget -OQv -v2c -c public 127.0.0.1 ASTERISK-MIB::astVersionString.0

# Number of active channels
snmpget -OQv -v2c -c public 127.0.0.1 ASTERISK-MIB::astNumChannels.0

# List active channels
snmpwalk -OQv -v2c -c public 127.0.0.1 ASTERISK-MIB::astChanName