Monitor Wildix PBX using Zabbix

Monitor Wildix PBX using Zabbix

 

The Guide explains how to set up and use Zabbix for monitoring Wildix PBX.

Created: June 2018

Updated: January 2026

Permalink: https://wildix.atlassian.net/wiki/x/mRDOAQ

Zabbix should be installed and running on a separate server. 

Step 1. Setup of zabbix-agent

1. Access PBX via SSH as root:

  • Go to WMS and select Terminal from the top secondary menu 

Note: Terminal is available only for admin users.

  • Access PBX via SSH as a root 

    su wildix (Password line) !1

2. Create a file:

  • Use the command: 

    nano-tiny /etc/zabbix/zabbix_agentd.d/my.conf
  • Enter two lines: 

    StartAgents=3 Server=192.168.0.1

where 192.168.0.1 is the IP address of your server

3. Restart zabbix-agent:

Use the command: 

systemctl restart zabbix-agent.service

Step 2. Setup of zabbix-server

  1. Download the template file from https://files.wildix.com/images/zabbix-templates/wildix.xml 

  2. Access Zabbix -> Configuration -> Templates

  3. Click Choose File to upload the template file that you have saved on your PC, then click Import

  1. Go to Configuration -> Hosts

  2. Click Create host and fill in:

    • Host name

    • Groups: select group(s) from “Other groups” section and move the selected group(s) to “In groups” section

    • Agent interfaces: enter IP address or DNS name of your Wildix PBX (depending on what you selected, choose Connect to IP or DNS

  3. Click Add

  1. Go to Configuration -> Templates

  2. Click Group and select “Wildix Templates” from the list

  3. Tick off “Template Wildix-PBX” and click Select

  1. Go to Configuration -> Hosts and find your Host on the list by its Host name

Status: “Enabled” (green)

ZBX: green (it might take some time for ZBX icon to turn green)

Ports used by Zabbix

  • 8099 TCP for IP 52.18.154.170 

  • 10050 TCP for local Zabbix

To check it, use the command: 

/etc/zabbix/zabbix_agentd.conf

Monitoring tools

  1. Go to Monitoring -> Graphs

  2. Select your Host in the upper right section

  3. Select the Graph from the list of available graphs:

  • Callweaver Restart

  • Collaboration Users

  • CPU jumps

  • CPU load

  • CPU utilization

  • Disc space usage*

  • Memory usage

  • Network traffic*

  • PBX temperature cpu

  • PBX temperature mb

  • PBX users

  • Phone calls

  • SIP Proxy Restarts

*these sensors become available after some time (it is necessary to update the web page)

Monitoring problems

  • Go to Monitoring -> Problems. Here you can see what issues you currently have with PBX. Issues are those triggers that are in the “Problem” column. When a trigger is detected, a new problem notification appears in the list. Refer to this chapter to see what each column means

  • Find your Host in the list of all current problems. You can use Filter to find it:

  • Click on the Time to open problem details:

  • Details about the problem (Event details), its source, acknowledgements, actions taken (messages, remote commands) and previous similar problems are displayed:

Note: You can also look over the current problems in Monitoring -> Dashboard -> Last 20 issues: only last 20 problems are displayed here.

Columns' description

Column

Description

Column

Description

Time

Problem start time is displayed.

Severity

Problem severity is displayed.
Problem severity is based on the severity of the underlying problem trigger.

Recovery time

Problem resolution time is displayed

Status

Problem status is displayed:
Problem - unresolved problem
Resolved - recently resolved problem. You can hide recently resolved problems using the filter.
New and recently resolved problems blink for 30 minutes. Resolved problems are displayed for 30 minutes in total.

Info

An green information icon is displayed if a problem is closed by global correlation or manually by acknowledgement. Rolling a mouse over the icon will display more details:

Host

Problem host is displayed.

Problem

Problem name is displayed.
Problem name is based on the name of the underlying problem trigger.

Duration

Problem duration is displayed.

Ack

The acknowledgement status of the problem is displayed:
Yes - green text indicating that the problem is acknowledged. A problem is considered to be acknowledged if all events for it are acknowledged.
No - a red link indicating unacknowledged events.
If you click on the link you will be taken to a bulk acknowledgement screen where all problems for this trigger can be acknowledged at once.
This column is displayed if problem acknowledgement is activated in Administration ->  General.

Actions

Action status is displayed:
In progress - action is being taken
Done - action is completed
Failures - action has failed
The number of actions taken on the problem (such as notifications sent or executed remote commands) is also displayed.

Tags

Event tags are displayed (if any).