Monitor Yeastar P-Series PBX System through SNMP using Zabbix Server

This topic takes Zabbix Server as an example to show you how to monitor Yeastar P-Series PBX System through SNMP.

Prerequisites

Procedure

Step 1. Add a host to Zabbix Server

A host in Zabbix is a network entity (physical or virtual) that you want to monitor. In this example, we will add a host for Yeastar P-Series PBX System on Zabbix Server.

  1. On the left navigation bar, go to Configuration > Hosts.
  2. At the top-right corner, click Create host.
  3. Under the Host tab, complete the following settings.
    1. In the Host name field, enter a name to help you identify the host. In this example, enter P-Series PBX.
    2. In the Groups field, enter the name of an existing group or click Select to select a group.
    3. In the Interfaces section, remove the default agent, then add a host.
      1. Click Remove to remove the default agent.

      2. Click Add, select SNMP, then complete the following settings:

        Setting Description
        IP address Enter the IP address of PBX. In this example, enter 192.168.28.39.
        Port Enter the SNMP port that is configured on PBX. In this example, retain 161.
        SNMP Version Select SNMPv3.
        Security name Enter the SNMPv3 username that is configured on PBX. In this example, enter yeastardemo.
        Security level Select the authentication mode that is specified on PBX.
        • noAuthNoPriv: This option corresponds to NoAuth on PBX.

        • authNoPriv: This option corresponds to Auth on PBX.

          If you choose this option, you need to set Authentication protocol to MD5, and enter the authentication passphrase.

        • authPriv: This option corresponds to Priv on PBX.

          If you choose this option, you need to set Authentication protocol to MD5 and Privacy protocol to DES, and enter the authentication passphrase and privacy passphrase.
  4. Click Add.

    The host is added successfully. You can check it on the Hosts list.

Step 2. Add monitoring items to the host

A monitoring item defines a single metric or what kind of data to collect from a host. In this example, we will add monitoring items to collect data from the PBX host.

You can add monitoring items in the following ways:
Import monitoring items

We provide the Yeastar PBX MIB file (in .mib format) for you to quickly import items to a Network Management System (NMS).

In this example, Zabbix doesn't support .mib format, so you need to convert the MIB file to the compatible format .xml, .json, .yaml, or .yml, then follow the instructions below to import monitoring items via template.

  1. On the left navigation bar, go to Configuration > Templates.
  2. At the top-right corner, click Import, select the MIB file, then click Import.

    You can check the imported template in the Templates list.

  3. On the left navigation bar, go to Configuration > Hosts, search and find the PBX host, then go to the host detail page.
  4. Click the Templates tab, search and select the imported template in the Link new templates field, then click Update.

    On the Hosts list, you will find the template and the items are linked with PBX host successfully.

Manually add monitoring items

We provide a list of MIB objects as a reference for manually adding items on NMS. Check against the Yeastar P-Series PBX System MIB to add desired items.

  1. Go to the creation page of monitoring items.
    1. On Configuration > Hosts, search and find the PBX host.
    2. Click Items beside the host.

  2. Add SNMP agent items to monitor and retrieve data from PBX.
    1. At the top-right corner, click Create item.
    2. Under Item tab, configure the following settings.

      • Name: Enter a name to help you identify the item. In this example, enter DeviceName.
      • Type: Select SNMP agent.
      • Key: Enter the name of the MIB object. In this example, enter pDeviceName.
      • SNMP OID: Enter the OID of the MIB object. In this example, enter 1.3.6.1.4.1.22736.3.2.1.0.
      • Type of information: Select the information type. In this example, select Character.

    3. Optional: Click Test > Get value and test to test if the configuration works, then close the window.

    4. Click Add.
  3. Add SNMP trap items to monitor and receive trap messages from PBX.
    1. At the top-right corner, click Create item.
    2. Under Item tab, configure following settings.

      • Name: Enter a name to help you identify the item. In this example, enter SIPTrunkDown.
      • Type: Select SNMP trap.
      • Key: Enter a regular expression, in the format of snmptrap[{snmp_oid}]. In this example, enter snmptrap[1.3.6.1.4.1.22736.3.3.2.1].
      • Type of information: Select the information type. In this example, select Character.
    3. Click Add.

Step 3. Add triggers and actions

Add triggers and actions to receive timely alerts upon some condition change on PBX.

  1. Add triggers to automatically evaluate whether the monitoring item reaches a threshold.
    1. Click Triggers beside the host.

    2. At the top-right corner, click Create trigger.
    3. Under Trigger tab, configure the trigger.

      • Name: Enter a name to help you identify the trigger. In this example, enter SIPTrunkDown.
      • Expression: Click Add to define the problem expression.

    4. Click Add.

  2. Add actions to send notifications when the monitoring item reaches a threshold.
    1. On the left navigation bar, click Actions, then click Create action.

    2. Under Action tab, set the conditions upon which operations will be carried out.

      • Name: Enter a name to help you identify the action.
      • Condition: Click Add to add a new condition for a trigger.
    3. Under Operations tab, click Add to set the operations to carry out.

    4. Click Add.
    5. Click Add.

Result

  • When a threshold is reached, notifications will be sent to the specified user.

  • You can view the latest data collected by items on Zabbix.

    1. On the left navigation bar, go to Monitoring > Hosts, search and find the PBX host.
    2. Click Latest data beside the host.

      You can view the latest data of the PBX.