Master Zabbix: Complete Guide to Installation, Configuration, and Troubleshooting

What is Zabbix?

Zabbix is an enterprise‑grade, open‑source distributed monitoring solution that tracks the performance and availability of network devices, servers, services, and other IT resources. It uses a client‑server architecture to collect metrics, apply defined rules, and present actionable information via alerts, visualizations, and reports.

Key Features

Resource Discovery and Monitoring

Zabbix automatically discovers network entities and server resources through built‑in auto‑discovery. It can monitor virtually anything, from low‑level devices to cloud services, using ready‑made templates.

Agent‑based monitoring: detailed host‑level metrics via Zabbix agents.

Agent‑less monitoring: SNMP, IPMI, SSH, Telnet, and custom checks.

Web monitoring: performance and availability of web services.

Database monitoring: direct collection of database performance metrics.

Data Collection and Processing

Zabbix gathers metrics from devices, operating systems, virtualization platforms, container platforms (Docker, Kubernetes), cloud infrastructure, databases, web applications, and APIs. Collected data is processed and stored for:

Real‑time problem detection with correlation.

Trend analysis and forecasting.

SLA monitoring and reporting.

Custom calculations and transformations.

Installation on Debian/Ubuntu

Import the Zabbix repository, install the server, frontend, and agent packages, and optionally install MySQL.

# Import Zabbix repository package
wget https://repo.zabbix.com/zabbix/6.0/ubuntu/pool/main/z/zabbix-release/zabbix-release_6.0-1+ubuntu$(lsb_release -rs)_all.deb

dpkg -i zabbix-release_6.0-1+ubuntu$(lsb_release -rs)_all.deb
apt update

# Install Zabbix server, frontend, and agent
apt install zabbix-server-mysql zabbix-frontend-php zabbix-apache-conf zabbix-sql-scripts zabbix-agent

# Optional: install MySQL server
apt install mysql-server

Database Setup

After installing the packages (or compiling from source), create the Zabbix database and user, then import the initial schema.

# MySQL/MariaDB setup
mysql -uroot -p

# Create database and user
mysql> create database zabbix character set utf8mb4 collate utf8mb4_bin;
mysql> create user 'zabbix'@'localhost' identified by 'password';
mysql> grant all privileges on zabbix.* to 'zabbix'@'localhost';
mysql> flush privileges;
mysql> quit;

# Import initial schema and data
zcat /usr/share/doc/zabbix-sql-scripts/mysql/create.sql.gz | mysql -uzabbix -p zabbix

Configure Zabbix Server

Edit /etc/zabbix/zabbix_server.conf and set the database connection parameters.

# Database connection
DBName=zabbix
DBUser=zabbix
DBPassword=password
# Optional: DBHost=database_host
# Optional: DBPort=3306

Configure Zabbix Agent

Edit /etc/zabbix/zabbix_agentd.conf and specify the server address and a unique hostname.

# Server connection
Server=zabbix_server_ip
ServerActive=zabbix_server_ip

# Hostname must be unique in Zabbix
Hostname=name_of_this_host

Start Services

Enable and start the server and agent, then restart the web server.

# Start services
systemctl start zabbix-server zabbix-agent
systemctl enable zabbix-server zabbix-agent

# Restart web server
systemctl restart apache2   # Debian/Ubuntu
systemctl restart httpd     # RHEL/CentOS

Open a browser and navigate to http://your_server_ip/zabbix to access the Zabbix web interface.

Troubleshooting

If problems arise during installation, follow these steps:

Check logs:

tail -f /var/log/zabbix/zabbix_server.log
tail -f /var/log/zabbix/zabbix_agentd.log

Verify services are running:

systemctl status zabbix-server
systemctl status zabbix-agent

Test database connectivity:

# MySQL
mysql -uzabbix -p -e "SHOW DATABASES;"

# PostgreSQL
sudo -u zabbix psql -l

Check web server configuration:

# Apache
apachectl -t

# Nginx
nginx -t