ASTERISK-MIB

All MIBs › ASTERISK-MIB

Organization: Digium, Inc.

Last Updated: 2008-06-20

Category: Telephony and VoIP

Description: Provides monitoring of Asterisk open-source PBX systems, including channel counts, active call statistics, and module status.

Start monitoring vendor-neutral, standards-based MIB, any SNMPv3-capable network device (SNMP engine identity/boot/clock status) with a free 30-day trial of IPNetwork Monitor. Import MIBs, browse SNMP OIDs, create custom SNMP monitors, configure alerts, and monitor any SNMP-enabled network device from a single console.

What Is ASTERISK-MIB?

ASTERISK-MIB is a community MIB for monitoring the Asterisk open-source PBX/telephony server software, exposing SNMP visibility into a running Asterisk instance's configuration and call-handling state. It provides data covering system uptime, configuration reload timestamps, process identifiers, active/processed call counts, loaded module counts, and current indication status. Its monitoring emphasis is squarely on software status: astConfigUpTime tracks how long the Asterisk process/service has been running, astConfigPid identifies the running process, astNumModules reflects loaded module health, and astConfigCallsActive/astConfigCallsProcessed give real-time call load, together forming a software-service health and performance picture rather than physical hardware data. It depends on standard SNMP conventions and the host's SNMP agent (e.g., Net-SNMP) for transport, since Asterisk itself is a software application rather than a network appliance. It is typically deployed on Linux servers running Asterisk in VoIP/PBX environments where operators want ASTERISK-MIB SNMP monitoring as a complement to traditional Asterisk CLI/AMI tools.

IPNetwork Monitor allows you to monitor SNMP objects defined in ASTERISK-MIB. Use the built-in SNMP Monitoring Browser to explore available variables, view their current values and descriptions, and select the objects you want to monitor. You can then create SNMP monitors, configure thresholds, and receive alerts when monitored values change.

Supported Devices

Asterisk PBX servers (Linux hosts running Asterisk)

Monitoring Examples

Sample objects include astConfigUpTime, astConfigReloadTime, astConfigPid, astConfigCallsActive, astConfigCallsProcessed, and astNumModules under the asteriskConfiguration/asteriskModules groups. An administrator would poll astConfigCallsActive to track real-time concurrent call load and compare it against astConfigCallsProcessed over time to compute call throughput and detect drops in traffic. A sudden reset of astConfigUpTime alongside an unexpected astConfigPid value would reveal that the Asterisk process crashed and restarted.

What Can Be Monitored

Asterisk process uptime
configuration reload timestamp
process ID
active call count
calls processed
number of loaded modules
current indication/tone state

Imported Objects

From DIGIUM-MIB

digium

MODULE-IDENTITY

From SNMPv2-SMI

Counter32
Gauge32
Integer32
MODULE-IDENTITY
OBJECT-TYPE
TimeTicks
Unsigned32

From SNMPv2-TC

DisplayString
TEXTUAL-CONVENTION
TruthValue

How to Use in IPNetwork Monitor

Example using astConfigCallsProcessed OID:

Select an Asterisk PBX server (Linux hosts running Asterisk) as the target host to create a monitor — the SNMP service should be up and running on it. Click New Monitor, then check SNMP Custom on the Favorites tab, click Next, and confirm the host. On the next page, click Select... to open the built-in SNMP MIB Browser and type astConfigCallsProcessed into the Find box to locate it in the OID tree, then select it and click OK. The total number of calls processed through the Asterisk PBX since last restart. On the monitor's Main parameters page you can set the target's SNMP port (default 161), credentials, polling interval, and other settings — see the SNMP Monitor help for details. On the State conditions and Alerting tabs, configure when the monitor should change state and trigger an alert; since this is a Counter32-type OID, Value bounds is the most useful condition here — trigger an alert if the counter increases sharply between polls relative to its normal baseline, since an unexpected spike often reflects a real change in traffic or activity. Click Finish to create the monitor; you can adjust any parameter later.

OIDs

OID symbolic	OID numeric	Type	Access	Description
STR astChanAccountCode	1.3.6.1.4.1.22736.1.5.2.1.18	DisplayString	read-only	Account Code for billing.
INT astChanADSI	1.3.6.1.4.1.22736.1.5.2.1.36	INTEGER	read-only	Whether or not ADSI is detected on CPE.
INT astChanAMAFlags	1.3.6.1.4.1.22736.1.5.2.1.35	INTEGER	read-only	AMA Flags.
STR astChanApp	1.3.6.1.4.1.22736.1.5.2.1.10	DisplayString	read-only	Current application for the channel.
STR astChanBridge	1.3.6.1.4.1.22736.1.5.2.1.6	DisplayString	read-only	Which channel this channel is currently bridged (in a conversation) with.
U32 astChanCallGroup	1.3.6.1.4.1.22736.1.5.2.1.21	Unsigned32	read-only	Call Group.
STR astChanCidANI	1.3.6.1.4.1.22736.1.5.2.1.29	DisplayString	read-only	ANI
I32 astChanCidANI2	1.3.6.1.4.1.22736.1.5.2.1.32	Integer32	read-only	ANI 2 (info digit).
STR astChanCidDNID	1.3.6.1.4.1.22736.1.5.2.1.26	DisplayString	read-only	Dialled Number ID.
STR astChanCidName	1.3.6.1.4.1.22736.1.5.2.1.28	DisplayString	read-only	Caller Name.
STR astChanCidNum	1.3.6.1.4.1.22736.1.5.2.1.27	DisplayString	read-only	Caller Number.
STR astChanCidPresentation	1.3.6.1.4.1.22736.1.5.2.1.31	DisplayString	read-only	Number Presentation/Screening.
STR astChanCidRDNIS	1.3.6.1.4.1.22736.1.5.2.1.30	DisplayString	read-only	Redirected Dialled Number Service.
I32 astChanCidTNS	1.3.6.1.4.1.22736.1.5.2.1.34	Integer32	read-only	Transit Network Select.
I32 astChanCidTON	1.3.6.1.4.1.22736.1.5.2.1.33	Integer32	read-only	Type of Number.
STR astChanContext	1.3.6.1.4.1.22736.1.5.2.1.12	DisplayString	read-only	Current extension context.
STR astChanData	1.3.6.1.4.1.22736.1.5.2.1.11	DisplayString	read-only	Arguments passed to the current application.
astChanEntry	1.3.6.1.4.1.22736.1.5.2.1		not-accessible	Details of a single channel.
STR astChanExten	1.3.6.1.4.1.22736.1.5.2.1.16	DisplayString	read-only	Current extension.
BIT astChanFlags	1.3.6.1.4.1.22736.1.5.2.1.40	Bits	read-only	Flags set on this channel.
STR astChanForwardTo	1.3.6.1.4.1.22736.1.5.2.1.19	DisplayString	read-only	Where to forward to if asked to dial on this interface.
INT astChanHangupCause	1.3.6.1.4.1.22736.1.5.2.1.38	INTEGER	read-only	Why is the channel hung up.
I32 astChanIndex	1.3.6.1.4.1.22736.1.5.2.1.1	Integer32	read-only	Index into the channel table.
STR astChanLanguage	1.3.6.1.4.1.22736.1.5.2.1.3	DisplayString	read-only	Which language the current channel is configured to use -- used mainly for prompts.
STR astChanMacroContext	1.3.6.1.4.1.22736.1.5.2.1.13	DisplayString	read-only	Current macro context.
STR astChanMacroExten	1.3.6.1.4.1.22736.1.5.2.1.14	DisplayString	read-only	Current macro extension.
I32 astChanMacroPri	1.3.6.1.4.1.22736.1.5.2.1.15	Integer32	read-only	Current macro priority.
STR astChanMasq	1.3.6.1.4.1.22736.1.5.2.1.7	DisplayString	read-only	Channel masquerading for us.
STR astChanMasqr	1.3.6.1.4.1.22736.1.5.2.1.8	DisplayString	read-only	Channel we are masquerading for.
STR astChanMusicClass	1.3.6.1.4.1.22736.1.5.2.1.5	DisplayString	read-only	Music class to be used for Music on Hold for this channel.
T/F astChanMuted	1.3.6.1.4.1.22736.1.5.2.1.24	TruthValue	read-only	Transmission of voice data has been muted.
STR astChanName	1.3.6.1.4.1.22736.1.5.2.1.2	DisplayString	read-only	Name of the current channel.
U32 astChanPickupGroup	1.3.6.1.4.1.22736.1.5.2.1.22	Unsigned32	read-only	Pickup Group.
I32 astChanPri	1.3.6.1.4.1.22736.1.5.2.1.17	Integer32	read-only	Current priority.
I32 astChanRings	1.3.6.1.4.1.22736.1.5.2.1.25	Integer32	read-only	Number of rings so far.
astChanScalars	1.3.6.1.4.1.22736.1.5.5
INT astChanState	1.3.6.1.4.1.22736.1.5.2.1.23	INTEGER	read-only	Channel state.
astChanTable	1.3.6.1.4.1.22736.1.5.2		not-accessible	Table with details of the currently active channels in the Asterisk instance.
STR astChanToneZone	1.3.6.1.4.1.22736.1.5.2.1.37	DisplayString	read-only	Indication zone to use for channel.
INT astChanTransferCap	1.3.6.1.4.1.22736.1.5.2.1.41	INTEGER	read-only	Transfer Capabilities for this channel.
STR astChanType	1.3.6.1.4.1.22736.1.5.2.1.4	DisplayString	read-only	Underlying technology for the current channel.
G32 astChanTypeChannels	1.3.6.1.4.1.22736.1.5.4.1.7	Gauge32	read-only	Number of active channels using the current technology.
STR astChanTypeDesc	1.3.6.1.4.1.22736.1.5.4.1.3	DisplayString	read-only	Description of the channel type (technology).
T/F astChanTypeDeviceState	1.3.6.1.4.1.22736.1.5.4.1.4	TruthValue	read-only	Whether the current technology can hold device states.
astChanTypeEntry	1.3.6.1.4.1.22736.1.5.4.1		not-accessible	Information about a technology we support, including how many channels are currently using this technology.
I32 astChanTypeIndex	1.3.6.1.4.1.22736.1.5.4.1.1	Integer32	read-only	Index into the table of channel types.
T/F astChanTypeIndications	1.3.6.1.4.1.22736.1.5.4.1.5	TruthValue	read-only	Whether the current technology supports progress indication.
STR astChanTypeName	1.3.6.1.4.1.22736.1.5.4.1.2	DisplayString	read-only	Unique name of the technology we are describing.
astChanTypeTable	1.3.6.1.4.1.22736.1.5.4		not-accessible	Table with details of the supported channel types.
T/F astChanTypeTransfer	1.3.6.1.4.1.22736.1.5.4.1.6	TruthValue	read-only	Whether the current technology supports transfers, where Asterisk can get out from inbetween two bridged channels.
STR astChanUniqueId	1.3.6.1.4.1.22736.1.5.2.1.20	DisplayString	read-only	Unique Channel Identifier.
STR astChanVariables	1.3.6.1.4.1.22736.1.5.2.1.39	DisplayString	read-only	Channel Variables defined for this channel.
TIK astChanWhenHangup	1.3.6.1.4.1.22736.1.5.2.1.9	TimeTicks	read-only	How long until this channel will be hung up.
G32 astConfigCallsActive	1.3.6.1.4.1.22736.1.2.5	Gauge32	read-only	The number of calls currently active on the Asterisk PBX.
C32 astConfigCallsProcessedEx	1.3.6.1.4.1.22736.1.2.6	Counter32	read-only	The total number of calls processed through the Asterisk PBX since last restart.
I32 astConfigPid	1.3.6.1.4.1.22736.1.2.3	Integer32	read-only	The process id of the running Asterisk process.
TIK astConfigReloadTime	1.3.6.1.4.1.22736.1.2.2	TimeTicks	read-only	Time ticks since Asterisk was last reloaded.
STR astConfigSocket	1.3.6.1.4.1.22736.1.2.4	DisplayString	read-only	The control socket for giving Asterisk commands.
TIK astConfigUpTime	1.3.6.1.4.1.22736.1.2.1	TimeTicks	read-only	Time ticks since Asterisk was started.
STR astCurrentIndication	1.3.6.1.4.1.22736.1.4.2	DisplayString	read-only	Default indication zone to use.
asterisk	1.3.6.1.4.1.22736.1			Asterisk is an Open Source PBX. This MIB defined objects for managing Asterisk instances.
asteriskChannels	1.3.6.1.4.1.22736.1.5
asteriskConfiguration	1.3.6.1.4.1.22736.1.2
asteriskIndications	1.3.6.1.4.1.22736.1.4
asteriskModules	1.3.6.1.4.1.22736.1.3
asteriskVersion	1.3.6.1.4.1.22736.1.1
STR astIndAlias	1.3.6.1.4.1.22736.1.4.3.1.3	DisplayString	read-only
STR astIndCountry	1.3.6.1.4.1.22736.1.4.3.1.2	DisplayString	read-only	Country for which the indication zone is valid, typically this is the ISO 2-letter code of the country.
STR astIndDescription	1.3.6.1.4.1.22736.1.4.3.1.4	DisplayString	read-only	Description of the indication zone, usually the full name of the country it is valid for.
astIndicationsEntry	1.3.6.1.4.1.22736.1.4.3.1		not-accessible	Information about a single indication zone.
astIndicationsTable	1.3.6.1.4.1.22736.1.4.3		not-accessible	Table with all the indication zones currently know to the running Asterisk instance.
I32 astIndIndex	1.3.6.1.4.1.22736.1.4.3.1.1	Integer32	read-only	Numerical index into the table of indication zones.
G32 astNumChanBridge	1.3.6.1.4.1.22736.1.5.5.1	Gauge32	read-only	Number of channels currently in a bridged state.
G32 astNumChannels	1.3.6.1.4.1.22736.1.5.1	Gauge32	read-only	Current number of active channels.
I32 astNumChanTypes	1.3.6.1.4.1.22736.1.5.3	Integer32	read-only	Number of channel types (technologies) supported.
I32 astNumIndications	1.3.6.1.4.1.22736.1.4.1	Integer32	read-only	Number of indications currently defined in Asterisk.
I32 astNumModules	1.3.6.1.4.1.22736.1.3.1	Integer32	read-only	Number of modules currently loaded into Asterisk.
STR astVersionString	1.3.6.1.4.1.22736.1.1.1	DisplayString	read-only	Text version string of the version of Asterisk that the SNMP Agent was compiled to run against.
U32 astVersionTag	1.3.6.1.4.1.22736.1.1.2	Unsigned32	read-only	SubVersion revision of the version of Asterisk that the SNMP Agent was compiled to run against -- this is typically 0 for release-versions of Asterisk.

RFC description

Monitors Asterisk open-source PBX systems, providing channel counts, active call statistics, and module status information.

Start monitoring Asterisk PBX servers (Linux hosts running Asterisk) with a free 30-day trial of IPNetwork Monitor. Import MIBs, browse SNMP OIDs, create custom SNMP monitors, configure alerts, and monitor any SNMP-enabled network device from a single console.

Download ASTERISK-MIB