vSphere cluster'da HA agent unreachable, vCenter'ın bir ESXi host üzerindeki High Availability bileşenine ulaşamadığını bildirir. Uyarı tek başına host kapandı demez. Çoğu zaman management ağında gecikme, heartbeat kaybı, datastore erişimi veya host agent yeniden başlatması bir araya gelir. İlk iş bu durumu host isolation response ile basit disconnected alarmından ayırmaktır. Bu rehber MOAT troubleshoot akışında agent unreachable için kontrol sırasını verir. Leon-X VMware ürünlerinin üreticisi değildir. Adımlar Broadcom bilgi bankası ve kendi olay kayıtlarınızla doğrulanmalıdır.
Metin VMware çözümleri sayfasını destekler. HA mimarisini vSphere HA rehberinde, yönetim ağını management network down yazısında ele aldık.
Hızlı Özet
- Agent unreachable, HA katmanının host ile konuşamamasıdır. VM'ler çalışıyor olabilir, ancak cluster HA kararları gecikebilir.
- Host isolation yalnızca management heartbeat kaybı değildir. Datastore heartbeat ve izolasyon eşiği ayarları sonucu değiştirir.
- vCenter bağlantısı kopukken out-of-band erişim host canlılığını ayırmanın en güvenilir yoludur.
- Aynı dakikada switch bakımı, VLAN değişikliği veya DNS güncellemesi varsa önce change kaydına bakın.
- HA agent servisini yeniden başlatmadan önce heartbeat ve datastore ping sonucunu kaydedin.
- Yeniden bağlantı veya host reboot, isolation yanlış pozitifinde VM restart tetikleyebilir.
İçindekiler
- Agent unreachable neyi ifade eder
- Host isolation ile agent kaybı ayrımı
- İlk on dakikada kayıt
- Management heartbeat katmanı
- Datastore heartbeat ve ping
- Agent ve yönetim servisleri
- Güvenli müdahale sırası
- Kontrol listesi
- Leon-X ile sonraki adım
- Sık sorulan sorular
- Sonuç
- Kaynaklar

Görsel, veri merkezi rafında sunucu arka paneli ve ağ bağlantılarını gösterir. Kaynak Wikimedia Commons, Rear of rack at NERSC data center - closeup. Fotoğraf Derrick Coetzee tarafından CC0 lisansıyla yayımlanmıştır.
Agent unreachable neyi ifade eder
vCenter, her hostta çalışan vSphere HA agent ile düzenli iletişim kurar. Bu agent cluster üyeliğini, yedek devreye alma hazırlığını ve host sağlık sinyallerini taşır. Unreachable durumu bu kanalın kesildiğini söyler.
Alarm tablosunda agent unreachable ile host disconnected veya connection lost birlikte görülebilir. Summary sekmesindeki HA durumu ile Host sekmesindeki bağlantı durumu ayrı okunmalıdır. Agent uyarısı varken host yeşil görünüyorsa sorun çoğu kez yönetim yolu veya agent sürecindedir.
| Belirti | Agent unreachable | Host gerçekten down |
|---|---|---|
| Out-of-band erişim | Çoğu zaman açık | Genelde yok veya PSOD |
| VM power state | Çalışmaya devam eder | Durmuş veya bilinmiyor |
| Cluster HA | Karar gecikmesi riski | Yedek host devreye girer |
| vCenter task akışı | vpxa veya bağlantı hatası | Host ping yanıt vermez |
Host disconnected rehberi yönetim bağlantısı kaybına odaklanır. Agent unreachable onu HA katmanı üzerinden tamamlar.
Host isolation ile agent kaybı ayrımı
Host isolation, ESXi'nin cluster'daki diğer hostları management ağı üzerinden göremediği ve datastore heartbeat ile de canlılığını kanıtlayamadığı durumdur. İzolasyon tetiklendiğinde host isolation response ayarı VM'lerin ne yapacağını belirler.
Agent unreachable ise vCenter ile host arasındaki HA kontrol kanalının kopmasıdır. İkisi aynı root cause'tan çıkabilir ancak aynı şey değildir. Management ağı kısa süreli titrediğinde önce agent uyarısı gelir, izolasyon birkaç heartbeat döngüsü sonra düşebilir.
Datastore heartbeat için seçilen paylaşımlı datastore erişilemezse host yanlış izole edilebilir. Paylaşımlı depolama yolu kapanınca HA kararları da etkilenir.
Isolation response değerleri cluster düzeyinde kayıtlıdır. Yanlış pozitifte agresif restart politikası üretim kesintisini büyütür. Olay sırasında mevcut response değerini not edin, değiştirmeden önce change onayı alın.
İlk on dakikada kayıt
Müdahaleye geçmeden tek olay kaydına şunları yazın.
- Uyarının tam saati, etkilenen host ve cluster adı
- Son 60 dakikada switch, firewall, VLAN, DNS veya vCenter güncellemesi
- Aynı cluster'da başka hostta eşzamanlı HA veya network alarmı
- Host summary ekranındaki bağlantı durumu ve HA agent satırı
- Paylaşımlı heartbeat datastore'un mount durumu
Bu kayıt reboot mu yoksa ağ düzeltmesi mi gerektiğine karar verir. Paralel reconnect denemeleri birden fazla hostta agent yenilemesi üretir.
Management heartbeat katmanı
HA, hostlar arası management trafiğini izler. Management vmkernel veya yönetim VLAN'ı kesilirse heartbeat düşer. Agent unreachable çoğu kez bu katmanda başlar.
Kontrol sırası şöyledir.
- Host management IP'sine vCenter sunucusundan ve komşu hosttan erişim testi yapın.
- Management port grubu ve vmkernel etiketini doğrulayın. Yanlış VLAN etiketi heartbeat'i sessizce kırar.
- Upstream switch portunda error counter veya flap var mı bakın.
- Management network down belirtileri örtüşüyorsa önce fiziksel ve VLAN yolunu kapatın.
DNS ve NTP sapması doğrudan agent unreachable yazmaz ancak vCenter yeniden bağlantısını geciktirir. Host saati ile vCenter saati farklıysa kimlik doğrulama ve oturum katmanında ikincil hatalar görülür.
Datastore heartbeat ve ping
Management yolu şüpheliyken datastore heartbeat host izolasyon kararını dengeler. Cluster'da seçilen heartbeat datastore'lara tüm hostlar erişemiyorsa izolasyon eşiği yanlış tetiklenir.
- Host üzerinde heartbeat datastore mount durumunu okuyun.
- Datastore kapasite ve erişim alarmı var mı cluster genelinde tarayın.
- ESXi host connection lost ile eşzamanlıysa depolama yolunu önce düzeltin.
- Heartbeat datastore değişikliği planlıysa bakım penceresinde isolation riskini change notuna ekleyin.
Datastore ping başarısız ve management kopuk birlikteyse host isolation response devreye girmeden önce agent unreachable sürekli yenilenir.
Agent ve yönetim servisleri
vpxa ve hostd süreçleri vCenter ile host arasındaki yönetim köprüsünü taşır. HA agent bu katmana dayanır. Süreç kilitlenmesi veya bellek baskısı unreachable uyarısı üretebilir.
- Host üzerinde vpxa ve hostd servis durumunu kontrol edin.
- Aynı hostta CPU ready veya bellek swap spike var mı inceleyin. Host not responding rehberi kaynak baskısı ayrımına yardım eder.
- vCenter tarafında host reconnect görevi hata kodu veriyorsa metni olay kaydına kopyalayın.
- Agent servisini yeniden başlatma ancak heartbeat ve datastore ping sonuçları kayıt altındaysa ve VM etkisi değerlendirildiyse planlanır.
Kimlik doğrulama yenilemesi veya thumbprint değişimi sonrası agent unreachable dalgası görülebilir. Change kaydındaki kimlik adımı ile alarm zamanını eşleştirin.
Güvenli müdahale sırası
- Out-of-band ile host canlılığını doğrulayın. VM'ler çalışıyorsa acele reboot yapmayın.
- Management ağı ve switch yolunu düzeltin. Çoğu unreachable bu adımdan sonra kendiliğinden temizlenir.
- Heartbeat datastore erişimini geri getirin.
- vCenter'da host için tek reconnect denemesi yapın ve görev sonucunu izleyin.
- Hata sürerse agent ve yönetim servislerini kontrollü yeniden başlatın. Aynı anda cluster'daki diğer hostlara toplu restart uygulamayın.
- Isolation gerçekten doğrulandıysa host isolation response politikasına göre VM taşıma veya kapatma adımlarını change runbook'unuzdan çalıştırın.
HA devre dışı veya admission control kısıtı varken yedek devreye alma beklenenden yavaş olabilir. Agent uyarısı ile acil taşıma ihtiyacını karıştırmayın.
Kontrol listesi
- Uyarı zamanı, host ve cluster olay kaydına yazıldı.
- Out-of-band erişim ile host canlılığı ayrıldı.
- Management IP, VLAN ve switch portu kontrol edildi.
- Heartbeat datastore mount ve erişim doğrulandı.
- Eşzamanlı change kaydı taranıp eşleştirildi.
- Tek reconnect denemesi sonucu kaydedildi.
- Gereksiz host reboot yapılmadı.
- Isolation response değeri ve sonraki adım onaylandı.
Leon-X ile sonraki adım
Leon-X, agent unreachable olaylarında management ağı, heartbeat datastore ve HA politikası kayıtlarını tek olay şablonunda toplar. Runbook'a heartbeat eşiği ve change penceresi kontrolleri eklemenize yardım eder. Hypervisor sahipliği müşteri ve üreticide kalır. Keşif için VMware çözümleri ve VMware kurulum hizmetine bakabilirsiniz. Sorularınız için iletişime geçin.
Sık sorulan sorular
Agent unreachable görünce hemen yedek devreye alma beklenir mi?
Hayır. Uyarı çoğu kez yönetim yolu veya agent sürecindedir. VM'ler çalışıyorsa önce heartbeat ve datastore ping sonucunu okuyun.
Host isolation ile agent unreachable aynı mı?
Hayır. Isolation cluster üyeliği ve heartbeat kaybına dayalı bir karardır. Agent unreachable vCenter ile HA kanalının kopmasıdır. İkisi birlikte görülebilir ancak aynı tanı değildir.
Reconnect denemesi güvenli mi?
Tek deneme ve görev izleme çoğu ortam için yeterlidir. Paralel reconnect veya reboot isolation yanlış pozitifinde VM restart riskini artırır.
Heartbeat datastore değişince ne olur?
Yanlış veya erişilemeyen datastore seçimi izolasyon kararını bozar. Değişiklikten önce tüm hostların mount durumunu doğrulayın.
Sonuç
HA agent unreachable uyarısını host kapandı sanmadan önce management heartbeat, datastore ping ve agent süreçlerini sırayla doğrulayın. Out-of-band erişim host canlılığını ayırır. Ağ yolunu düzelttikten sonra tek reconnect deneyin. Servis yeniden başlatma ve reboot adımlarını yalnızca kayıt altında ve change onayı ile planlayın. Cluster HA politikanızı vSphere HA rehberi ile birlikte gözden geçirmek tekrarlayan uyarıları azaltır. Sanallaştırma ortamınız için VMware çözümleri sayfasından hizmet kapsamına bakabilirsiniz.
Kaynaklar
- Broadcom vSphere Availability dokümantasyonu, host isolation ve datastore heartbeat
- Broadcom Knowledge Base, vCenter ile host bağlantı ve agent sorun giderme
- Leon-X, VMware çözümleri


