July 17, 2025

Zabbix Agent Wizard in Nagios XI: Configuration & Troubleshooting

Ayub Huruse

IT Specialist

Nagios XI is a powerful monitoring solution, and integrating it with Zabbix agent technology offers comprehensive tracking of CPU, memory, disk, network, and process metrics. The Zabbix Agent Wizard simplifies this process—no manual command definitions or template edits are required.

Benefits of Using the Wizard

Rapid Deployment: Automated setup saves configuration time.
Customizable Metrics: Monitor only what matters.
Flexible Alerting: Set warning and critical thresholds per metric.
Intuitive Interface: Fully integrated into Nagios XI’s Monitoring Wizard.
Metrics Monitored: CPU usage & load, memory availability, disk usage, system uptime, network traffic, running processes, and hostname information.

Prerequisites

Before proceeding, ensure:

Nagios XI 2024R2.0+ installed (the Zabbix Agent Wizard is included by default).
Zabbix agent running on the target host (port 10050/tcp open).
Administrator credentials for XI and the host.

Security Note: Always use trusted sources for downloads. Ensure secure communication (e.g., TLS encryption) is configured for the agent.

Step 1: Launch the Wizard

In the XI web UI, go to Configure > Configuration Wizards.
Select Zabbix Agent Wizard, then click Next.
Enter the host’s IP address or FQDN when prompted.

Step 2: Configure Host Monitoring

Enter Host Name: Provide a unique display name for the host.
Select Metrics: Tick the metrics you want to monitor (CPU, memory, disk, network, uptime, processes).
Define Thresholds: Set warning and critical values for each metric.

Zabbix metrics — All the available Metrics.

Make selections for your other monitoring settings in Steps 3-5, defining key aspects such as the check interval, notification settings, host and service groups, and parent-child relationships.
Click Finish and Apply to apply your settings and finish the wizard.

The wizard automatically creates and applies the necessary configurations.

Step 3: Verify Monitoring and View Results

3.1 Manual Testing (Optional)

You can run the following command from the command line of your Nagios XI server to verify things are working:

/usr/local/nagios/libexec/check_zabbix_agent.py \ -H 192.168.1.50 --check cpu -w 80 -c 90

/usr/local/nagios/libexec/check_zabbix_agent.py \ -H 192.168.1.50 --check cpu -w 80 -c 90

Example output:

OK: CPU usage 22.3% | cpu_usage=22.3;80;90
CRITICAL: Available memory 72MB | available_memory=72MB;200;100

OK: CPU usage 22.3% | cpu_usage=22.3;80;90
CRITICAL: Available memory 72MB | available_memory=72MB;200;100

3.2 Service Status

Go to Home > Details > Service Status, then search for and locate your new host to view the status of it’s services.

Zabbix Status Details — Zabbix Host status details services.

Performance Graphs

Zabbix performance graph — 24‑hour process count graph.

Troubleshooting Common Issues

Issue	Cause/Check	Solution
Wizard not listed	The Wizard requires Nagios XI 2024R2.0 or later; older versions won’t display it.	Upgrade to XI 2024R2.0+ to access the wizard.
No data received	Port 10050 closed or agent not running.	Open port 10050 (`telnet host 10050`); restart/check `zabbix-agent` service.

Conclusion

By following these three steps, you’ll have Zabbix-agent metrics in Nagios XI in under 10 minutes, eliminating manual setup and boosting monitoring efficiency.