Zabbix is a tool for monitoring IT infrastructure, such as networks, servers, general network equipment like client ONUs, among others, collecting and displaying basic metrics.
Integration Overview
The integration uses the Zabbix API to update client statuses and power levels. The code to establish links between clients in both systems may vary. By default, synchronizations are performed every 15 minutes.
Features
Status Updates - To update statuses, the integration reads the status item defined in the configuration, maintained by Zabbix. Changes are made in OZmap based on the following criteria:
- If the status in Zabbix is 1, the status in OZmap will be OK.
- If the status in Zabbix is any value other than 1, it is considered that the client has an issue, and the OZmap status will be Error.
Power Updates - Power updates will populate the "Read Power" field in OZmap. The integration reads the configured item and updates the field in OZmap if the value differs from the existing one.
This integration allows users to choose which functionalities to enable. For instance, users can opt to update only one field (e.g., status) without affecting the other.
Client Linking
The client status management in OZmap is handled using the "key_" field of the Zabbix ONU in the OZmap client code.
For power management in OZmap, the client code can extract information from any field in the Zabbix ONU.
Required Data
To begin the integration, you’ll need the following Zabbix information:
- URL;
- Login;
- Password.
Additionally, API call access must be enabled for Zabbix for the following IPs:
- 54.207.162.199
- The IP of the machine where OZmap is installed.
Finally, you’ll need to configure a new user in OZmap. If you’re unsure about this process, click here. This user must:
- Have the "Administrator" user type.
- Have permission to access projects.
- Have permission to access the API module.
- Generate an API key for this user as per the linked tutorial.