Juli 17, 2026
walid-28
Panduan lengkap konfigurasi Zabbix Agent di Linux server, mulai dari instalasi, setting item monitoring kustom, hingga verifikasi di dashboard Zabbix.

Bayangkan Anda mengelola belasan bahkan puluhan server Linux, mulai dari web server, database server, hingga mail server. Tanpa sistem monitoring yang terpusat, Anda baru akan tahu ada masalah setelah pengguna mengeluh layanan down. Di sinilah Zabbix hadir sebagai solusi open source monitoring infrastruktur IT yang paling banyak dipercaya oleh tim sysadmin dan DevOps di seluruh dunia.

Agar Zabbix Server bisa “melihat” kondisi sebuah server Linux, dibutuhkan komponen kecil bernama Zabbix Agent yang terpasang di server target. Agent inilah yang mengumpulkan data CPU, memori, disk, proses, hingga metrik kustom sesuai kebutuhan, lalu mengirimkannya ke Zabbix Server untuk ditampilkan di dashboard secara real-time.

Artikel ini akan membahas tuntas cara memasang dan mengonfigurasi Zabbix Agent di Linux server, termasuk cara membuat item monitoring kustom (custom item) sesuai kebutuhan spesifik infrastruktur Anda โ€” lengkap dengan langkah praktis yang bisa langsung Anda terapkan hari ini.

Pembahasan Utama

Apa itu Zabbix Agent?

Zabbix Agent adalah aplikasi ringan yang berjalan di server yang ingin dipantau (host). Tugasnya sederhana: mengumpulkan data lokal (misalnya penggunaan CPU, RAM, disk I/O, status service) lalu melaporkannya ke Zabbix Server, baik secara pasif (server yang menarik data) maupun aktif (agent yang mengirim data sendiri).

Saat ini Zabbix merekomendasikan penggunaan Zabbix Agent 2, yaitu versi baru berbasis bahasa Go yang menggantikan agent klasik (C-based). Zabbix Agent 2 menawarkan:

  • Performa lebih ringan dan konkurensi lebih baik
  • Dukungan loadable plugin untuk monitoring aplikasi spesifik (MySQL, PostgreSQL, Docker, dll)
  • Konfigurasi lebih sederhana dibanding agent versi lama

Analoginya, jika Zabbix Server adalah “kantor pusat” yang mengumpulkan laporan, maka Zabbix Agent adalah “kurir” di setiap cabang yang rutin mengirim laporan kondisi terkini.

Mode Kerja Agent: Passive vs Active

Sebelum masuk ke instalasi, penting memahami dua mode kerja agent:

  • Passive check โ€” Zabbix Server yang meminta data ke Agent kapan pun dibutuhkan. Agent hanya menjawab saat “ditanya”.
  • Active check โ€” Agent yang secara proaktif mengambil daftar item yang harus dipantau, lalu mengirim data sendiri ke server sesuai interval tertentu.

Pada praktiknya, banyak implementasi memakai kombinasi keduanya agar monitoring lebih responsif dan mengurangi beban di sisi server.

Materi Praktis: Instalasi dan Konfigurasi Zabbix Agent 2

Studi kasus berikut menggunakan skenario umum: satu Zabbix Server dengan IP 192.168.1.10 yang akan memantau sebuah server Linux (Ubuntu/Debian atau RHEL/CentOS) sebagai host baru.

Langkah 1 โ€” Menambahkan Repository Zabbix

Untuk distro berbasis Debian/Ubuntu:

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

Untuk distro berbasis RHEL/CentOS:

sudo rpm -Uvh https://repo.zabbix.com/zabbix/7.0/rhel/9/x86_64/zabbix-release-7.0-1.el9.noarch.rpm
sudo dnf clean all

Sesuaikan versi distro (ubuntu22.04, el9, dll) dengan sistem operasi Anda melalui halaman resmi zabbix.com/download.

Langkah 2 โ€” Instalasi Zabbix Agent 2

sudo apt install zabbix-agent2 zabbix-agent2-plugin-mysql -y   # Debian/Ubuntu
# atau
sudo dnf install zabbix-agent2 -y                              # RHEL/CentOS

Plugin tambahan (seperti plugin MySQL) bersifat opsional, dipasang hanya jika server perlu memantau service spesifik.

Langkah 3 โ€” Konfigurasi File Agent

Edit file konfigurasi utama di /etc/zabbix/zabbix_agent2.conf:

sudo nano /etc/zabbix/zabbix_agent2.conf

Ubah parameter berikut sesuai kebutuhan:

Server=192.168.1.10
ServerActive=192.168.1.10
Hostname=web-server-01
ListenPort=10050
LogFile=/var/log/zabbix/zabbix_agent2.log
LogFileSize=10
Timeout=10

Penjelasan tiap parameter:

  • Server โ€” alamat IP Zabbix Server yang diizinkan melakukan passive check ke agent ini.
  • ServerActive โ€” alamat IP Zabbix Server tujuan pengiriman data pada mode active check.
  • Hostname โ€” nama host ini, wajib sama persis dengan nama host yang didaftarkan di frontend Zabbix Server. Jika berbeda, server akan menolak data yang dikirim agent.
  • ListenPort โ€” port komunikasi agent, default 10050.

Langkah 4 โ€” Menjalankan dan Mengaktifkan Service

sudo systemctl restart zabbix-agent2
sudo systemctl enable zabbix-agent2
sudo systemctl status zabbix-agent2

Pastikan status menunjukkan active (running). Jika gagal, periksa log di /var/log/zabbix/zabbix_agent2.log untuk detail error.

Langkah 5 โ€” Membuka Akses Firewall

# UFW (Ubuntu/Debian)
sudo ufw allow from 192.168.1.10 to any port 10050 proto tcp

# firewalld (RHEL/CentOS)
sudo firewall-cmd --permanent --add-rich-rule='rule family="ipv4" source address="192.168.1.10/32" port port="10050" protocol="tcp" accept'
sudo firewall-cmd --reload

Langkah 6 โ€” Mendaftarkan Host di Zabbix Server

  1. Login ke Zabbix frontend, buka Data collection โ†’ Hosts โ†’ Create host
  2. Isi Host name persis sama dengan parameter Hostname di file konfigurasi agent
  3. Tambahkan Agent interface dengan IP server target dan port 10050
  4. Pasang template Linux by Zabbix agent (atau Linux by Zabbix agent active jika memakai active check)
  5. Simpan, lalu cek menu Monitoring โ†’ Latest data untuk memastikan data mulai masuk

Konfigurasi Item Monitoring Kustom (Custom Item)

Selain metrik bawaan, Zabbix Agent memungkinkan Anda memantau hal-hal spesifik lewat UserParameter. Misalnya memantau jumlah koneksi aktif pada port tertentu:

UserParameter=custom.conn.count,netstat -an | grep :80 | grep ESTABLISHED | wc -l

Atau memantau ukuran folder backup:

UserParameter=custom.backup.size,du -sh /backup | awk '{print $1}'

Setelah menambahkan baris di atas ke /etc/zabbix/zabbix_agent2.conf, restart service agent, lalu buat Item baru di frontend dengan tipe Zabbix agent dan key sesuai nama parameter (custom.conn.count).

Kesalahan yang Sering Terjadi

KesalahanPenyebabDampakCara Mengatasi
Host status “not available”Hostname di agent tidak sama dengan di frontendData tidak masukSamakan nilai Hostname di kedua sisi
Koneksi timeoutPort 10050 diblokir firewallAgent tidak bisa dihubungi serverBuka akses port sesuai IP Zabbix Server
Data active check tidak munculServerActive belum diisi atau salah IPItem aktif tidak terkirimPeriksa dan perbaiki parameter ServerActive
Custom item error “unsupported”Skrip UserParameter tidak executable atau syntax salahItem gagal dibacaUji skrip manual di terminal sebelum dimasukkan ke config

Tips dan Rekomendasi

  • Gunakan enkripsi PSK (Pre-Shared Key) untuk komunikasi agent-server pada lingkungan produksi agar data monitoring tidak mudah disadap.
  • Batasi AllowKey/DenyKey agar remote command via system.run tidak menjadi celah keamanan.
  • Gunakan template resmi Zabbix (Linux by Zabbix agent) sebagai dasar sebelum menambahkan item kustom, agar monitoring baseline (CPU, RAM, disk) langsung berjalan.
  • Terapkan penamaan Hostname yang konsisten (misalnya namaserver-lokasi-fungsi) agar mudah dikenali di dashboard saat jumlah server bertambah banyak.
  • Manfaatkan fitur auto-registration jika Anda mengelola banyak server sekaligus, sehingga host baru bisa otomatis terdaftar tanpa input manual di frontend.

Kesimpulan

Konfigurasi Zabbix Agent di Linux server sebenarnya tidak rumit jika dilakukan bertahap: instal paket, sesuaikan file konfigurasi, buka akses firewall, lalu daftarkan host di Zabbix Server. Poin paling krusial yang wajib diingat adalah kesamaan nilai Hostname antara file konfigurasi agent dan pendaftaran host di frontend โ€” ini penyebab paling umum kenapa monitoring gagal berjalan.

Dengan monitoring terpusat yang berjalan baik, tim IT bisa mendeteksi masalah server secara proaktif sebelum berdampak ke pengguna akhir, sekaligus mendapatkan data historis performa untuk perencanaan kapasitas ke depan.

Sudah coba pasang Zabbix Agent di server Anda? Tulis pengalaman atau kendala yang Anda temui di kolom komentar โ€”

mari berdiskusi bersama! Jangan lupa bagikan artikel ini ke rekan tim IT/DevOps Anda yang mungkin sedang membangun sistem monitoring, dan jelajahi juga artikel terkait lainnya seputar MikroTik, Cisco, dan infrastruktur server di blog ini.


Frequently Asked Questions (FAQ)

Pertanyaan: Apa perbedaan Zabbix Agent dan Zabbix Agent 2? Jawaban: Zabbix Agent adalah versi klasik berbasis C, sedangkan Zabbix Agent 2 adalah versi baru berbasis Go dengan performa lebih baik dan dukungan plugin. Zabbix Agent 2 kini menjadi rekomendasi utama untuk instalasi baru.

Pertanyaan: Kenapa host saya berstatus merah di dashboard Zabbix? Jawaban: Umumnya karena parameter Hostname di file konfigurasi agent tidak sama persis dengan nama host yang didaftarkan di frontend Zabbix Server, atau port 10050 belum terbuka di firewall.

Pertanyaan: Apakah Zabbix Agent aman digunakan di server produksi? Jawaban: Aman, selama dikonfigurasi dengan benar. Disarankan mengaktifkan enkripsi PSK, membatasi IP yang boleh mengakses agent, serta membatasi penggunaan system.run untuk mencegah eksekusi perintah dari luar yang tidak diinginkan.

Pertanyaan: Bagaimana cara memantau metrik yang tidak tersedia secara default? Jawaban: Gunakan fitur UserParameter di file konfigurasi agent untuk membuat item monitoring kustom, misalnya memantau ukuran folder tertentu atau jumlah koneksi aktif pada port tertentu.

Pertanyaan: Apakah perlu membuka port di kedua arah (agent dan server)? Jawaban: Tergantung mode yang dipakai. Untuk passive check, port 10050 di sisi agent yang perlu dibuka. Untuk active check, agent yang menginisiasi koneksi ke Zabbix Server sehingga arah yang perlu diizinkan adalah dari agent ke server.


Punya pengalaman atau pertanyaan seputar konfigurasi Zabbix Agent?

Yuk tulis di kolom komentar, mari berdiskusi bersama komunitas! Bagikan artikel ini ke rekan sysadmin/DevOps Anda, dan terus ikuti update konten terbaru seputar Linux, Networking, dan Infrastruktur IT di blog ini.

Tinggalkan Balasan

Alamat email Anda tidak akan dipublikasikan. Ruas yang wajib ditandai *

Dilindungi Oleh
Shield Security