Siber Güvenlik

Wazuh Health Check: Servis, Indexer ve Kopan Agent

Wazuh health check: wazuh-control status, indexer kümesinin rengi, Filebeat, disk, kopan agent alarmı ve e-posta eşiği, günlük ve haftalık liste, lab ölçümüyle.

İlker Pehlivan

Wazuh health check (sağlık kontrolü), Wazuh’un kendi parçalarının çalıştığını düzenli olarak doğrulamaktır: server’ın servisleri, indexer kümesi, alarmları indexer’a taşıyan Filebeat, disk ve agent’ların bağlantısı. Wazuh başka makinelerin olaylarını izler, ama kendisi bozulduğunda bunu çoğu zaman kimseye haber vermez. Bozuk bir Wazuh’un ekranı da sakin bir günün ekranı gibi görünür: alarm yok.

Bu yazı Wazuh rehberimizin on üçüncü adımıdır. Lab’da önce Wazuh’un parçalarını tek tek ölçtüm: servis listesinde neyin normalde kapalı durduğunu, indexer kümesinin rengini ve diski, Filebeat’in indexer’a ulaşıp ulaşmadığını, server log’unda biriken uyarıları ve atılan olay sayısını. Sonra bir agent’ı iki yoldan kopardım. Önce servisini düzgün durdurdum, sonra makineyi haber vermeden dondurdum. İki kopmanın ne zaman göründüğünü ve hangi alarmı ürettiğini ölçtüm. Son olarak server’ı üç dakika durdurdum ve o sırada agent’ta oluşan olayların kaybolup kaybolmadığına baktım.

Rehberde agent’ı abonedeki akıllı sayaca, server’ı da arıza merkezine benzettik. Akıllı sayaç merkeze yalnız arıza olunca yazmaz, her birkaç saniyede bir “buradayım” der. Sinyal belli bir süre gelmezse merkez o sayacı kopuk sayar. Elektrikçi sayacı sökerken merkeze haber verirse kayıt hemen düşer. Sayaç sessizce susarsa merkez bunu ancak süre dolunca fark eder.

Merkezin kendi binası da bakım ister. Kayıt dolabı dolarsa yeni ihbarı yazacak yer kalmaz. Telsiz bozulursa sokaklardan haber gelmez. İkisinde de merkezin ekranı sakin görünür, çünkü ihbar gelmiyordur. Sessiz sokak her zaman huzurlu sokak değildir. Bu yüzden nöbeti devralan görevli ilk iş merkezin kendisine bakar.

Wazuh’ta “buradayım” sinyali agent’ın keepalive mesajıdır, kopuk sayaç Disconnected durumudur. Kayıt dolabı indexer’ın diskidir, telsiz de alarmları indexer’a taşıyan Filebeat. Nöbet başındaki bakış ise bu yazının sonundaki günlük listedir.

Gravür üslubunda bir arıza merkezinin bürosu. Solda duvardaki ahşap panoda bir sıra yuvarlak lamba var, biri sönük. Hırkalı bir kadın görevli eliyle sönük lambayı gösteriyor. Ortadaki masanın üstünde pirinç bir telsiz duruyor. Sağda ahşap bir dosya dolabının alt çekmecesi açık ve kağıtla dolup taşıyor. Dolabın yanında yelekli bir görevli paltosunu giyiyor.
Sönük lamba sinyali kesilen sayaçtır, Wazuh'ta keepalive göndermeyen ve Disconnected görünen agent. Taşan çekmece dolan indexer diskini, masadaki telsiz de alarmları indexer'a taşıyan Filebeat'i gösterir. Nöbeti devralan görevli işe merkezin kendisinden başlar.

Bu makale Siber Güvenlik ana hizmetimizin güvenlik izleme koluna, özellikle Wazuh’un kendisinin izlenmesine odaklanır. İzlemenin kimin elinde nasıl yürüdüğünü SIEM hizmeti sayfamızda anlattık.

Wazuh Sağlık Kontrolü Nasıl Olmalı?

Önce kısa cevap: iki şeye her gün, beş şeye her hafta bakılır. Her gün kopan agent listesine ve indexer kümesinin rengine bakılır. Her hafta servisler, Filebeat’in bağlantısı, disk, server log’undaki hatalar ve atılan olay sayısı okunur. Kopan agent fabrika ayarında e-posta getirmez, bu yüzden kopma alarmını e-posta eşiğine taşıyan bir özel kural yazılır. Disk, indexer’ın kendi eşiklerinden önce uyarmalıdır.

Bu düzen üç kaynağa dayanıyor:

  • Wazuh belgesi: agent bağlantısı sayfası agent durumlarını ve kontrol araçlarını sayar. Global ayarlar sayfası da server’ın agent’ı son keepalive mesajından kaç dakika sonra kopuk sayacağını yazar: fabrika değeri 15 dakika.
  • OpenSearch belgesi: küme ayarları disk eşiklerini %85, %90 ve %95 olarak verir. %95’te düğümdeki indeksler salt okunur olur, yani yeni alarm yazılmaz.
  • NIST SP 800-53, AU-5: log kaydı sürecinin arızası belirlenen kişiye belirlenen sürede bildirilir. AU-5(1) de storage kapasitesi belirlenen yüzdeye ulaşınca uyarı ister, yani dolmadan önce.
Ne zamanNeye bakılırNerede
Her günKopan agentDashboard’da Endpoints özeti, agent_control -ln
Her günKüme rengi_cluster/health
Her haftaServislerwazuh-control status
Her haftaFilebeatfilebeat test output
Her haftaDiskdf -h, _cat/allocation
Her haftaLog ve atılan olayossec.log, wazuh-analysisd.state
Bir kezKopma alarmının e-postasıÖzel kural (bu yazıda 100160)

Wazuh Servisleri: wazuh-control status

Server’ın kendi süreçlerini wazuh-control listeler:

siem01Bashroot
sudo /var/ossec/bin/wazuh-control status
siem01Bash Çıktısı
wazuh-clusterd not running...
wazuh-modulesd is running...
wazuh-monitord is running...
wazuh-logcollector is running...
wazuh-remoted is running...
wazuh-syscheckd is running...
wazuh-analysisd is running...
wazuh-maild not running...
wazuh-execd is running...
wazuh-db is running...
wazuh-authd is running...
wazuh-agentlessd not running...
wazuh-integratord not running...
wazuh-csyslogd not running...
wazuh-apid is running...

Beş satırın not running olması arıza değildir. Bu süreçler kullanılmayan özelliklere aittir: wazuh-clusterd çok sunuculu kümeye, wazuh-maild e-posta bildirimine, wazuh-integratord dış entegrasyonlara. Lab server’ı tek sunucuydu ve e-posta bildirimi kapalıydı. Belgedeki örnek çıktıda da aynı satırlar not running görünür. Asıl bakılacak olanlar şunlardır:

SüreçDurursa ne olur?
wazuh-remotedAgent’lar server’a bağlanamaz
wazuh-analysisdOlaylar kurallarla eşlenmez, alarm üretilmez
wazuh-dbAgent listesi ve durum sorguları çalışmaz
wazuh-modulesdZafiyet tespiti ve envanter gibi modüller durur
wazuh-apidDashboard server’a ulaşamaz

Aynı liste wazuh-control -j status ile JSON olarak alınır. Bir izleme betiği bunu okuyup running olmayan beklenmedik bir süreçte uyarı verebilir. systemctl status wazuh-manager da servisin ne kadar bellek kullandığını gösterir. Lab’da yeniden başlatmadan beş dakika sonra 1 GB’tı.

Indexer Kümesi: Renk, Shard ve Disk

Indexer’ın sağlığı REST API’sine sorulur. Lab’da sorguları, kurulumun ürettiği admin sertifikasıyla çalışan kısa bir betikle yaptım. Böylece komut satırına parola yazılmaz:

siem01Bash
#!/bin/bash
# siem01'de: ix.sh <yol>  Indexer GET, admin istemci sertifikasi, parolasiz.
sudo curl -s --cert /etc/wazuh-indexer/certs/admin.pem --key /etc/wazuh-indexer/certs/admin-key.pem --cacert /etc/wazuh-indexer/certs/root-ca.pem "https://127.0.0.1:9200/$1"

Kümenin rengi _cluster/health sorgusundadır:

siem01Bash
bash ~/ix.sh "_cluster/health?pretty"
siem01Bash Çıktısı
{
  "cluster_name" : "wazuh-cluster",
  "status" : "green",
  "timed_out" : false,
  "number_of_nodes" : 1,
  "number_of_data_nodes" : 1,
  "discovered_master" : true,
  "discovered_cluster_manager" : true,
  "active_primary_shards" : 35,
  "active_shards" : 35,
  "relocating_shards" : 0,
  "initializing_shards" : 0,
  "unassigned_shards" : 0,
  "delayed_unassigned_shards" : 0,
  "number_of_pending_tasks" : 0,
  "number_of_in_flight_fetch" : 0,
  "task_max_waiting_in_queue_millis" : 0,
  "active_shards_percent_as_number" : 100.0
}

Üç renk üç farklı durumu söyler:

  • Green: bütün shard’lar yerinde.
  • Yellow: asıl shard’lar çalışıyor, en az bir replika yerleşemedi. Tek sunuculu kümede bunun en sık nedeni replika isteyen bir indekstir. Kalıcı çözümünü Wazuh kurulumu yazımızda anlattık.
  • Red: en az bir asıl shard yok. O indekse yazılan ya da o indeksten okunan alarm kaybolur.

unassigned_shards sıfırdan büyükse hangi shard’ın neden yerleşemediğini _cat/shards gösterir. Disk ise _cat/allocation ile okunur:

siem01Bash
bash ~/ix.sh "_cat/allocation?v"
siem01Bash Çıktısı
shards disk.indices disk.used disk.avail disk.total disk.percent host      ip        node
    35       19.3mb    28.9gb     18.9gb     47.8gb           60 127.0.0.1 127.0.0.1 node-1

Bu çıktı önemli bir ayrıntıyı gösterir: indekslerin kendisi 19,3 MB tutuyordu, ama diskin 28,9 GB’ı doluydu. Indexer’ın disk eşiği indekslere değil, bütün diske bakar. Lab’da diski dolduran Wazuh server’ının zafiyet veritabanıydı:

siem01Bashroot
df -h /
siem01Bash Çıktısı
Filesystem      Size  Used Avail Use% Mounted on
/dev/nvme0n1p2   48G   27G   19G  59% /

du aynı anda /var/ossec/queue/vd klasörünü 13 GB, indexer’ın veri klasörünü 26 MB ölçtü. df ve du çıktılarını okumayı Linux disk yönetimi yazısında anlattık. Yani tek sunuculu bir Wazuh’ta indeks büyüklüğüne bakmak yetmez. Disk %85’e ulaşmadan önce uyarı veren bir kontrol gerekir. NIST AU-5(1)‘in istediği de budur: disk dolmadan önce uyarı.

Filebeat: Alarmlar Indexer’a Ulaşıyor mu?

Server alarmı önce kendi diskine, /var/ossec/logs/alerts/alerts.json dosyasına yazar. Filebeat bu dosyayı okur ve indexer’a gönderir. Filebeat durursa alarm server’da üretilmeye devam eder, ama dashboard’a ulaşmaz. Ekranda yalnız alarmların azaldığı görünür.

Filebeat iki komutla sınanır. Biri yapılandırmayı, öteki indexer’a bağlantıyı sınar:

siem01Bashroot
sudo filebeat test config
sudo filebeat test output
siem01Bash Çıktısı
Config OK
elasticsearch: https://127.0.0.1:9200...
  parse url... OK
  connection...
    parse host... OK
    dns lookup... OK
    addresses: 127.0.0.1
    dial up... OK
  TLS...
    security: server's certificate chain verification is enabled
    handshake... OK
    TLS version: TLSv1.2
    dial up... OK
  talk to server... OK
  version: 7.10.2

Her satırın sonunda OK olmalı. handshake satırında hata varsa sertifika, dial up satırında hata varsa indexer’ın kendisi ya da firewall bakılacak yerdir.

Wazuh Agent Disconnected: Kopma Ne Zaman Görünür?

Agent server’a düzenli aralıklarla keepalive mesajı gönderir. Lab agent’ında bu aralık 20 saniyeydi (<notify_time>20</notify_time>). Server, son keepalive’dan agents_disconnection_time kadar süre geçince agent’ı kopuk sayar. Fabrika değeri 15 dakikadır. Kopan agent’lar şöyle listelenir:

siem01Bashroot
sudo /var/ossec/bin/agent_control -ln
siem01Bash Çıktısı

Wazuh agent_control. List of available agents:
   ID: 002, Name: ankmuh01, IP: any, Disconnected
   ID: 003, Name: dc01, IP: any, Disconnected

List of agentless devices:

-lc bağlı agent’ları, -i ile verilen kimlik de tek agent’ın ayrıntısını gösterir. Ayrıntıdaki Last keep alive satırı son keepalive’ın zamanını Unix zaman damgası olarak verir.

Wazuh agent yazısında kurduğumuz lnx02 agent’ını iki farklı yoldan kopardım. Sonuçlar birbirinden çok farklı çıktı:

Servis durdurulduMakine haber vermeden dondu
Ne yapıldı?lnx02’de systemctl stop wazuh-agentlnx02 sanal makinesi duraklatıldı
Disconnected ne zaman?2 saniye içindeSon keepalive’dan 18 dakika sonra
Gelen alarm506, Wazuh agent stopped.504, Wazuh agent disconnected.
Gelmeyen alarm504 (17 dakika beklendi)506
Alarm seviyesi33

Servis durdurulunca agent server’a kapandığını bildirdi. Server agent’ı hemen kopuk saydı ve 506 alarmını üretti. 504 gelmedi. Servis yeniden başlatılınca 503 alarmı (Wazuh agent started.) geldi ve agent yaklaşık 20 saniye içinde Active oldu.

Makine haber vermeden donunca server hiçbir şey duymadı. Agent 18 dakika boyunca listede Active göründü. Sonra 504 alarmı düştü ve durum Disconnected oldu. 504’ün alerts.json kaydında olay satırı ossec: Agent disconnected: 'lnx02-any'., kaynağı wazuh-monitord idi.

Ayar 15 dakikaydı, ölçülen süre 18 dakika. Yani kopma alarmı ayarlanan süreden birkaç dakika sonra da gelebilir. Makine çalışmaya devam edince agent iki saniye içinde bağlantısının koptuğunu fark etti ve aynı saniyede yeniden bağlandı. Kendi log’una şunu yazdı:

lnx02Çıktı
2026/11/14 00:23:15 wazuh-agentd: WARNING: Server unavailable. Setting lock.
2026/11/14 00:23:15 wazuh-agentd: INFO: Closing connection to server ([192.168.1.47]:1514/tcp).
2026/11/14 00:23:15 wazuh-agentd: INFO: Trying to connect to server ([192.168.1.47]:1514/tcp).
2026/11/14 00:23:15 wazuh-agentd: INFO: (4102): Connected to the server ([192.168.1.47]:1514/tcp).
2026/11/14 00:23:15 wazuh-agentd: INFO: Server responded. Releasing lock.

lnx02’nin saati UTC’dir. 00:23 UTC, server saatiyle 03:23’tür.

Bu iki sonuç bir tuzak gösterir. Kopma alarmı yalnız 504’e bağlanırsa, servisi bilerek durdurulan agent hiç alarm üretmez. Saldırganın agent’ı kapatması da bu yoldan gelir. 504’ün MITRE eşlemesi zaten T1562.001, yani savunma araçlarını devre dışı bırakmaktır. Bu yüzden günlük listede yalnız alarma değil, Disconnected listesinin kendisine de bakılır.

Wazuh agent disconnected durumu dashboard'daki Endpoints özetinde: Agents by status grafiğinde Disconnected (3) kırmızı çerçevede, agent listesinde lnx02 satırı Ubuntu 26.04.1, sürüm v4.14.9 ve Status sütununda disconnected olarak kırmızı çerçevede
Servisi durdurulan lnx02 iki saniye içinde disconnected oldu. Haber vermeden donan bir agent ise bu listeye ancak 18 dakika sonra düştü.

Dashboard’da aynı liste Endpoints özetindedir: sol menüde Agents management > Summary. Belgeye göre dashboard ayrıca her 15 dakikada bir bütün agent’ların durumunu wazuh-monitoring indeksine yazar. Geçmişte bir agent’ın ne zaman koptuğu bu indeksten bulunur.

Kopma Alarmını E-posta Eşiğine Taşımak: Kural 100160

504 ve 506 seviye 3’tür. Fabrika ayarında e-posta eşiği (email_alert_level) ise 12’dir. Yani kopan agent, e-posta bildirimi açık olsa bile kimseye e-posta göndermez. Bunu değiştiren, 504’ü seviye 12’ye taşıyan bir özel kuraldır. Özel kuralın yapısını rehberin kural seviyeleri adımında anlattık. Kural server’daki /var/ossec/etc/rules/local_rules.xml dosyasına eklenir:

siem01XML
<group name="local,wazuh_saglik,">
  <rule id="100160" level="12">
    <if_sid>504</if_sid>
    <description>Wazuh agent baglantisi koptu</description>
  </rule>
</group>

if_sid kuralı 504’ün üstüne kurar. 504 düşen her olayda bu kural da çalışır ve seviyesi 12 olur. Kimlik 100000 ve üstündeki boş bir numara olmalıdır. Lab’ın dosyasında 100001’den 100150’ye kadar başka özel kurallar vardı, 100160 boştu. Aynı yapı 506 için de kurulabilir, ama bakım için kapatılan her agent o zaman e-posta getirir. Hangisinin kuruma uyduğu bakım düzenine bağlıdır.

Değişiklik server yeniden başlatılmadan önce sınanır. wazuh-logtest bir olay satırını alır ve hangi kuralın düşeceğini gösterir. Satır olarak 504’ün alerts.json’daki olay satırı verildi:

siem01Bashroot
printf "ossec: Agent disconnected: 'lnx02-any'.\n" | sudo /var/ossec/bin/wazuh-logtest 2>&1
siem01Bash Çıktısı
Starting wazuh-logtest v4.14.9
Type one log per line


**Phase 1: Completed pre-decoding.
	full event: 'ossec: Agent disconnected: 'lnx02-any'.'

**Phase 2: Completed decoding.
	name: 'ossec'

**Phase 3: Completed filtering (rules).
	id: '100160'
	level: '12'
	description: 'Wazuh agent baglantisi koptu'
	groups: '['local', 'wazuh_saglik']'
	firedtimes: '1'
	mail: 'True'
**Alert to be generated.

Olay artık 504 değil 100160 olarak, seviye 12’de düşüyor. mail: 'True' alarmın e-posta eşiğini geçtiğini söyler.

Logtest kuralın düşeceğini gösterir, gerçek bir kopmada düştüğünü göstermez. Fabrika ayarındaki 15 dakikayla tek bir deneme 18 dakika sürüyordu. Kuralın gerçek kopmada düştüğünü görmek için lab’da agents_disconnection_time ayarını geçici olarak 1 dakikaya kısalttım ve lnx02’yi yine duraklattım. 1 dakika canlıda kullanılacak bir değer değildir. Ayar ölçümden hemen sonra yedekten 15 dakikaya geri alındı. Son keepalive’dan 1 dakika 46 saniye sonra alerts.json’a şu kayıt düştü:

siem01Çıktı
{"timestamp":"2026-11-14T03:43:42.707+0300","rule":{"level":12,"description":"Wazuh agent baglantisi koptu","id":"100160","firedtimes":1,"mail":true,"groups":["local","wazuh_saglik"]},"agent":{"id":"001","name":"lnx02","ip":"192.168.1.71"},"manager":{"name":"siem01"},"id":"1794617022.1255152","full_log":"ossec: Agent disconnected: 'lnx02-any'.","decoder":{"name":"ossec"},"location":"wazuh-monitord"}

Olay satırı ve kaynağı 504’ünkiyle aynıdır, ama kayıt seviye 12’de ve "mail":true ile yazıldı. Aynı kopma için ayrıca bir 504 kaydı düşmedi: olay tek alarm olarak, 100160 adıyla geldi. 15 dakikalık ayarda olduğu gibi alarm burada da ayarlanan süreden sonra geldi.

Açıklamaya agent’ın adını $(agent.name) ile eklemek akla gelir. Lab’da denendi: gerçek alarmda da bu alan boş kaldı ve açıklama Wazuh agent baglantisi koptu: olarak yazıldı. Agent’ın adı kaydın agent alanında zaten durur ("name":"lnx02"), bu yüzden açıklama sabit bir metin olarak bırakıldı.

E-postanın gerçekten gitmesi için server’da e-posta bildiriminin açık olması gerekir. Lab’da email_notification no idi. Wazuh’un e-postayı bir relay sunucusu üzerinden göndermesini rehberin e-posta adımında anlattık.

Server Dururken Gelen Olaylar Kaybolur mu?

Server bakım için ya da bir arızada durabilir. Bu sırada agent’ların gördüğü olaylara ne olduğunu ölçmek için lab’da wazuh-manager servisini durdurdum. Sonra lnx02’de 2 saniye arayla 20 sahte SSH satırı ürettim. Satırlar logger ile yazıldı ve var olmayan bir kullanıcının giriş denemesini taklit etti:

lnx02Bash
date +%T; for i in $(seq 1 20); do logger -p auth.info -t sshd "Invalid user saglikdeneme$i from 192.168.1.250 port 4$i"; echo "$(date +%T) satir $i"; sleep 2; done; date +%T

Server dururken dashboard açılmaya devam etti, ama ana sayfa kendiliğinden Server APIs ekranına yönlendi:

Wazuh server durduğunda dashboard'un Server APIs ekranı: The API connections could be down or inaccessible uyarısı, default API satırında Status sütunu Offline ve Updates status sütunu Error checking updates olarak kırmızı çerçevede
wazuh-manager durunca dashboard açıldı, ama API satırı Offline oldu. Alarm ekranları bu sırada yeni olay göstermez.

Agent tarafında bu sırada üç şey görüldü. wazuh-agentd her 10 saniyede bir server’a bağlanmayı denedi. Log okuyan süreç (wazuh-logcollector) Process locked due to agent is offline satırını yazıp bekledi. 20 satır yazıldıktan sonra agent’ın durum dosyasında tampon boştu:

lnx02Bashroot
sudo grep -E "msg_buffer|status|last_" /var/ossec/var/run/wazuh-agentd.state
lnx02Bash Çıktısı
# Agent status:
status='disconnected'
last_keepalive='2026-11-14 00:45:48'
last_ack='2026-11-14 00:45:48'
msg_buffer='0'

Server 3 dakika sonra yeniden başlatıldı. Agent 03:49:00’da bağlandı. İki saniye sonra alerts.json’da saglikdeneme geçen 20 kayıt vardı, yani 20 satırın 20’si de alarm oldu. Kayıtların hepsi 03:49:02’de yazıldı, olay satırları ise kendi saatlerini korudu (ilk satır Nov 14 00:45:52, lnx02’nin UTC saatiyle). 19 satır 5710 (seviye 5) olarak düştü. Sekizinci satır ise 5712 (seviye 10, SSH brute force) olarak düştü. Yani geç gelen olaylar da art arda gelen denemeleri sayan kurala girdi.

Bu denemede olayları agent’ın tamponu tutmadı, çünkü tampon boştu. Lab agent’ında tampon tanımlıydı (<client_buffer> bloğunda queue_size 5000 olay, events_per_second 500). Ama logcollector agent kopukken okumayı bekletti ve bağlantı dönünce satırların hepsi okundu. Ölçülen kesinti 3 dakikaydı. Daha uzun bir kesintide, log dosyası bu arada dönerse ne olduğu ölçülmedi.

Sağlık kontrolü açısından, server’ın durduğu dakikalarda alarm gelmemesi o dakikalarda olay olmadığı anlamına gelmez. Bu denemede alarmlar server dönünce toplu olarak ve aynı saniyede düştü.

Server Log’u ve Kuyruklar: ossec.log ve analysisd.state

Server’ın kendi log’u /var/ossec/logs/ossec.log’dur. Haftalık bakışta önce satır sayısı, sonra hangi modülden geldikleri okunur:

siem01Bashroot
sudo grep -E "ERROR|CRITICAL|WARNING" /var/ossec/logs/ossec.log | awk "{print \$3, \$4}" | sort | uniq -c | sort -rn | head -20
siem01Bash Çıktısı
    266 indexer-connector: WARNING:
     20 wazuh-modulesd:content-updater: WARNING:
      4 wazuh-remoted: WARNING:
      4 wazuh-authd: ERROR:
      4 agent_control: ERROR:
      1 sca: WARNING:
      1 indexer-connector: ERROR:

Lab log’u on günü kapsıyordu ve 291 uyarı, 9 hata taşıyordu. Sayı tek başına bir şey söylemez. 266 uyarı tek modülden, indexer’a veri yazan indexer-connector’dan geliyordu. Log’un son satırlarında bu uyarılar server’ın açılışından hemen sonraki saniyelere toplanmıştı: Failed to sync agent '001': No available server. Server, indexer henüz hazır değilken ona yazmaya çalışmıştı. Haftalık bakışta sorulacak soru şudur: aynı satır açılıştan sonra da tekrar ediyor mu?

Server’ın olay kuyruğunun dolup dolmadığı wazuh-analysisd.state dosyasındadır. Dosya birkaç saniyede bir yeniden yazılır. Bakılacak satır, atılan olay sayısıdır:

siem01Çıktı
# Events received
events_received='2223'

# Events dropped
events_dropped='0'

events_dropped sıfırdan büyükse server gelen olayları işleyemiyor demektir ve atılan olay alarm üretmez. Aynı dosyadaki *_queue_usage satırları kuyrukların doluluk oranını verir. Lab’da hepsi 0.00’dı. Agent’lardan gelen bağlantının karşılığı wazuh-remoted.state dosyasındaki discarded_count satırıdır. Lab’da o da sıfırdı.

Agent tarafının log’u da kopmaları gösterir. lnx02’nin log’unda, server’ın her yeniden başlatılmasında şu satırlar vardı:

lnx02Çıktı
2026/11/13 23:33:35 wazuh-agentd: ERROR: (1137): Lost connection with manager. Setting lock.
2026/11/13 23:33:35 wazuh-agentd: ERROR: (1216): Unable to connect to '[192.168.1.47]:1514/tcp': 'Transport endpoint is not connected'.
2026/11/13 23:33:38 wazuh-logcollector: WARNING: Process locked due to agent is offline. Waiting for connection...

Son satır, agent bağlantısı yokken log okuyan sürecin beklemeye geçtiğini söyler. Bu beklemede olayların kaybolmadığı server’ı durdurduğumuz denemede ölçüldü.

Dashboard’un Sağlık Ekranları

Dashboard’da Wazuh’un kendi durumu iki ekrandadır.

Server management > Status server’ın süreçlerini renkli noktalarla, agent’ları da durumlarına göre sayıyla gösterir. Kırmızı nokta not running demektir. Lab’da altı nokta kırmızıydı, hepsi kullanılmayan özelliklerdi: wazuh-reportd de bu listede görünür. Aynı ekranda Restart manager düğmesi vardır.

Wazuh health check için dashboard'daki Server management Status ekranı: on altı Wazuh sürecinin yeşil ve kırmızı noktalarla listesi kırmızı çerçevede, wazuh-maild ve wazuh-clusterd dahil altı süreç kırmızı, altında Total agents 3, Active 0 ve kırmızı çerçeve içinde Disconnected 3, sürüm v4.14.9
Status ekranı servis listesinin dashboard karşılığıdır. Kırmızı noktalar kullanılmayan özelliklerdir, asıl bakılacak sayı Disconnected.

Dashboard management > Server APIs dashboard’un server’a bağlandığı API’yi gösterir. Lab’da Status Online’dı ve Updates status sütunu yeni bir sürüm olduğunu söylüyordu. Eski rehberlerin anlattığı ayrı bir health check sayfası ise lab’daki 4.14.9 dashboard’unda yoktu: /app/health-check adresi Application Not Found döndü.

Server management > Statistics server’ın aldığı olay ve bayt sayılarını grafikle gösterir. Bu grafikler wazuh-statistics indeksinden gelir.

Günlük ve Haftalık Wazuh Sağlık Listesi

Her gün, iki dakikalık bakış:

  1. Kopan agent: agent_control -ln ya da dashboard’daki Endpoints özeti. Dünden beri yeni bir Disconnected varsa nedeni sorulur. Bakım için kapatılan makine listede de kopuk görünür.
  2. Küme rengi: _cluster/health çıktısında status green olmalı. yellow ise hangi replikanın yerleşmediğine bakılır, red ise o gün çözülür.

Her hafta:

  1. Servisler: wazuh-control status çıktısında wazuh-remoted, wazuh-analysisd, wazuh-db, wazuh-modulesd ve wazuh-apid çalışıyor.
  2. Filebeat: filebeat test output çıktısında her satır OK.
  3. Disk: df -h ile disk %85’in altında. Büyüme haftadan haftaya not edilir, bir sonraki ayın doluluğu tahmin edilir.
  4. Log: ossec.log’da açılış dışında tekrar eden ERROR ve CRITICAL satırı yok.
  5. Kuyruk: wazuh-analysisd.state dosyasında events_dropped sıfır, wazuh-remoted.state dosyasında discarded_count sıfır.

Bir kez:

  1. Kopma alarmı: 504’ü seviye 12’ye taşıyan kural yazılır ve e-postanın gittiği bir kopmayla sınanır.
  2. Dışarıdan izleme: Wazuh server’ı tamamen durursa kendi alarmını da üretemez. Server’ın ayakta olduğunu başka bir sistemin izlemesi gerekir. Bu iş için kurumda çalışan bir izleme sistemi varsa Wazuh server’ı da ona eklenir.

Wazuh Sağlık Kontrolünde Sık Yapılan Hatalar

  • Alarm yok diye her şey yolunda sanmak: Filebeat durursa ya da disk %95’i geçerse dashboard’a yeni alarm gelmez. Ekran sakin görünür.
  • Kopma alarmını yalnız 504’e bağlamak: servisi düzgün durdurulan agent 504 üretmez, 506 üretir. Lab’da 17 dakika boyunca 504 gelmedi.
  • Seviye 3 alarmın e-posta getireceğini sanmak: fabrika e-posta eşiği 12’dir. 504 de 506 da seviye 3’tür.
  • Kopmayı hemen görmeyi beklemek: haber vermeden donan agent lab’da 18 dakika Active göründü.
  • not running satırlarını arıza sanmak: wazuh-maild e-posta kapalıyken, wazuh-clusterd tek sunucuda çalışmaz.
  • Yalnız indeks boyutuna bakmak: lab’da indeksler 19,3 MB, zafiyet veritabanı 13 GB tutuyordu. Disk eşiği bütün diske bakar.
  • Log satır sayısından hüküm vermek: lab log’undaki 291 uyarının 266’sı tek modülün, indexer’a bağlanamayan indexer-connector’ın uyarısıydı.
  • Wazuh’u yalnız Wazuh’la izlemek: server tamamen durunca kendi alarmını da üretemez.

Sonuç: Wazuh Kendini İzlemez, Onu Bir Liste İzler

Wazuh health check, Wazuh’un parçalarına sırayla bakmaktır: servisler, indexer kümesi, Filebeat, disk, log ve agent’lar. Lab’da servisi durdurulan agent iki saniye içinde kopuk göründü ve 506 üretti. Haber vermeden donan agent ise 18 dakika Active kaldı, sonra 504 üretti. İkisi de seviye 3’tü ve fabrika ayarında e-posta getirmiyordu. Diski dolduran indeksler değil, 13 GB’lık zafiyet veritabanıydı.

Girişteki benzetmeye dönersek: sayacını sökerken haber veren elektrikçi hemen kayda geçer, sessizce susan sayaç ise ancak süre dolunca fark edilir. Wazuh’ta haber veren kopma 506’dır, sessiz kopma 18 dakika sonra gelen 504. Kayıt dolabı dolarsa ya da telsiz bozulursa merkezin ekranı sakin görünür. Wazuh’ta kayıt dolabı disk, telsiz Filebeat’tir. Nöbeti devralan görevlinin merkezin kendisine bakması gibi, Wazuh’a da her gün iki, her hafta beş kalemle bakılır.

Rehberin sonraki ve son adımı, Wazuh’un yedeği ve sürüm yükseltmesidir: Wazuh güncellemesi yazımız.

Wazuh Sağlık Kontrolü Hakkında Sık Sorulan Sorular

Verir, ama fabrika ayarında e-posta getirmez. Haber vermeden kopan agent için Wazuh 504 numaralı alarmı üretir. Bu alarm seviye 3'tür, e-posta eşiği ise seviye 12'dir. Lab'da 504, agent'ın son keepalive mesajından 18 dakika sonra geldi. Kopmanın e-postayla gelmesi için 504'ü seviye 12'ye taşıyan bir özel kural yazılır.
Gelmez. Servisi durdurulan agent server'a kapandığını bildirir. Server agent'ı hemen Disconnected yapar ve 506 numaralı alarmı üretir. Lab'da bu durumda 17 dakika boyunca 504 gelmedi. Yani kopma alarmı yalnız 504'e bağlanırsa, birinin bilerek kapattığı agent bu alarmı üretmez.
İki şeye her gün bakılır: kopan agent listesi ve indexer kümesinin rengi. Her hafta servisler, Filebeat'in indexer'a bağlantısı, disk doluluğu, server log'undaki hatalar ve atılan olay sayısı okunur. Kopan agent alarmını e-posta eşiğine taşıyan kural ise bir kez yazılır.
İ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

Wazuh Rehberi: Kurulumdan Alarma Adım Adım SIEM

Wazuh rehberi: kurulumdan agent'a, Windows log'undan e-posta alarmına on dört adımlık sıra. Her adım hangi kurumda gerekir, fabrika ayarı ne, lab'da ne ölçtük.

16 dk okuma

SIEM Hizmeti: Yönetilen Güvenlik İzleme ve Müdahale

SIEM hizmeti: domain controller, firewall, VPN ve sunucu logları tek yerde toplanır, kurallarla okunur, şüpheli olayda aynı ekip müdahale eder. Kapsam ve fiyat.

10 dk okuma

Wazuh Active Response: Otomatik Engelleme ve Muafiyet

Wazuh active response: SSH ve Windows brute force kaynağını firewall-drop ve netsh ile süreli engellemek, white_list ve kural seçimi, lab ölçümüyle.

23 dk okuma

Wazuh Upgrade: Yedek, Sıra ve Agent Yükseltmesi

Wazuh upgrade adım adım: yedeğin içini doğrulamak, indeks snapshot'ı, indexer, manager, Filebeat ve dashboard sırası, kesinti ve eski agent'lar, lab ölçümüyle.

23 dk okuma

Wazuh Active Directory İzleme: DC Olayından Alarma

Wazuh ile Active Directory izleme: domain controller'a agent, hazır Windows kurallarının seviyeleri, kilit zinciri, frekans eşiği ve özel kural, lab ölçümüyle.

22 dk okuma

Wazuh Agent Kurulumu: Windows'a GPO, Linux'a apt

Wazuh agent kurulumu: fabrikada parolasız gelen kaydı parolaya bağlamak, Windows'a GPO başlangıç betiğiyle toplu dağıtım, Linux'a apt ve lab ölçümleri.

29 dk okuma