sunucu.com.tr

Zabbix agent kurulumu: Linux ve Windows

Bu rehberde Zabbix Agent 2'yi Linux ve Windows sunuculara kuruyor, aktif kipte ve PSK ile şifreli çalışacak şekilde yapılandırıyor ve Zabbix arayüzünde host olarak tanımlıyoruz. Komutlar Zabbix'in güncel LTS serisi içindir; ajan serisi Zabbix sunucunuzla aynı olmalıdır.

Son güncelleme: 15 Ekim 2026

Rehberler ve içindekiler

Zabbix agent mı, Agent 2 mi?

Zabbix agentZabbix Agent 2
DilCGo
Uygulama izlemeÇoğunlukla betik ve UserParameter ileEklentilerle doğrudan: Docker, MySQL, PostgreSQL, Redis, MongoDB, SSL sertifikası
Eşzamanlı kontrolSınırlıKontroller eşzamanlı çalışır, aktif kontrollerde kalıcı arabellek
Paket adızabbix-agentzabbix-agent2
Windows hizmetiZabbix AgentZabbix Agent 2

Yeni kurulumlarda Agent 2 önerilir. İkisi de varsayılan olarak TCP 10050'yi dinlediği için aynı sunucuda yalnız birini kurun.

Aktif mi, pasif mi?

Pasif kipte Zabbix server ajana bağlanır (ajan TCP 10050'yi dinler). Aktif kipte ajan server'a bağlanır (server'ın TCP 10051 portuna). Başka bir ağdaki ya da internet üzerinden izlenen sunucularda aktif kip daha güvenli ve daha kolaydır: izlenen sunucuya içeriden port açmanız gerekmez. Bu rehberdeki yapılandırma aktif kip içindir.

Linux'a Zabbix Agent 2 kurulumu

Ubuntu ve Debian

Ubuntu 24.04

wget https://repo.zabbix.com/zabbix/7.0/ubuntu/pool/main/z/zabbix-release/zabbix-release_latest_7.0+ubuntu24.04_all.deb
sudo dpkg -i zabbix-release_latest_7.0+ubuntu24.04_all.deb
sudo apt update
sudo apt install -y zabbix-agent2

Ubuntu 22.04 için depo paketi zabbix-release_latest_7.0+ubuntu22.04_all.deb, Debian 12 için zabbix-release_latest_7.0+debian12_all.deb dosyasıdır (adresin geri kalanı aynı, Debian'da ubuntu yerine debian dizini).

AlmaLinux ve Rocky Linux

AlmaLinux / Rocky Linux 9

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

EPEL kullanıyorsanız

EPEL deposundaki Zabbix paketleri resmi depoyla çakışır. /etc/yum.repos.d/epel.repo dosyasında [epel] bölümünün altına excludepkgs=zabbix* satırını ekleyin. 8 serisinde adresteki 9 ve el9 yerine 8 ve el8 yazın.

PSK anahtarı

Ajan ile server arasındaki trafiği şifrelemek için ortak bir anahtar (PSK) üretin:

PSK

openssl rand -hex 32 | sudo tee /etc/zabbix/zabbix_agent2.psk
sudo chown zabbix:zabbix /etc/zabbix/zabbix_agent2.psk
sudo chmod 600 /etc/zabbix/zabbix_agent2.psk

Yapılandırma

/etc/zabbix/zabbix_agent2.conf dosyasında şu satırları düzenleyin (192.0.2.10 yerine Zabbix server ya da proxy adresiniz):

/etc/zabbix/zabbix_agent2.conf

# Pasif kontrollere yalnız bu adres izinli (yalnız aktif kullanacaksanız 127.0.0.1 yazabilirsiniz)
Server=192.0.2.10
# Aktif kontroller: ajan bu adrese, TCP 10051'e bağlanır
ServerActive=192.0.2.10
# Zabbix arayüzündeki host adıyla birebir aynı olmalı
Hostname=web-01

TLSConnect=psk
TLSAccept=psk
TLSPSKIdentity=web-01-psk
TLSPSKFile=/etc/zabbix/zabbix_agent2.psk

# Uzaktan komut çalıştırmayı kapatın
DenyKey=system.run[*]

Başlatma

sudo systemctl enable --now zabbix-agent2
sudo systemctl restart zabbix-agent2
sudo systemctl status zabbix-agent2 --no-pager

Yalnız aktif kip kullanıyorsanız sunucuya içeriden port açmanız gerekmez; sunucudan dışarıya TCP 10051 açık olmalı. Pasif kontrol de kullanacaksanız 10050'yi yalnız server adresine açın: sudo ufw allow from 192.0.2.10 to any port 10050 proto tcp.

Windows'a Zabbix Agent 2 kurulumu

Zabbix'in indirme sayfasından Windows için Zabbix Agent 2'nin güncel MSI paketini (zabbix_agent2-7.0.x-windows-amd64-openssl.msi biçiminde; Zabbix sunucunuzla aynı seri) indirin. Paketi çift tıklayıp sihirbazla kurabilirsiniz: sihirbaz server adresini, host adını ve PSK bilgilerini sorar.

Birden çok sunucuda aynı ayarla kurmak için sessiz kurulum daha pratiktir. Yönetici olarak açılmış PowerShell'de:

PowerShell (yönetici)

# 32 baytlık rastgele PSK (64 onaltılık karakter)
$b = New-Object byte[] 32
[Security.Cryptography.RandomNumberGenerator]::Create().GetBytes($b)
$psk = -join ($b | ForEach-Object { $_.ToString('x2') })

$msi = "zabbix_agent2-7.0.x-windows-amd64-openssl.msi"
Start-Process msiexec.exe -Wait -ArgumentList "/i $msi /qn /l*v C:\zabbix-agent2-kurulum.log SERVER=192.0.2.10 SERVERACTIVE=192.0.2.10 HOSTNAME=win-01 TLSCONNECT=psk TLSACCEPT=psk TLSPSKIDENTITY=win-01-psk TLSPSKVALUE=$psk"

$psk   # Zabbix arayüzüne gireceğiniz anahtar

Dosya adındaki 7.0.x yerine indirdiğiniz güncel sürümü yazın. Kurulum "Zabbix Agent 2" adlı Windows hizmetini açar; yapılandırma dosyası C:\Program Files\Zabbix Agent 2\zabbix_agent2.conf konumundadır. Dosyayı değiştirdikten sonra hizmeti yeniden başlatın:

Hizmet

Restart-Service "Zabbix Agent 2"
Get-Service "Zabbix Agent 2"

Güvenlik duvarı

MSI paketi varsayılan olarak Windows Güvenlik Duvarı'nda pasif kontroller için TCP 10050 kuralı açar. Yalnız aktif kip kullanacaksanız kuralı kapatabilir ya da kurulumda SKIP=fw parametresini verebilirsiniz; sunucudan dışarıya TCP 10051 açık olmalı.

Zabbix arayüzünde host tanımı

  1. Data collection > Hosts > Create host.
  2. Host name: ajandaki Hostname değerinin aynısı (ör. web-01).
  3. Templates: Linux için "Linux by Zabbix agent active", Windows için "Windows by Zabbix agent active".
  4. Host groups: ör. "Linux servers".
  5. Encryption sekmesi: "Connections from host" altında PSK'yı işaretleyin, PSK identity (web-01-psk) ve PSK değerini (ürettiğiniz 64 karakter) girin. Pasif kontrol de kullanıyorsanız "Connections to host" için de PSK seçin ve Interfaces bölümüne ajan arayüzünü (IP, 10050) ekleyin.
  6. Kaydedin. Birkaç dakika içinde Monitoring > Latest data altında değerler görünür.

Çok sayıda sunucu için otomatik kayıt

Her sunucuyu elle tanımlamak yerine ajan yapılandırmasına HostMetadata=linux web gibi bir satır ekleyip Alerts > Actions > Autoregistration actions altında bu metne göre host oluşturan, şablon ve grup bağlayan bir eylem tanımlayabilirsiniz. PSK ile otomatik kayıt için Administration > General > Autoregistration ayarında şifreleme bilgisini de girin.

Doğrulama ve sorun giderme

Linux

zabbix_agent2 -t agent.ping                 # ajan anahtarı okuyabiliyor mu
zabbix_agent2 -t 'vfs.fs.size[/,pused]'
sudo tail -n 50 /var/log/zabbix/zabbix_agent2.log
journalctl -u zabbix-agent2 --since "10 min ago"
Günlükteki belirtiOlası neden
cannot connect to [[192.0.2.10]:10051]Sunucudan dışarıya 10051 kapalı ya da ServerActive adresi yanlış
host [web-01] not foundArayüzdeki host adı ajandaki Hostname ile aynı değil ya da host henüz tanımlanmadı
TLS el sıkışma ya da PSK hatasıPSK identity veya PSK değeri iki tarafta farklı; dosya izni zabbix kullanıcısına okunamıyor
Değerler gelmiyor, hata yokŞablon pasif kontrol kullanıyor ama ajan arayüzü yok; aktif şablonu bağlayın

Saatin doğru olduğundan da emin olun: ajan ile server arasında büyük saat farkı grafiklerde boşluk ve hatalı tetikleyici yaratır.

Ajanı kaldırma

Linux

sudo systemctl disable --now zabbix-agent2
sudo apt purge -y zabbix-agent2        # RHEL ailesinde: sudo dnf remove -y zabbix-agent2

Windows'ta Ayarlar > Uygulamalar (ya da Programlar ve Özellikler) altında "Zabbix Agent 2" kaldırılır.

Zabbix sunucusu kurmadan izlemek isterseniz

Kendi Zabbix sunucunuz yoksa ajanı kuracak bir yer de yoktur. Hizmetimizde ajan kurulumu panelde oluşan tek satırlık komutla yapılır; depo, yapılandırma, PSK ve host tanımı kendiliğinden hazırlanır:

  • Zabbix sunucusu, veritabanı, sürüm güncellemeleri ve izleme şablonları bizde; sizin bakım yapacağınız bir izleme sunucusu yok.
  • Sunucunuza tek komutla Zabbix Agent 2 kurulur: aktif kipte, PSK ile şifreli, dışarıdan port açmadan.
  • Linux ve Windows sunucular, bizde ya da başka bir sağlayıcıda olsun, aynı panelde; e-posta uyarısı, grafikler ve dönem raporu hazır.
  • Web adresi, port ve SSL kontrolleri sunucunuzun dışındaki izleme noktalarımızdan yapılır.

Paketler ve sunucu başına fiyat Sunucu İzleme sayfasında; sipariş aynı sayfadaki sipariş formundan verilir.

Sık sorulan sorular

Zabbix agent hangi portu kullanır?

Pasif kontrollerde ajan TCP 10050'yi dinler. Aktif kontrollerde ajan Zabbix server ya da proxy'nin TCP 10051 portuna bağlanır. Yalnız aktif kip kullanılıyorsa izlenen sunucuya içeriden port açmak gerekmez.

Windows'ta Zabbix agent servisi nasıl yeniden başlatılır?

Yönetici PowerShell'de Restart-Service "Zabbix Agent 2" komutuyla ya da Hizmetler (services.msc) penceresinde Zabbix Agent 2'ye sağ tıklayıp Yeniden başlat ile. Eski ajanda hizmetin adı Zabbix Agent'tır.

Hostname değeri ne olmalı?

Zabbix arayüzündeki host adıyla birebir aynı olmalıdır; büyük küçük harf de dahil. Aktif kipte ajan kendini bu adla tanıtır, eşleşme yoksa günlükte host not found hatası görülür.

Zabbix agent ile Agent 2 aynı sunucuda çalışır mı?

İkisi de varsayılan olarak TCP 10050'yi dinlediği için aynı anda kurulmaları önerilmez. Agent 2'ye geçerken eski ajanı durdurup kaldırın, aynı Hostname ve PSK ayarlarını Agent 2'ye taşıyın.

Zabbix agent için PSK zorunlu mu?

Zorunlu değildir ama internet üzerinden giden ajan trafiğinde şifreleme kullanılmalıdır. PSK en kolay yoldur: openssl rand -hex 32 ile üretilen anahtar ajanda dosyada, arayüzde host'un Encryption sekmesinde tanımlanır.

Zabbix, Zabbix LLC'nin ticari markasıdır. sunucu.com.tr'nin Zabbix LLC ile bir bağlantısı yoktur; hizmetimiz açık kaynak Zabbix yazılımını kullanır.