This repository contains the necessary files for monitoring BIRD using Zabbix. It focuses on tracking the I/O time and events of the BIRD daemon and visualizing the data through Zabbix graphs.
Example of I/O related log output:
2024-05-14 12:26:07 <WARN> I/O loop cycle took 5720 ms for 47 events
Get the above 5720 ms and 47 events values and create a graph.
To enable logging, add the following lines to your BIRD configuration files (bird.conf and bird6.conf):
log [path to log file] all;
debug latency on;
debug latency limit 1s;
For example:
log "/var/log/bird/bird.log" all;
debug latency on;
debug latency limit 1s;
Place the bird.conf file from this repository into the following directory on your Zabbix server:
/etc/zabbix/zabbix_agent2.d/plugins.d
Zabbix agent must be restarted after installing the file:
systemctl restart zabbix-agent2
Import the template_app_bird_agent2.yaml file from this repository as a Zabbix template. This can be done via the Zabbix dashboard:
- Navigate to
Configuration > Templates. - Click the
Importbutton. - Select the
template_app_bird_agent2.yamlfile and import it.
Next, set up the following Zabbix macros for your environment:
$BIRD_IPV4_LOGFILE_PATH: Full path to the log file for the IPv4 daemon.$BIRD_IPV6_LOGFILE_PATH: Full path to the log file for the IPv6 daemon.$BIRD_BGP_SESSION_THRESHOLD_MS: Threshold value for alarms.
Finally, apply the template to the host where BIRD is running:
- Navigate to
Configuration > Hostsin the Zabbix dashboard. - Select the host where BIRD is running.
- Go to the
Templatestab. - Click
Addand select theTemplate App BIRD by Zabbix agent2 active. - Click
Updateto apply the template to the host.
Here are graphs of the results of monitoring the logs for two days:
This program has been tested and verified in the following environment:
- BIRD: 2.0.8
- Zabbix server: 6.0.29
- Zabbix agent 2: 6.0.27
- Red Hat Enterprise Linux Server: 7.9 (Maipo)