Monitor Yeastar P-Series Software Edition through SNMP using Zabbix Server

This topic takes Zabbix Server as an example to show you how to monitor Yeastar P-Series Software Edition 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 Software Edition 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 Software Edition MIB to add desired items.

  1. On Configuration > Hosts, search and find the PBX host.
  2. Click Items beside the host.

  3. At the top-right corner, click Create item.
  4. Under Item tab, configure the item.

    • 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.
  5. Optional: Click Test > Get value and test to test if the configuration works, then close the window.

  6. Click Add.

Step 3. Monitor Yeastar P-Series Software Edition on Zabbix Server

After you add monitoring items, you can view the latest data collected by items.

  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.