BT Sistem Yönetimi

Zabbix Agent 2 Kurulumu: GPO, Autoregistration ve PSK

Zabbix Agent 2 kurulumu: Windows'a GPO betiğiyle toplu dağıtım, Linux'a apt, PSK'lı autoregistration ve lab'da ölçülen tuzaklar adım adım anlatılıyor.

İlker Pehlivan

Zabbix Agent 2, kurumdaki Windows bilgisayarlara tek tek değil, GPO’ya bağlanan bir başlangıç betiğiyle kurulur. Agent server’a kendisi bağlanır, server onu autoregistration ile host listesine kendiliğinden ekler ve bağlantı bir ön paylaşımlı anahtarla (PSK) şifrelenir. Linux’ta aynı düzen, apt ile kurulan paketin yapılandırma dosyasına birkaç satır olarak girer.

Bu yazı, Zabbix sunucusu kurulduktan sonraki adımı anlatır: izlenecek makinelere agent kurmak. Lab’da Windows 11 istemcisine GPO ile, Ubuntu 26.04 sunucusuna apt ile kurdum ve her adımı ölçtüm: MSI sihirbazının açık bıraktığı iki kapı, betiğin ilk denemede neden 1603 hatasıyla durduğu, PSK’nın hangi dosyada düz metin kaldığı, yanlış anahtarla bağlanan agent’ın iki tarafta hangi satırı yazdığı. Agent’ın ne olduğunu ve öteki parçalarla nasıl konuştuğunu Zabbix nedir yazısında anlattık. Doğrudan dağıtıma geçmek isterseniz GPO adımlarına atlayabilirsiniz.

Leylek göçünü izleyen bir araştırma merkezi kuşların peşinden tek tek gitmez. Göç yolundaki bir durakta sürünün her kuşuna küçük bir uydu vericisi takılır. Verici konumunu kendisi gönderir, merkez ilk sinyali alınca o kuşun kaydını kendiliğinden açar ve sinyaldeki tür bilgisine bakıp kuşu doğru haritaya yerleştirir. Merkez yalnız kendi kodunu taşıyan vericinin sinyalini kabul eder ve o kod vericinin kutusuna yazılmaz, çünkü kutuyu eline alan herkes okur. Zabbix agent dağıtımı da bu düzende kurulur.

Zabbix agent dağıtımı benzetmesi: göl kıyısındaki bir göç durağı, solda sırtında küçük gri verici taşıyan dokuz leylek, ortada çimde diz çökmüş bir araştırmacı kucağındaki onuncu leyleğe verici takıyor, sağda direğinde çanak anten olan ahşap bir istasyon kulübesi
Vericiyi kuşa takan araştırmacı GPO'nun başlangıç betiğidir, verici agent'tır, kulübenin anteni de Zabbix server. Sürünün tamamı aynı durakta aynı vericiyle donatılır ve her kuş merkeze kendisi bildirir.

Bu makale BT Sistem Yönetimi ana hizmetimizin izleme koluna, özellikle izlenecek makinelere agent kurulmasına odaklanır.

Zabbix Agent Kurulumu Nasıl Olmalı?

Önce kısa cevap: Zabbix Agent 2 aktif kontrolle çalışır, server onu autoregistration ile tanır ve kayıt yalnız PSK ile kabul edilir. Windows’a GPO’daki bir bilgisayar başlangıç betiği kurar, PSK betiğin içinde değil yalnız bilgisayar hesaplarının okuyabildiği bir paylaşımda durur. İstemcide gelen bağlantı kuralı açılmaz ve PSK dosyasını yalnız SYSTEM ile yöneticiler okur.

Bu düzeni beş kaynak birlikte tarif ediyor:

  1. Zabbix Agent 2 belgesi (Agent 2, 7.0): Agent 2, Go ile yazılmış yeni nesil agent’tır. TCP bağlantı sayısını azaltır, farklı eklentilerin kontrollerini eşzamanlı yürütür ve aktif item’lar için kalıcı tampon tutabilir.
  2. Windows MSI belgesi (Windows agent installation from MSI, 7.0): SERVER özelliği zorunludur. SKIP=fw MSI’ın Windows Firewall’a kural eklemesini engeller. TLSPSKFILE için belge, anahtar dosyasına erişimin yalnız agent’ı çalıştıran hesaba bırakılmasını önerir.
  3. Autoregistration belgesi (Active agent autoregistration, 7.0): server, host’u eklemeden önce PSK’yı doğrular. Kayıt başarılıysa host’un bağlantıları yalnız PSK’ya ayarlanır. Doğru şablonun bağlanması için HostMetadata kullanılır.
  4. Zabbix PSK belgesi (Using pre-shared keys, 7.0): 256 bitlik anahtar openssl rand -hex 32 ile üretilir.
  5. Microsoft GPMC belgesi (Editing Software Settings Using GPMC): GPO’nun Software Installation bölümünde bir pakete ayar vermenin yolu Modifications sekmesine eklenen dönüşüm (.mst) dosyasıdır.
KararBu yazıdaki seçimNeden
Hangi agent?Zabbix Agent 2Eklentili, eşzamanlı, Windows ve Linux paketi aynı sürümde
Bağlantıyı kim açar?Agent, aktif kontrolleİstemciye dışarıdan bağlantı gerekmez
Host’u kim ekler?Autoregistration eylemiYüz makineyi arayüzden tek tek eklemek gerekmez
Kayıt nasıl korunur?Yalnız PSK ile, şifresiz kayıt kapalıAnahtarı bilmeyen makine kaydolamaz
Windows’a nasıl dağıtılır?GPO başlangıç betiği ve msiexecSoftware Installation ayarı yalnız .mst ile alır
PSK nerede durur?Yalnız Domain Computers’ın okuyabildiği paylaşımdaSYSVOL’daki betiği her kullanıcı okur
İstemcide gelen kural?Yok, MSI’a SKIP=fwAktif kontrolde gelen bağlantı yok

Agent mı, Agent 2 mi?

Zabbix’in iki agent’ı var: C ile yazılmış klasik Zabbix agent ve Go ile yazılmış Zabbix Agent 2. Server ikisiyle aynı protokolle konuşur ve hazır şablonların çoğu ikisinde de çalışır. Fark eklentilerdedir: Agent 2, MySQL, MSSQL, Docker ve MongoDB gibi servisleri kendi eklentisiyle ölçer ve bir eklentinin yavaş kontrolü ötekileri bekletmez. Klasik agent’ı seçmenin bugün tek sebebi Agent 2 paketi olmayan eski bir sistemdir. Zabbix belgesine göre RHEL 6 için Agent 2 paketi 7.0.5’ten beri yayımlanmıyor.

Aktif Kontrol ve Autoregistration: Bağlantıyı Agent Açar

Agent iki biçimde çalışır. Pasif kontrolde server, agent’ın 10050 portuna bağlanıp tek tek değer ister. Aktif kontrolde agent, server’ın 10051 portuna bağlanır, ölçmesi gereken item listesini alır ve sonuçları kendisi gönderir. İki modun farkını paket düzeyinde Zabbix nedir yazısında ölçtük.

Zabbix’te izlenen her makine bir host’tur ve host’un ne ölçüleceğini ona bağlanan şablon (template) belirler. Autoregistration, bu host’u server’ın kendisinin açmasıdır. Yalnız aktif agent’la çalışır, çünkü server bir makineyi ancak o makine kendisine bağlandığında tanır. Agent bağlanırken iki şey söyler: adını ve HostMetadata adlı serbest bir metni. Server’daki kayıt eylemi bu metne bakar ve host’u hangi gruba koyacağına, hangi şablonu bağlayacağına karar verir.

Bu yazıdaki düzende agent aktif kontrolle çalışır ve şablonlar adının sonunda active taşıyan sürümlerdir (Windows by Zabbix agent active, Linux by Zabbix agent active). Pasif şablon bağlanırsa server 10050’ye bağlanmaya çalışır ve gelen kuralı olmayan makineden veri alamaz.

Agent yine de 10050’yi dinler, çünkü MSI SERVER özelliğini zorunlu tutar. Bu port için kural yazılmadığında Windows Defender Firewall fabrika ayarında gelen bağlantıyı engeller. Agent ile server arasındaki trafik TLS ile şifrelenir ve iki taraf birbirini PSK ile tanır.

Zabbix Autoregistration: Server Tarafını Hazırlamak

Agent kurulmadan önce server’ın onu karşılamaya hazır olması gerekir: bir anahtar, o anahtarı isteyen bir kayıt ayarı, host grupları ve her işletim sistemi için bir kayıt eylemi. Bu sırayla hazırlanırsa agent kurulduğu anda listeye düşer.

PSK’yı Üretmek

PSK, server ile agent’ın paylaştığı gizli bir değerdir. Zabbix sunucusunda üretilir:

mon02Bash
openssl rand -hex 32 > autoreg.psk

Dosyada 64 onaltılık karakter durur, yani 256 bitlik bir anahtar. PSK’nın bir de kimliği vardır. Kimlik gizli değildir, agent bağlanırken hangi anahtarı kullandığını onunla söyler. Bu yazıda kimlik PSK-AUTOREG-01. Değer ise kimseye gösterilmez: ekrana basılmaz, bir belgeye ya da e-postaya yapıştırılmaz.

Autoregistration’ı Yalnız PSK’ya Açmak

Administration → General → Autoregistration ekranında fabrika ayarı No encryption’dır. Yani bir kayıt eylemi tanımlandığı anda, server’ın adresini bilen her agent şifresiz bağlanıp kaydolabilir. No encryption kutusunu kaldırın, PSK kutusunu işaretleyin, PSK identity alanına kimliği, PSK alanına dosyadaki değeri yazın ve Update’e basın.

Zabbix Autoregistration ekranı: No encryption kutusu boş, PSK işaretli, PSK identity alanında 'PSK-AUTOREG-01'.
Şifrelemenin iki kutusu ayrıdır. No encryption işaretli kaldıkça PSK'sız agent da kaydolabilir.

Kaydettikten sonra ekran PSK değerini bir daha göstermez, yerinde Change PSK düğmesi durur. Zabbix belgesine göre bu ayar bütün kayıtlar için tektir: autoregistration ile gelen her host aynı kimliği ve aynı anahtarı devralır.

Host Grupları ve Kayıt Eylemleri

Data collection → Host groups altında iki grup açın: Windows istemciler ve Linux sunucular. Sonra Alerts → Actions → Autoregistration actions → Create action ile Windows için bir eylem tanımlayın. Action sekmesinde koşul Host metadata contains Windows.

Zabbix New action penceresi, Action sekmesi: ad 'Windows agent kaydi', koşul 'Host metadata contains Windows'.
Koşul, agent'ın kendini tanıtırken gönderdiği metadata metnine bakar. Metni agent'ın yapılandırması belirler.

Operations sekmesinde üç işlem eklenir: Add host, Add to host groups ile Windows istemciler ve Link templates ile Windows by Zabbix agent active.

Zabbix New action penceresi, Operations sekmesi: Add host, Add to host groups 'Windows istemciler', Link templates 'Windows by Zabbix agent active'.
Host'u açmak, gruba almak ve şablonu bağlamak tek eylemde biter. Yeni makine listeye düştüğünde ölçmeye hazırdır.

Aynı adımlar Linux için tekrarlanır: koşul Host metadata contains Linux, grup Linux sunucular, şablon Linux by Zabbix agent active. Add host işlemi host’u ayrıca Zabbix’in Discovered hosts grubuna da koyar, lab’daki Linux host’u iki grupta göründü. Host’ları süzerken Discovered hosts’u değil kendi grubunuzu kullanın.

Zabbix Agent 2’yi Tek Windows Makineye Kurmak

Toplu dağıtımdan önce tek bir makineye sihirbazla kurmak, MSI’ın neyi nereye yazdığını görmenin en kısa yoludur. Lab’da kurulumu ankmuh01 istemcisinde, Tier 2 yönetici hesabı t2.sistemkusu ile yaptım. Paket Zabbix’in indirme sayfasındaki zabbix_agent2-7.0.32-windows-amd64-openssl.msi, imzası Zabbix SIA adına geçerli.

Sihirbazın karşılama, lisans ve bileşen sayfaları fabrika ayarında geçilir. Asıl karar Zabbix Agent 2 service configuration sayfasındadır.

Zabbix Agent 2 MSI sihirbazı, service configuration sayfası: Host name 'ANKMUH01', iki server alanında '192.168.1.29', Enable PSK işaretli.
Fabrikada server alanı boş, aktif kontrol alanı 127.0.0.1 gelir. İkisine de Zabbix sunucusunun adresi yazılır.
  1. Host name: bilgisayar adıyla dolu gelir (ANKMUH01). Dokunulmaz.
  2. Zabbix server IP/DNS: boş gelir. Zabbix sunucusunun adresi yazılır (192.168.1.29).
  3. Server or Proxy for active checks: fabrikada 127.0.0.1 yazılıdır. Böyle kalırsa agent aktif kontrol listesini kendi makinesinde arar ve server’a hiç bağlanmaz. Buraya da sunucunun adresi yazılır.
  4. Enable PSK: işaretlenir.

Sonraki sayfa PSK’yı ister.

Zabbix Agent 2 MSI sihirbazı, pre-shared key configuration sayfası: identity alanında 'PSK-AUTOREG-01', value alanı boş.
Value kutusu maskeli değildir. Ekran paylaşırken ya da kayıt alırken bu sayfa doldurulmaz.

Pre-shared key identity alanına kimlik, Pre-shared key value alanına değer yazılır. İki kutu da düz metindir: değer yazıldığı anda ekranda okunur. Sayfanın altındaki Please, set minimum required permission to access the psk.key file cümlesi bir uyarıdır, sihirbaz izni kendisi kısmaz. Next ve Install ile kurulum yarım dakikada biter.

MSI Sihirbazının Bıraktığı İki Açık

Kurulumdan sonra makineye baktığımda sihirbazın iki şeyi açık bıraktığını gördüm.

  1. 10050’yi her adrese açan bir kural. Sihirbaz Zabbix Agent 2 listen port adında bir kural yazar: gelen, izin ver, bütün profiller, Remote address Any, TCP 10050. Sihirbazın hiçbir sayfasında bu kuralı kapatan bir seçenek yok. Agent izinsiz bir adresten gelen pasif isteğe değer döndürmez, bunu Zabbix nedir yazısında ölçtük. Ama aktif kontrolle çalışan bir agent için bu port dışarıya hiç açılmamalıdır.
  2. Herkesin okuyabildiği anahtar dosyası. Sihirbaz PSK’yı C:\Program Files\Zabbix Agent 2\psk.key dosyasına yazar ve dosya klasörün izinlerini devralır: BUILTIN\Users okuyabilir. Bilgisayara oturum açan her kullanıcı, bütün kurumun autoregistration anahtarını okuyabilir.

Kuralı görmek ve dosyanın iznini okumak için:

ankmuh01PowerShell
Get-NetFirewallRule -DisplayName 'Zabbix Agent 2 listen port' | Get-NetFirewallAddressFilter
icacls 'C:\Program Files\Zabbix Agent 2\psk.key'

İkisini de tek makinede elle düzeltmek mümkün, ama yüz makinede bu düzeltme unutulur. Bir sonraki bölümdeki betik iki açığı kurulumla birlikte kapatır.

Zabbix Agent’ı GPO ile Toplu Dağıtmak

Toplu dağıtım dört parçadan oluşur: MSI’ı ve PSK’yı tutan bir paylaşım, paylaşımdan kurulum yapan bir PowerShell betiği, betiği bilgisayar açılışında çalıştıran bir GPO ve GPO’nun bağlandığı OU. Aynı yöntemi GLPI Agent dağıtımında de kullandık: başlangıç betiği kullanıcı oturum açmadan, SYSTEM hesabıyla çalışır ve kullanıcının yönetici olması gerekmez.

Zabbix agent'ın GPO ile dağıtım zinciri. dc01'de iki kaynak var: SYSVOL'daki başlangıç betiğini domain'deki her kullanıcı okur, zabbix-agent$ paylaşımındaki MSI ve PSK dosyasını yalnız Domain Computers okur. İstemci açılışta SYSTEM olarak betiği çalıştırır, kurulu sürüme bakar, PSK'yı paylaşımdan okur, MSI'ı SKIP=fw ve HOSTMETADATA=Windows ile kurar, psk.key dosyasını SYSTEM ve yöneticilere daraltır ve agent servisi başlar. Agent Zabbix server'ın TCP 10051 portuna PSK ile bağlanır, autoregistration PSK'yı doğrular, kayıt eylemi metadata'ya göre grup ve şablonu bağlar, host listeye düşer ve aktif kontroller çalışır. dc01 ankmuh01 (açılış, SYSTEM) Zabbix server SYSVOL: betik zabbix-agent$: MSI, PSK Başlangıç betiği Autoregistration Kayıt eylemi Host listede domain'deki her kullanıcı okur yalnız Domain Computers okur PSK doğrulanır metadata Windows: grup, şablon aktif kontroller çalışır 1. Kurulu sürüme bakar 2. PSK'yı paylaşımdan okur 3. msiexec: SKIP=fw, HOSTMETADATA=Windows 4. psk.key: SYSTEM, Admins 5. Agent servisi başlar 6. Agent server'a bağlanır agent → server, TCP 10051, PSK Betik herkesin okuduğu yerde durur, anahtar yalnız bilgisayarların okuduğu yerde. İstemciye dışarıdan bağlantı gelmez: bağlantıyı agent açar. Zabbix agent'ın GPO ile dağıtım zinciri. SYSVOL'daki betiği her kullanıcı, paylaşımdaki MSI ve PSK'yı yalnız Domain Computers okur. İstemci açılışta betiği çalıştırır, agent'ı kurar, PSK dosyasını daraltır. Agent server'ın TCP 10051 portuna PSK ile bağlanır, autoregistration PSK'yı doğrular, kayıt eylemi grup ve şablonu bağlar ve host listeye düşer. dc01 SYSVOL: betik zabbix-agent$: MSI, PSK ankmuh01: başlangıç betiği (SYSTEM) Autoregistration: PSK doğrulanır Kayıt eylemi: grup ve şablon Host listede, aktif kontroller domain'deki her kullanıcı okur yalnız Domain Computers okur Zabbix server 1. Kurulu sürüme bakar 2. PSK'yı paylaşımdan okur 3. msiexec: SKIP=fw, HOSTMETADATA=Windows 4. psk.key: SYSTEM, Admins 5. Agent servisi başlar 6. Agent server'a bağlanır TCP 10051, PSK Betik herkesin okuduğu yerde, anahtar yalnız bilgisayarların.
Zincirde iki okuma izni yan yana durur. Betiği domain'deki herkes okuyabildiği için anahtar betiğe yazılmaz, yalnız bilgisayar hesaplarının açabildiği paylaşımda durur.

Neden Software Installation Değil?

GPO’nun kendi yazılım dağıtımı (Software Installation) MSI’ı kurar ama ona komut satırı özelliği veremez. Microsoft’un belgesine göre pakete ayar vermenin yolu, Modifications sekmesine eklenen bir dönüşüm (.mst) dosyasıdır. Zabbix agent’ta bu dosya server adresini, metadata’yı ve PSK’yı taşımak zorundadır ve her sürüm ya da anahtar değişiminde yeniden üretilir. Kurulumdan sonra psk.key’in iznini daraltacak bir adım da yoktur. Başlangıç betiği bu üç işi tek dosyada yapar ve sürüm değişimi betikteki bir satırdır.

Paylaşım: MSI ve PSK Yalnız Bilgisayar Hesaplarına Açık

Başlangıç betiği SYSTEM olarak çalışır ve ağa bilgisayarın kendi hesabıyla (ANKMUH01$) çıkar. Bu yüzden paylaşımı okuması gereken kullanıcılar değil, Domain Computers grubudur. Lab’da paylaşımı dc01 üzerinde açtım. Canlıda bir dosya sunucusu da olur. Yönetici PowerShell’de:

dc01PowerShellYönetici
New-Item -ItemType Directory -Path 'C:\Dagitim\zabbix-agent'
New-SmbShare -Name 'zabbix-agent$' -Path 'C:\Dagitim\zabbix-agent' -ReadAccess 'SISTEMKUSU\Domain Computers' -FullAccess 'SISTEMKUSU\Domain Admins'
icacls 'C:\Dagitim\zabbix-agent' /inheritance:r /grant:r '*S-1-5-18:(OI)(CI)F' '*S-1-5-32-544:(OI)(CI)F' 'SISTEMKUSU\Domain Computers:(OI)(CI)RX'
  1. New-SmbShare: SMB paylaşımını açar. Adın sonundaki $ paylaşımı ağ gezgininde gizler, bir güvenlik önlemi değildir. Güvenliği bir sonraki satır sağlar. Paylaşım izinlerinin mantığını dosya sunucusu kurulumu yazısında anlattık.
  2. icacls ... /inheritance:r: klasörün üst klasörden devraldığı izinleri kaldırır ve yalnız üç girdi bırakır: SYSTEM ve yöneticiler tam yetki, Domain Computers okuma ve çalıştırma. Authenticated Users listede yoktur, yani bir kullanıcı kendi hesabıyla bu klasörü açamaz. İki izin katmanının nasıl birleştiğini ACL yazısında anlattık.

Klasöre iki dosya konur: MSI paketi ve PSK’yı tek satır olarak taşıyan autoreg.psk.

Başlangıç Betiği

Betik her açılışta çalışır. Agent kuruluysa ve sürümü yeterliyse hiçbir şey yapmadan çıkar. Değilse PSK’yı paylaşımdan okur, MSI’ı sessiz kurar ve anahtar dosyasının iznini daraltır. Bir PowerShell betiği olarak zabbix-agent2-kur.ps1 adıyla kaydedilir. Açıklama satırları Türkçe harf taşımaz, çünkü Windows PowerShell BOM’suz bir dosyayı ANSI kod sayfasıyla okur.

ankmuh01PowerShell
# Zabbix agent 2: GPO bilgisayar baslangic betigi
# Kurulu degilse ya da surum eskiyse MSI'i sessiz kurar, PSK dosyasini kisitlar.
$Surum    = '7.0.32'
$Kaynak   = '\\dc01.ad.sistemkusu.com\zabbix-agent$'
$Msi      = Join-Path $Kaynak "zabbix_agent2-$Surum-windows-amd64-openssl.msi"
$PskKaynak = Join-Path $Kaynak 'autoreg.psk'
$Sunucu   = '192.168.1.29'
$PskKimlik = 'PSK-AUTOREG-01'
$Klasor   = 'C:\Program Files\Zabbix Agent 2'
$PskDosya = Join-Path $Klasor 'psk.key'
$MsiGunluk = 'C:\Windows\Temp\zabbix-agent2-kurulum.log'
$Gunluk   = 'C:\Windows\Temp\zabbix-agent2-betik.log'

function Yaz($m) { Add-Content -Path $Gunluk -Value ("{0:yyyy-MM-dd HH:mm:ss} {1}" -f (Get-Date), $m) }

$kurulu = Get-ItemProperty 'HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\*' -ErrorAction SilentlyContinue |
    Where-Object { $_.DisplayName -like 'Zabbix Agent 2*' } | Select-Object -First 1
if ($kurulu -and ([version]$kurulu.DisplayVersion -ge [version]$Surum)) {
    Yaz "Kurulu ($($kurulu.DisplayVersion)), atlandi"
    exit 0
}

if (-not (Test-Path $Msi) -or -not (Test-Path $PskKaynak)) {
    Yaz "Paylasima erisilemedi: $Kaynak"
    exit 1
}
$psk = (Get-Content -Path $PskKaynak -TotalCount 1).Trim()

# TLSPSKFILE verilince MSI klasoru kurulumdan once arar, yoksa 1603 ile durur
New-Item -ItemType Directory -Path $Klasor -Force | Out-Null

$argumanlar = @(
    '/i', "`"$Msi`"", '/qn', '/l*v', "`"$MsiGunluk`"",
    "SERVER=$Sunucu", "SERVERACTIVE=$Sunucu",
    'HOSTMETADATA=Windows',
    'TLSCONNECT=psk', 'TLSACCEPT=psk',
    "TLSPSKIDENTITY=$PskKimlik",
    "TLSPSKFILE=`"$PskDosya`"", "TLSPSKVALUE=$psk",
    'SKIP=fw'
)
$p = Start-Process -FilePath 'msiexec.exe' -ArgumentList $argumanlar -Wait -PassThru
Yaz "msiexec cikis kodu: $($p.ExitCode)"
if ($p.ExitCode -ne 0) { exit $p.ExitCode }

# PSK dosyasini yalniz SYSTEM ve Administrators okusun
icacls $PskDosya /inheritance:r /grant:r '*S-1-5-18:R' '*S-1-5-32-544:F' | Out-Null
Yaz "PSK dosyasi kisitlandi"
  1. Sürüm denetimi: betik kurulu agent’ı kayıt defterindeki kaldırma kaydından okur. Kurulu sürüm $Surum’dan eski değilse log’a atlandi yazar ve çıkar. Elle kurulmuş bir agent da kurulu sayılır: betik onun ayarına dokunmaz, o makine bir kez elle düzeltilir.
  2. PSK okuma: değer paylaşımdaki dosyadan okunur ve yalnız bellekte durur. Betiğin içinde PSK yoktur. Açılışta ağa bağlı olmayan bir dizüstü paylaşıma ulaşamaz: betik Paylasima erisilemedi yazar ve bir sonraki açılışta yeniden dener.
  3. New-Item: MSI’ın beklediği klasörü kurulumdan önce açar. Bu satırın neden gerektiği aşağıdaki kutuda.
  4. MSI özellikleri: sihirbazın sayfalarında doldurulan alanların komut satırı karşılığıdır. HOSTMETADATA=Windows, kayıt eyleminin aradığı metni yazar. SKIP=fw gelen bağlantı kuralını yazdırmaz. HOSTNAME verilmez: agent adı bilgisayardan alır.
  5. icacls: psk.key’in devraldığı izinleri kaldırır, SYSTEM’e okuma, yöneticilere tam yetki bırakır. SID’ler (S-1-5-18 SYSTEM, S-1-5-32-544 Administrators) dil bağımsızdır, Türkçe Windows’ta da çalışır.

GPO: Bilgisayar Başlangıç Betiği

GPO, istemcilerin durduğu OU’ya bağlanır. Lab’da bu OU Tier 2 → Ankara → Bilgisayarlar. GPMC’de OU’ya sağ tıklayıp Create a GPO in this domain, and Link it here seçilir ve GPO’ya adlandırma standardımıza göre bir ad verilir: PC_ZABBIX_AGENT. GPO yalnız bilgisayar ayarı taşıdığı için Details sekmesinde GPO Status User configuration settings disabled yapılır.

Group Policy Management, PC_ZABBIX_AGENT GPO'sunun Scope sekmesi: link yeri Bilgisayarlar, yol 'ad.sistemkusu.com/Tier 2/Ankara/Bilgisayarlar', Security Filtering Authenticated Users.
GPO yalnız Ankara'daki bilgisayarların OU'suna bağlı. Security Filtering fabrika ayarında kalır, bilgisayar hesapları da Authenticated Users'ın içindedir.

Betik GPO düzenleyicide eklenir: Computer Configuration → Policies → Windows Settings → Scripts (Startup/Shutdown) → Startup → Properties. Pencerede PowerShell Scripts sekmesine geçilir, Show Files ile açılan klasöre zabbix-agent2-kur.ps1 kopyalanır, Add ile betik seçilir.

Group Policy Management Editor, Startup Properties penceresi: PowerShell Scripts sekmesi seçili, listede 'zabbix-agent2-kur.ps1'.
Betik Scripts sekmesine değil PowerShell Scripts sekmesine eklenir. Böylece Windows onu doğrudan PowerShell ile çalıştırır.

Show Files ile açılan klasör GPO’nun SYSVOL’daki kendi klasörüdür. GPO’nun dosyalarının nerede durduğunu GPO yönetimi yazısında anlattık. GPMC betiğin kaydını aynı klasördeki psscripts.ini dosyasına yazar:

INI
[Startup]
0CmdLine=zabbix-agent2-kur.ps1
0Parameters=

Betiği Herkes Okur, PSK’yı Yalnız Bilgisayar

PSK’nın betiğe yazılmamasının sebebini lab’da ölçtüm. ankmuh01’de standart bir kullanıcıyla (ayse.demir) oturum açtım ve üç şeyi okumayı denedim:

  1. SYSVOL’daki betik: okundu, 44 satırın hepsi. SYSVOL’daki GPO klasörlerinde Authenticated Users okuma iznine sahiptir, yani domain’deki her kullanıcı her GPO’nun betiğini okur. Betiğe yazılan bir PSK, kurumdaki herkese verilmiş olur.
  2. zabbix-agent$ paylaşımı: Access is denied. Paylaşımı yalnız bilgisayar hesapları okuyor.
  3. İstemcideki psk.key: Access is denied. Betik izni daraltmıştı.

İlk Açılış: Betik Ne Yazdı?

GPO bağlandıktan sonra istemcinin yeniden başlatılması yeter, gpupdate gerekmez. Bilgisayar açılışta GPO’yu okur ve başlangıç betiğini oturum açma ekranı gelmeden çalıştırır. Açılıştan sonra yönetici PowerShell’de:

ankmuh01CMDYönetici
gpresult /r /scope computer

Applied Group Policy Objects listesinde PC_ZABBIX_AGENT görünmelidir. Betiğin kendi log’u C:\Windows\Temp\zabbix-agent2-betik.log. Lab’daki istemcide, düzeltilmiş betiğin ilk açılışından ve sonraki bir açılıştan kalan satırlar:

ankmuh01Çıktı
2026-11-03 04:18:25 msiexec cikis kodu: 0
2026-11-03 04:18:25 PSK dosyasi kisitlandi
2026-11-03 05:37:32 Kurulu (7.0.32.2400), atlandi

Kurulumdan sonra makinede Zabbix Agent 2 servisi Automatic başlangıçla, LocalSystem hesabıyla çalışıyordu. Güvenlik duvarında Zabbix adlı kural yoktu. psk.key’in izinleri yalnız iki satırdı:

ankmuh01Çıktı
C:\Program Files\Zabbix Agent 2\psk.key BUILTIN\Administrators:(F)
                                        NT AUTHORITY\SYSTEM:(R)

MSI’ın yazdığı yapılandırma dosyasında HostMetadata=Windows satırı vardı, Hostname satırı yoktu. Agent bu durumda adı bilgisayardan alır.

Zabbix Agent 2’yi Linux’a Kurmak

Linux’ta agent Zabbix’in kendi deposundan kurulur. Depo, sunucu kurulumunda eklenen paketle aynıdır (Zabbix deposunu eklemek). Lab’da Ubuntu 26.04 çalışan lnx02’ye depo paketini kurdum, ardından apt ile agent’ı:

lnx02Bash
sudo apt update
sudo apt install zabbix-agent2

Paket servisi hemen başlatır ve açılışa ekler. Ama fabrika yapılandırması yerel bir sunucuya göre yazılmıştır. /etc/zabbix/zabbix_agent2.conf dosyasında üç satır değişmelidir:

Yapılandırma
Server=127.0.0.1
ServerActive=127.0.0.1
Hostname=Zabbix server

İlk ikisi agent’ı kendi makinesine bağlar. Üçüncüsü daha sinsidir. Her Linux makine kendini Zabbix server adıyla tanıtır. Bu ad Zabbix sunucusunun kendi host’unundur ve yüz makineye kurulan agent’ın hepsi aynı adla gelir. Satır yorum yapılınca agent adı sistemden alır.

Önce PSK’sız: Server Kaydı Reddeder

Önce yalnız adresi, adı ve metadata’yı değiştirdim, PSK vermedim:

Yapılandırma
Server=192.168.1.29
ServerActive=192.168.1.29
# Hostname=Zabbix server
HostMetadata=Linux

Agent servisi yeniden başlayınca server’a bağlandı ama host listeye düşmedi. Nedeni server’ın log’undaydı (/var/log/zabbix/zabbix_server.log):

mon02Çıktı
1944:20261103:045829.004 autoregistration from "192.168.1.71" denied (host:"lnx02" ip:"192.168.1.71" port:10050): connection type "unencrypted" is not allowed for autoregistration

Autoregistration ekranında No encryption kaldırıldığı için server şifresiz kaydı reddediyor. Bu satır aynı zamanda ayarın çalıştığını kanıtlar, çünkü anahtarı olmayan makine kaydolamıyor.

PSK Dosyası ve Yapılandırma

PSK dosyası Linux makineye scp ile kopyalanır ve yalnız zabbix kullanıcısının okuyabileceği izinle yerine konur:

lnx02Bash
sudo install -o zabbix -g zabbix -m 400 autoreg.psk /etc/zabbix/zabbix_agent2.psk
shred -u autoreg.psk
ls -l /etc/zabbix/zabbix_agent2.psk
lnx02Çıktı
-r-------- 1 zabbix zabbix 65 Nov  3 05:01 /etc/zabbix/zabbix_agent2.psk

400 izni sahibine yalnız okuma verir, grup ve öteki kullanıcılar hiçbir şey alamaz. İzin hanelerinin anlamını Linux dosya izinleri yazısında anlattık. shred -u geçici kopyayı silmeden önce üzerine yazar. Yapılandırma dosyasının sonuna dört satır eklenir:

Yapılandırma
TLSConnect=psk
TLSAccept=psk
TLSPSKIdentity=PSK-AUTOREG-01
TLSPSKFile=/etc/zabbix/zabbix_agent2.psk

TLSConnect agent’ın server’a açtığı bağlantıyı, TLSAccept server’dan gelecek bağlantıyı PSK’ya bağlar. Servis systemctl ile yeniden başlatılır:

lnx02Bash
sudo systemctl restart zabbix-agent2

Yeniden başlatmadan birkaç saniye sonra lnx02 host listesindeydi, Linux sunucular grubunda ve Linux by Zabbix agent active şablonuyla. Yapılandırma dosyasının kendisi root:zabbix sahipli ve 0640 izinlidir, yani agent okur ama sıradan bir kullanıcı okuyamaz. Dosyada değer değil yalnız anahtar dosyasının yolu durur.

Zabbix Agent Doğrulama: Kayıt, Veri ve Yanlış PSK

Kurulum, host listede yeşil göründüğünde ve veri geldiğinde biter. Lab’da üç şeye baktım: kaydın anı, gelen veri ve yanlış anahtarla bağlanan agent’ın ne yazdığı.

Kayıt Anı: İlk Satır Hata Gibi Görünür

Windows istemcisinde agent açılışta başladı. İki saniye sonra agent log’una (C:\Program Files\Zabbix Agent 2\zabbix_agent2.log) host [ANKMUH01] not found satırı düştü, altı saniye sonra active checks on server are active again satırı. İlk satır bir hata değildir: agent aktif kontrol listesini istediğinde host henüz yoktur, server o isteğin üzerine kaydı açar ve bir sonraki istekte liste gelir. Linux’ta da aynı iki satır altı saniye arayla göründü.

Zabbix Hosts listesi: ANKMUH01 satırı işaretli, 48 item, şablon 'Windows by Zabbix agent active', ZBX yeşil, Agent encryption PSK.
Kimse arayüzden host eklemedi. Satırdaki ad, adres, şablon ve PSK, kayıt eyleminin ve agent'ın birlikte yazdığı değerlerdir.

Data collection → Hosts listesinde host’un satırında üç sütuna bakılır: Templates doğru şablonu, Availability yeşil ZBX simgesini, Agent encryption seçili PSK’yı göstermelidir. ZBX ilk dakikalarda gri kalabilir: lab’da kayıttan bir buçuk dakika sonra hala griydi. Bir dakikayı aşan gri bir agent sorunu değil, aktif agent’ın server’a henüz kendini bildirmediğini gösterir. Kırmızı ise bağlantının koptuğunu söyler.

Zabbix Hosts listesi, üç host: lnx02 satırı işaretli, 57 item, şablon 'Linux by Zabbix agent active', ZBX yeşil, PSK.
Windows ve Linux host'ları aynı ekrandadır ama farklı gruplarda ve farklı şablonlarla. Ayrımı metadata satırı yaptı.

Veri Monitoring → Latest data ekranında okunur. Windows istemcisi 48 item gönderiyordu, biri Not supported durumundaydı. Linux sunucusu 57 item gönderiyordu.

Zabbix Latest data, lnx02: 'Active agent availability' satırı işaretli, değeri 'available (1)', altında bellek ve işlemci item'ları.
Active agent availability item'ı agent'ın server'a düzenli bildirim gönderdiğini söyler. Değer 1 ise bağlantı ayaktadır.

Yanlış PSK Kimliği: İki Taraf da Ne Yazar?

Kimliği yanlış yazılmış bir agent’ın neye benzediğini görmek için Windows istemcisinde TLSPSKIdentity değerini PSK-YANLIS yaptım ve servisi yeniden başlattım. Agent’ın log’u yalnız bağlantının kurulamadığını söyledi: ssl/tls alert handshake failure. Nedeni server’ın log’undaydı:

mon02Çıktı
  2004:20261103:031435.986 cannot find requested PSK identity "PSK-YANLIS"
Zabbix Hosts listesi: ANKMUH01 satırında ZBX simgesi kırmızı ve işaretli.
Yanlış kimlikle bağlanan agent'ın host'u silinmez, ZBX kırmızıya döner. Kırmızı, agent'ın bağlanamadığını söyler, nedenini server log'u söyler.

Arıza aranırken önce server’ın log’una bakılır. Agent yalnız TLS handshake’in başarısız olduğunu bilir, server ise hangi kimliği tanımadığını yazar. Doğru kimlik geri yazılıp servis yeniden başlatıldığında ZBX iki buçuk dakika içinde yeniden yeşildi.

Host Adı: Windows Büyük Harf, Linux Küçük Harf

Yapılandırmada Hostname yazılmadığında agent adı system.hostname item’ından alır. Bu item Windows’ta bilgisayarın NetBIOS adını büyük harfle döndürür. Lab’da agent’ın kendisine sorduğum dört biçim:

Itemankmuh01 (Windows 11)lnx02 (Ubuntu 26.04)
system.hostnameANKMUH01lnx02
system.hostname[host]ankmuh01lnx02
system.hostname[fqdn,lower]ankmuh01.ad.sistemkusu.comlnx02
system.hostname[shorthost]ankmuh01lnx02

Tek domain’li bir kurumda fabrika ayarı yeter: host listesinde Windows makineleri büyük harfle, Linux makineleri küçük harfle görünür ve aynı ad iki kez gelmez. Aynı Zabbix birden fazla domain’i izliyorsa iki domain’de aynı bilgisayar adı olabilir. O zaman MSI’a HOSTNAMEITEM=system.hostname[fqdn,lower] verilir ve ad domain’le birlikte gelir. Zabbix belgesine göre bu özellik MSI’da 7.0.22’den beri var. Lab’da bu yolu kurmadım, yalnız item’ın döndürdüğü değeri ölçtüm.

Kurulum Bitti, İzleme Başlıyor: Yeni Makine Kendiliğinden Gelir

Kurulumun asıl kazancı ertesi günlerde görünür. Muhasebeye yeni bir bilgisayar geldiğinde teknisyen onu domain’e katar ve Bilgisayarlar OU’suna taşır. Bilgisayar ilk yeniden başlatmada GPO’yu alır, betik agent’ı kurar, agent server’a bağlanır ve makine birkaç saniye içinde Windows istemciler grubunda, Windows şablonuyla listededir. Zabbix arayüzünü kimse açmaz.

İzlemeye bakan yönetici her sabah Data collection → Hosts ekranını Windows istemciler grubuyla süzer ve ZBX sütununa bakar. Kırmızı satır, agent’ı çalışmayan ya da ağdan kopmuş bir makinedir. Kurumdan ayrılan bir bilgisayarın host’u kendiliğinden silinmez: o host’u kapatmak ya da silmek yöneticinin işidir.

Sürüm yükseltmesi de aynı yoldan gider: yeni MSI paylaşıma konur ve SYSVOL’daki betikte $Surum satırı değiştirilir. Betik kurulu sürümü bu değerle karşılaştırır ve eskiyse MSI’ı yeniden çalıştırır. Yükseltmeyi lab’da henüz denemedim, ilk yükseltmeyi birkaç makinelik bir test OU’sunda yapın.

Zabbix Agent Kurulumunda Sık Yapılan Hatalar

  1. Agent bağlanıyor ama host listeye düşmüyor. Server log’unda connection type "unencrypted" is not allowed for autoregistration varsa agent’ta PSK ayarı eksiktir. Hiçbir satır yoksa kayıt eylemi tanımlı değildir ya da koşuldaki metadata metni agent’ınkiyle eşleşmiyordur.
  2. msiexec 1603 ile çıkıyor. MSI log’unda Folder [...] does not exist arayın. TLSPSKFILE verilen kurulumda klasörü betik önceden açmalıdır.
  3. Agent log’unda ssl/tls alert handshake failure. PSK kimliği ya da değeri server’dakiyle aynı değil. Hangisi olduğunu server log’undaki cannot find requested PSK identity satırı söyler.
  4. Host listede, veri yok, ZBX gri kalıyor. Sihirbazla kurulan makinede aktif kontrol alanında 127.0.0.1 kalmış olabilir. Ya da kayıt eylemi pasif şablonu bağlamıştır: şablon adının active ile bittiğine bakın.
  5. Bütün Linux makineler aynı adla geliyor. Yapılandırmadaki Hostname=Zabbix server satırı yorum yapılmamış.

Sonuç: Zabbix Agent’ı Dağıtmak Kolay, Anahtarı Saklamak Asıl İş

Zabbix Agent 2’yi bir makineye kurmak yarım dakika sürer, yüz makineye kurmak bir GPO ve bir betik ister. Kurulumu güvenli kılan şey ise anahtarın nerede durduğudur: betikte değil, istemcide herkesin okuyabildiği bir dosyada değil, bir log’da unutulmuş halde değil.

Lab’da beş şey beklenenden farklı çıktı:

  1. MSI sihirbazı 10050’yi her adrese açan bir kural yazıyor ve sihirbazda bunu kapatan bir seçenek yok.
  2. Sihirbazın yazdığı psk.key’i her kullanıcı okuyabiliyor. Sihirbaz izni kısmayı yalnız bir cümleyle öneriyor.
  3. Komut satırıyla kurulum, anahtar dosyasının klasörü yoksa 1603 ile duruyor, aynı değerlerle sihirbaz sorunsuz kuruyor.
  4. MSI’ın ayrıntılı log’u PSK’yı düz metin taşıyor, komut satırı satırı maskeli olsa da.
  5. Linux paketi her makineye Zabbix server adını veriyor.

Girişteki benzetmeye dönersek: uydu vericisi agent, araştırma merkezi Zabbix sunucusudur. Vericinin konumu kendisinin göndermesi aktif kontroldür, merkezin ilk sinyalde kaydı kendiliğinden açması autoregistration’dır. Sinyaldeki tür bilgisi HostMetadata’dır ve kuşun hangi haritaya düşeceğini, yani grubu ve şablonu o belirler. Göç durağında bütün sürüye aynı gün verici takmak GPO ile dağıtımdır. Merkezin kodu ise vericinin kutusuna yazılmaz: PSK SYSVOL’daki betikte değil, yalnız bilgisayarların okuyabildiği paylaşımda durur.

Sırada sunucuların yanına ağ cihazlarını eklemek var. Switch ve firewall agent almaz, Zabbix’e SNMP ile bağlanır. İzlemenin bir hizmet olarak nasıl yürüdüğünü network izleme hizmeti sayfamızda anlattık.

Zabbix Agent Hakkında Sık Sorulan Sorular

Hayır. Agent bir işletim sisteminin içini ölçer: işlemci, bellek, disk, servisler ve event log. Bu yüzden Windows ve Linux makinelere kurulur. Switch, firewall, yazıcı ve UPS agent almaz, onlar SNMP ile izlenir. Lab'da agent Windows 11 istemcisinde 48, Ubuntu sunucusunda 57 item topladı. Kurumda önce sunuculardan başlanır, istemciler izlemenin amacına göre eklenir.
İki port var ve yönleri farklı. Pasif kontrolde server agent'ın 10050 portuna bağlanır. Aktif kontrolde agent server'ın 10051 portuna bağlanır. Aktif kontrolle kurulan agent'a dışarıdan bağlantı gelmez, bu yüzden istemcide gelen bağlantı kuralı açmak gerekmez. Windows MSI sihirbazı yine de 10050'yi her adrese açan bir kural yazar. Komut satırında SKIP=fw verilirse bu kural yazılmaz.
Yöneticinin işi bir kez yapılır: paylaşımı, betiği ve GPO'yu hazırlamak bir iki saattir. Sonra her bilgisayar bir sonraki açılışında agent'ı kendisi kurar. Lab'daki istemcide makinenin açılmasından agent'ın çalışmasına kadar bir dakika geçmedi, agent server'a bağlandıktan sonra host'un listeye düşmesi birkaç saniye sürdü. Asıl bekleme bilgisayarların yeniden başlatılmasıdır: sabah açılan makine o gün listededir.
PSK'yı bilen biri Zabbix'e kendi makinesini host olarak kaydettirebilir ve kayıtlı bir makine adına sahte veri gönderebilir, çünkü autoregistration ile gelen bütün host'lar aynı kimliği ve aynı anahtarı taşır. Kurtarmak için yeni bir anahtar üretilir, Autoregistration ekranında ve host'larda değiştirilir, istemcilerdeki psk.key dosyası yenilenir. Bu yazıdaki betik kurulu makinede kurulumu atladığı için anahtar değişimi ayrı bir tur ister. Bu yüzden anahtar betiğe değil, yalnız bilgisayar hesaplarının okuyabildiği paylaşıma konur.
İlker Pehlivan
Yazan

BT Danışmanı | Ağ, Sistem ve Güvenlik Yönetimi

İlker Pehlivan, karmaşık BT altyapılarını ölçeklenebilir ve güvenli sistemlere dönüştürür. Buradaki rehberleri kendi laboratuvarında kurup ölçerek yazar.

LinkedIn

Benzer Makaleler

Zabbix Rehberi: Kurulumdan Alarma Adım Adım İzleme

Zabbix rehberi: kurulumdan agent'a, template'ten alarma ve dashboard'a on üç adımlık sıra. Her adım hangi kurumda gerekir, lab'da hangi yazıda ölçüldü.

15 dk okuma

Network İzleme Hizmeti: Sunucu, Hat ve Ağ Cihazları

Network izleme hizmeti: sunucu, internet hattı, switch ve firewall dakika dakika izlenir, alarm geldiğinde aynı ekip müdahale eder. Kapsam, süreç ve fiyat.

9 dk okuma

Zabbix 8.0 Upgrade: 7.0 LTS'den Yedekli Geçiş

Zabbix 7.0 LTS'den 8.0'a güncelleme adım adım: sürüm notları, veritabanı ve dosya yedeği, geri yükleme provası, depo paketi, otomatik veritabanı yükseltmesi ve kontrol.

18 dk okuma

Zabbix Health Check: Kuyruk, Poller ve Housekeeper

Zabbix health check lab ölçümüyle: sağlık panosu, queue, poller doluluğu, önbellek ve housekeeper. Agent, poller ve server durunca ne görünür?

16 dk okuma

Zabbix Dashboard: Widget, Network Map ve NOC Ekranı

Zabbix dashboard tasarımı: hangi widget neyi söyler, network map, Host navigator ile ayrıntı sayfası, slideshow ve kiosk, arıza anında ölçülen gecikmeler.

23 dk okuma

Zabbix Proxy: Şube İzleme, Kurulum ve Hat Kopukluğu

Zabbix proxy kurulumu: şubede ne zaman gerekir, aktif proxy, PSK ve agent ayarı, hat koptuğunda ölçülen davranış: yerel tampon, geç gelen veri ve alarm.

26 dk okuma