Table of Contents
10 Monitor a network switch or router with Zabbix
Introduction
This guide walks you through the steps required to start basic monitoring of your network switch or router using Zabbix. A Cisco router is used as an example, but the procedure applies to any SNMP-enabled network device.
Who this guide is for
This guide is designed for new Zabbix users and network administrators who want to quickly enable basic monitoring for network devices. If you require deep customization or advanced configuration options, please refer to the SNMP agent page or the Configuration section of Zabbix manual.
Prerequisites
Before proceeding with this guide, ensure that you have:
- Zabbix server and Zabbix frontend installed: install according to the instructions for your operating system (see Installation from packages and Web interface installation).
- SNMP-enabled device: a network switch or router (for example, a Cisco router) with SNMP enabled.
- MIB files must be installed to enable proper SNMP monitoring.
This guide is based on the following setup:
- Zabbix version: 7.0 (installed from packages)
- OS distribution: Ubuntu
- OS version: 22.04 (Jammy)
- Zabbix components: server, frontend, and optionally agent (if monitoring local network metrics)
- Database: MySQL
- Web server: Apache
- Network device: Cisco Catalyst 3750V2-24FS
It is assumed that your network device is already physically installed and connected.
Configure the network device (Cisco router example)
For monitoring via SNMP, you must configure your network device to allow SNMP queries. For a Cisco router, this typically involves the following steps:
1. Enable SNMP and set community string.
Log in to your Cisco router’s console and enter configuration mode:
Then, enable SNMP by specifying a read-only community string. For example:
Replace <your_community_string> with your secure community string. Note: the RO (Read-Only) option allows SNMP to retrieve data from the device but prevents any configuration changes.
It is recommended to restrict SNMP access to only the necessary devices for security reasons. For further guidance on configuring access control lists (ACLs), refer to Cisco's official documentation.
3. Save the configuration.
Save your changes to ensure SNMP settings persist after a reboot:
For further details or model-specific instructions, you may refer to external Cisco SNMP configuration tutorials. This guide, however, provides the basic steps for enabling SNMP monitoring.
Configure Zabbix frontend
Create a host in Zabbix frontend
1. Log into Zabbix frontend.
2. Add a new host.
Navigate to Data collection > Hosts and click on Create host.
- Host name: enter a name for your device (e.g., "Cisco Router").
- Host groups: select an existing group or create a new group such as "Network Devices".
- Interfaces:
- Click Add under Interfaces.
- Choose SNMP as the interface type.
- Enter the IP address or DNS name of your Cisco router.
- Set the default SNMP port (usually 161).
- Use the drop-down menu to select the appropriate SNMP version (e.g. SNMPv2).
- For SNMPv1/v2, enter the community string in the SNMP community field. For SNMPv3, additional credentials (Context name, Security name, and Security level) will be prompted.
3. Link Templates
In the Templates field, select the SNMP template that best matches your device. Zabbix provides a range of pre-built SNMP templates for many device families. For example, if you are monitoring a Cisco device, choose the template that corresponds to your device’s OS or model (such as Cisco IOS SNMP or Cisco Catalyst 3750<device model> SNMP).
4. Click on Add to save the host.
View collected metrics
Congratulations! Zabbix is now set up to monitor your network device.
Latest Data:
- Navigate to Monitoring > Latest data in the Zabbix frontend.
- Select your “Cisco Router” host (or discovered hosts) to view metrics such as hardware and network uptime, ICMP loss, ping, and response time, etc.
- Graphs and screens:
To visualize the performance data, click on Graphs next to the SNMP items to see detailed metrics.
As a next step, you can:
- Add custom SNMP items to monitor additional metrics.
- Set up problem alerts to receive notifications about potential issues.
Create SNMP items
Once the host is set up, you can create items to monitor specific metrics. Note: this step is optional if you're using a template, as templates already contain default sets of items.
1. Identify the SNMP OID:
Use the snmpwalk command to list available OIDs on your device. For example:
Find the OID for the metric you wish to monitor (for instance, IF-MIB::ifHCInOctets.3 for incoming traffic on port 3). To get the numeric OID, you can use:
2. Create an SNMP item:
- Navigate to Data collection > Hosts and click on the Items tab for your SNMP host and click Create item.
- Name: enter a descriptive name (e.g., “Port 3 Incoming Traffic”).
- Type: select SNMP agent.
- Key: provide a meaningful key (e.g.,
cisco.ifHCInOctets.3). - Host interface: ensure the SNMP interface is selected.
- SNMP OID: enter the OID using one of the supported formats, for example:
get[1.3.6.1.2.1.31.1.1.1.6.3]for a single value;walk[1.3.6.1.2.1.31.1.1.1.6.3]to retrieve a subtree of values asynchronously.
- Preprocessing (if needed): if the item returns a cumulative counter (such as interface traffic), navigate to the Preprocessing tab, and add a preprocessing step like “Change per second” to calculate the rate.
To retrieve multiple values in one SNMP transaction, you can specify several OIDs using the syntax walk[OID1,OID2,...].
Set up problem alerts
This guide provides basic configuration steps for sending email alerts.
1. Navigate to User settings > Profile, switch to the Media tab and add your email.
2. Follow the guide for Receiving a problem notification.
Next time, when Zabbix detects a problem, you should receive an alert via email.
Test your configuration
To ensure that Zabbix correctly detects network performance issues, simulate a real problem by increasing the ICMP ping response time threshold.
1. Open your "Cisco Router" host configuration in Zabbix.
2. Navigate to the Macros tab and select Inherited and host macros.
3. Locate the {$ICMP_RESPONSE_TIME_WARN} macro (or a similar response time threshold macro).
4. Set a very low value (e.g., 0.001) to trigger an alert when the ping response exceeds this value.
5. Click Update to apply the changes.
6. Wait a few moments for Zabbix to detect the simulated issue.
7. Navigate to Monitoring > Problems to verify that an alert appears (e.g., "High ICMP ping response time").
If alerts are configured, you should also receive a problem alert.
8. Revert the macro value to its original setting and click Update to save the changes.
9. Confirm that the problem is resolved and disappears from the Problems section.
See also:
- Creating an item - learn how to add additional metrics.
- SNMP agent - additional information on SNMP monitoring with Zabbix.
- Standardized templates for network devices - information on available SNMP templates.
- Discovery of SNMP OIDs - additional information on SNMP discovery on a switch.
- Configuring a network discovery rule - additional information on how to configure a network discovery rule used by Zabbix to discover hosts and services.