How to Install and Configure Zabbix Agent on OpenSUSE Leap 15.3

The Zabbix agent runs on hosts you want to monitor and collects metrics (CPU, memory, disk, network, etc.) for the Zabbix server. The agent must be installed on every host you add to Zabbix. It supports two check types: passive (the server asks the agent for data) and active (the agent pushes data to the server on a schedule).

This guide shows how to install and configure the Zabbix agent on OpenSUSE Leap 15.3 using the official Zabbix repository (Zabbix 5.4). For Zabbix 6, see the related article below.

Prerequisites

OpenSUSE Leap 15.3 server with root or sudo access
IP address of your Zabbix server or proxy (for Server and ServerActive)
Hostname you will use when adding the host in Zabbix (must match the agent’s Hostname)

1. Update System Packages

Refresh repositories and update the system:

1
2
sudo zypper refresh
sudo zypper update -y

Optionally install useful tools:

1
sudo zypper install -y vim

2. Install the Zabbix Agent

The Zabbix agent is not in the default OpenSUSE repositories. Add the official Zabbix repository for SLES 15 / Leap 15 (this guide uses Zabbix 5.4):

1
2
sudo rpm -Uvh --nosignature https://repo.zabbix.com/zabbix/5.4/sles/15/x86_64/zabbix-release-5.4-1.sles15.noarch.rpm
sudo zypper --gpg-auto-import-keys refresh 'Zabbix Official Repository'

Install the agent:

1
sudo zypper install -y zabbix-agent

Verify the installed version:

1
2
3
4
5
6
$ rpm -qi zabbix-agent
Name        : zabbix-agent
Version     : 5.4.9
Release     : 1.sles15
Architecture: x86_64
Summary     : Zabbix Agent

3. Configure the Zabbix Agent

Edit the agent configuration and set the Zabbix server address and this host’s name:

1
sudo vim /etc/zabbix/zabbix_agentd.conf

Set these parameters (use your Zabbix server or proxy IP and a hostname that matches what you will use in Zabbix):

1
2
3
Server=10.70.5.218
ServerActive=10.70.5.218
Hostname=dev-susesrv

Server: Comma-separated list of server/proxy IPs allowed to request data (passive checks).
ServerActive: Comma-separated list of server/proxy IPs for active checks (agent pushes data).
Hostname: Must match the host name you configure in the Zabbix frontend when adding this host.

Save and exit.

4. Adjust Firewall for Zabbix

The agent listens on port 10050/tcp. If firewalld is enabled, open it:

1
2
sudo firewall-cmd --permanent --add-port=10050/tcp
sudo firewall-cmd --reload

(Only the Zabbix server needs port 10051; agents use 10050.)

5. Start and Enable the Zabbix Agent

Start the agent and enable it at boot:

1
2
sudo systemctl start zabbix-agent
sudo systemctl enable zabbix-agent

Check that it is running:

1
sudo systemctl status zabbix-agent

You should see Active: active (running).

Next Steps

Add this host in the Zabbix frontend using the same Hostname as in the config (e.g. dev-susesrv), and link it to the Zabbix server’s interface. See How to Add Host in Zabbix Server to Monitor for the exact steps. After the host is added and the server can reach the agent, items will start collecting data.