Posted inMonitoring

Zabbix Installation Guide from A-Z: Build Your Own Professional Monitoring System

Monitoring tutorial - IT technology blog
Monitoring tutorial - IT technology blog

I. Introduction to Zabbix and Why You Need It

In today’s IT landscape, ensuring the stable operation of systems, applications, and network infrastructure is crucial. To achieve this, a powerful and flexible monitoring tool is indispensable. That’s where Zabbix plays its role and becomes a reliable choice for the IT community.

What is Zabbix? Simply put, it’s a comprehensive, open-source monitoring solution. It helps you monitor everything: from server performance, network device status, web applications, and databases to cloud services.

Zabbix is particularly useful because it doesn’t just simply collect data (metric collection) like many other tools. Zabbix is designed to automatically detect ‘problems’ based on predefined thresholds, then send alerts via multiple channels such as email, Telegram, Slack, or SMS. This tool uses an agent-based model: a compact agent is installed on the servers to be monitored, collecting detailed data and pushing it to the Zabbix Server.

This differs from Prometheus and Grafana – a tool focused on metrics using a pull-based model, often requiring a combination of Grafana for visualization and Alertmanager for alerting. Zabbix, on the other hand, offers a comprehensive solution, integrating full features from data collection, analysis, alerting, to visualization within a single platform.

II. Quick Start: Zabbix in 5 Minutes with Docker Compose

Want a quick overview of Zabbix without spending a lot of time on installation? I’ll guide you through starting a Zabbix Server in just a few minutes using Docker Compose. This is an ideal way to experiment or use it for small development/testing environments.

Requirements:

  • You have Docker and Docker Compose installed on your system.

Steps to perform:

1. Create a new directory for Zabbix and navigate into it:


mkdir zabbix-quickstart
cd zabbix-quickstart

2. Create the file docker-compose.yaml with the following content. This file will define the necessary services: Zabbix Server, Frontend (Nginx + PHP-FPM), and Database (PostgreSQL).


version: '3.8'

services:
  zabbix-server:
    image: zabbix/zabbix-server-pgsql:latest
    ports:
      - "10051:10051"
    environment:
      - POSTGRES_USER=zabbix
      - POSTGRES_PASSWORD=zabbix
      - POSTGRES_DB=zabbix
      - DB_SERVER_HOST=zabbix-db
    depends_on:
      - zabbix-db
    networks:
      - zabbix_net

  zabbix-web:
    image: zabbix/zabbix-web-nginx-pgsql:latest
    ports:
      - "80:8080"
    environment:
      - ZBX_SERVER_HOST=zabbix-server
      - DB_SERVER_HOST=zabbix-db
      - POSTGRES_USER=zabbix
      - POSTGRES_PASSWORD=zabbix
      - POSTGRES_DB=zabbix
    depends_on:
      - zabbix-server
    networks:
      - zabbix_net

  zabbix-db:
    image: postgres:13
    environment:
      - POSTGRES_USER=zabbix
      - POSTGRES_PASSWORD=zabbix
      - POSTGRES_DB=zabbix
    volumes:
      - zabbix_db_data:/var/lib/postgresql/data
    networks:
      - zabbix_net

networks:
  zabbix_net:

volumes:
  zabbix_db_data:

3. Start the services:


docker-compose up -d

Zabbix Server, Frontend, and Database will start. This process may take a few minutes, depending on network speed to download the Docker images.

4. Access Zabbix Web UI:

Open your browser and access http://localhost (or the Docker host’s IP if running on a server).
Default login credentials:
Username: Admin
Password: zabbix

And just like that, you have a working Zabbix system! Next, we’ll delve deeper into how to install it on a physical server/VM for a production environment.

III. Detailed Explanation: Installing Zabbix Server on Ubuntu 22.04 LTS

Installing Zabbix directly on a physical server or VM is often preferred for production environments. This method provides better control and higher performance compared to Docker in some cases. I will guide you through installing Zabbix Server 6.x LTS on Ubuntu Server 22.04 LTS, using PostgreSQL as the database and Nginx as the web server.

Basic Zabbix Architecture:

  • Zabbix Server: The heart of the system. It processes data, performs monitoring, triggers alerts, and sends notifications.
  • Zabbix Agent: Installed on the servers to be monitored. The agent collects data and sends it to the Server.
  • Zabbix Web Interface: A web interface for configuring, managing, and visualizing monitoring data.
  • Database: Where all configuration data and collected historical data are stored (e.g., PostgreSQL or MySQL).
  • Web Server: Provides the web interface to users (e.g., Nginx or Apache).
  • PHP-FPM: Processes the necessary PHP scripts for the Web Interface.

System Requirements:

  • An Ubuntu Server 22.04 LTS (minimum 2GB RAM and 2 CPU Cores for small environments).
  • sudo privileges.

Detailed Installation Steps:

1. Update the System

Always start by updating software packages. This ensures you have the latest bug fixes and features:


sudo apt update
sudo apt upgrade -y

2. Install PostgreSQL Database

Zabbix supports various database types. I recommend using PostgreSQL for production environments due to its superior performance and stability. Here’s how to install and configure PostgreSQL:


sudo apt install -y postgresql postgresql-contrib

Create a dedicated user and database for Zabbix. I will name the user and database zabbix:


sudo -u postgres createuser --pwprompt zabbix

When prompted, enter the password for the zabbix user. Example: your_zabbix_db_password.


sudo -u postgres createdb -O zabbix zabbix

3. Install Zabbix Server, Agent, and Frontend

Zabbix provides official packages that make installation much easier:

Install Zabbix repository:


wget https://repo.zabbix.com/zabbix/6.0/ubuntu/pool/main/z/zabbix-release/zabbix-release_6.0-1+ubuntu22.04_all.deb
sudo dpkg -i zabbix-release_6.0-1+ubuntu22.04_all.deb
sudo apt update

Install Zabbix Server, Frontend, Agent, and supporting components:


sudo apt install -y zabbix-server-pgsql zabbix-frontend-php zabbix-nginx-conf zabbix-agent

4. Configure Database for Zabbix Server

After installing the packages, we need to import the schema and initial data into the Zabbix database:


sudo zcat /usr/share/doc/zabbix-server-pgsql*/create.sql.gz | sudo -u zabbix psql zabbix

Next, edit the Zabbix Server configuration file so it knows how to connect to the database:


sudo nano /etc/zabbix/zabbix_server.conf

Find and modify the following lines (uncomment # if necessary):


DBHost=localhost
DBName=zabbix
DBUser=zabbix
DBPassword=your_zabbix_db_password # Replace with the password you set

Save and close the file (Ctrl+X, Y, Enter).

5. Configure Web Server (Nginx) and PHP-FPM

The Zabbix Frontend requires Nginx and PHP-FPM to function. The Nginx configuration file for Zabbix is usually created automatically during installation:


sudo nano /etc/nginx/conf.d/zabbix.conf

Ensure that it listens on port 80 and points correctly to the Zabbix frontend directory. Additionally, configure PHP-FPM:


server {
    listen 80;
    server_name your_domain_or_ip;

    root /usr/share/zabbix;
    index index.php index.html index.htm;

    location / {
        try_files $uri $uri/ =404;
    }

    location ~ \.php$ {
        fastcgi_pass unix:/var/run/php/php8.1-fpm.sock;
        fastcgi_index index.php;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
        fastcgi_read_timeout 300s;
    }

    location ~ /\\.ht {
        deny all;
    }
}

Check the Nginx configuration file syntax:


sudo nginx -t

Next, we need to configure PHP parameters for the Zabbix Frontend. Open the php.ini file:


sudo nano /etc/php/8.1/fpm/php.ini

Find and modify the following values:


post_max_size = 16M
upload_max_filesize = 16M
max_execution_time = 300
max_input_time = 300
date.timezone = Asia/Ho_Chi_Minh # Replace with your timezone

Save and close the file.

6. Start and Check Services

Now, we will start and enable the services so they automatically run when the system boots:


sudo systemctl restart zabbix-server zabbix-agent nginx php8.1-fpm
sudo systemctl enable zabbix-server zabbix-agent nginx php8.1-fpm

Check the status of the services:


sudo systemctl status zabbix-server
sudo systemctl status zabbix-agent
sudo systemctl status nginx
sudo systemctl status php8.1-fpm

Ensure all are in the active (running) state.

7. Access Web UI and Initial Configuration

Open your browser and access http://your_server_ip/zabbix.

You will see the welcome screen of the Zabbix Frontend Installation Wizard. Follow these steps:

  1. Welcome: Click Next step.
  2. Check of pre-requisites: Ensure all items are OK. If any item Fails, recheck your PHP configuration or install any missing PHP extensions. Click Next step.
  3. Configure DB connection: Enter the database information you created: Host (localhost), Port (5432), Database (zabbix), User (zabbix), Password (your_zabbix_db_password).

    Click Next step.

  4. Zabbix server details: Keep the default values or customize them. Click Next step.
  5. Pre-installation summary: Review the settings. Click Next step.
  6. Install: The installation process is complete. Click Finish.

Now you can log in to the Zabbix Web Interface with the default credentials:
Username: Admin
Password: zabbix

Note: Change the default password immediately after successful login to ensure system security!

IV. Advanced: Monitoring Your First Host and Basic Templates

After installing Zabbix Server, the first thing you’ll want to do is monitor a device. I’ll guide you through adding the Zabbix Server itself to the monitoring list.

1. Add Zabbix Server Host:

  • Host name: Zabbix Server (or any desired name).
  • Visible name: (Optional, will be displayed on the UI).
  • Groups: Click Select and choose Zabbix servers.
  • Interfaces: Click Add to add a Zabbix agent interface.
    • Type: Agent
    • IP address: 127.0.0.1 (because the agent runs on the same server).
    • Port: 10050 (default port for Zabbix agent).

Switch to the Templates tab:

  • Click Add and search for Linux by Zabbix agent. Select this template and click Select.

Click Add to finish. In just a few minutes, Zabbix Server will start collecting data from itself!

2. Introduction to Templates:

Templates are an extremely important concept in Zabbix. They are collections of pre-defined Items (data to collect), Triggers (alert conditions), Graphs (charts), and Applications (item groups). Templates help you apply standard monitoring configurations to hundreds, or even thousands, of similar devices quickly and consistently. Zabbix provides many ready-to-use templates for common operating systems, network devices, and databases.

V. Practical Experience and Important Tips

After 6 months of working with Zabbix in a production environment, I’ve compiled some experience and tips. These will help your system operate more efficiently and save you headaches:

1. Dealing with “Alert Fatigue”

This is a problem I actually encountered when first setting up monitoring – having to fine-tune thresholds many times. I remember when I first installed Zabbix, I received dozens of unnecessary alerts every day. I thought there was a problem with the system, but it turned out the thresholds weren’t optimized. It took me almost 6 months to ‘tune’ the alert thresholds and set up alert dependencies. Thanks to that, “alert fatigue” was significantly reduced. Some advice:

  • Start with broad thresholds, then narrow them down: Don’t set overly strict thresholds from the start (e.g., CPU > 70%). Begin with a safer threshold (e.g., CPU > 90%). Once you better understand system behavior, you can gradually adjust to detect issues earlier, avoiding too many “false positive” alerts.
  • Use Trigger Dependencies: This is a “lifesaver” feature when you have many related alerts. For example, if both the server and its services are down, you only want to receive a “server down” alert, not both “server down” and “service A down,” “service B down.” Set up dependencies so Zabbix only alerts for the root trigger.
  • Configure Smart Actions: Not every alert needs immediate notification. Zabbix Actions allow you to set up “escalation” – increasing the severity of the alert. For example: after 5 minutes, if the issue is not resolved, the system will send an SMS to the On-call team.
  • Classify Severity Levels: Assign appropriate Severity levels to each trigger. A “Disaster” alert should be prioritized over a “Warning.”

2. Optimize Database Performance

Zabbix can generate a huge amount of data, especially for history and trends tables. If not managed well, the database can easily become a bottleneck:

  • Housekeeping: Configure Housekeeping in Zabbix Server to automatically clean up old data. You can find this feature under Administration > General > Housekeeping.
  • Database Partitioning: For large systems, partitioning the history and trends tables is very important. It helps improve query performance and clean up old data. Refer to the Zabbix documentation on how to implement partitioning for PostgreSQL.
  • Optimize PostgreSQL: Periodically perform VACUUM FULL and analyze (ANALYZE) the database to maintain performance. Check the postgresql.conf file to adjust parameters such as shared_buffers, work_mem, wal_buffers to match server resources. For example, increasing shared_buffers can help cache more data in RAM, reducing I/O load.

3. Secure Zabbix Agent

The Agent is the data collection endpoint, so securing it is extremely necessary:

  • Use Encryption (PSK/Certificates): Configure Zabbix Agent and Server to use PSK (Pre-Shared Key) or Certificate encryption. This ensures data is transmitted securely over the network.
  • Firewall: Only allow Zabbix Server to connect to port 10050 of the Zabbix Agent (or the port you configured).
  • User and Permissions: Ensure the Zabbix Agent runs under a user with the minimum necessary permissions to collect data.

4. Effective Dashboarding

Dashboards are how you visualize data. Create simple dashboards focusing on the most important metrics. This helps to easily grasp the situation instead of displaying too much information that can be distracting.

5. Update Zabbix Regularly

Always keep an eye on Zabbix updates, bug fixes, and new features. Updating not only brings performance and security improvements but also adds many new monitoring capabilities.

VI. Conclusion

Zabbix is an incredibly powerful and flexible monitoring tool. Installing Zabbix from scratch may seem complex, but with the detailed guide and practical experience I’ve shared, I believe you can confidently build and master your own monitoring system. Start monitoring to better understand your system and keep everything effectively under control!

Share: