Omnissa Horizon 8 Agent Üzerinde Debug Log’larını Aktifleştirmek

EUC (End-User Computing) ve VDI (Virtual Desktop Infrastructure) çözümleriyle çalışırken sistem yöneticileri ve destek profesyonelleri genellikle ajan bağlantı ve performans sorunlarını gidermek zorunda kalırlar. Bu tür sorunları etkili bir şekilde teşhis edebilmek için DEBUG seviyesinde günlüklerin kaydedilmesi gereklidir. Ancak varsayılan olarak DEBUG seviyesi etkin değildir ve manuel olarak açılması gerekmektedir.

Bu makalemde VMware Horizon Agent üzerinde DEBUG günlüğünü etkinleştirmek için gereken adımları ayrıntılı olarak ele alacağız.

VMware Horizon Agent Kurulum Araçları Dizinine Erişmek

İlk olarak, VMware Horizon Agent kurulum dizinine giderek, sorun gidermede kullanılan Diagnostic and Cleanup Tool (DCT) aracına erişmemiz gerekmektedir. Bu dizin, günlük yapılandırma araçları da dahil olmak üzere birçok yardımcı program içerir.

1. Horizon Agent DCT Dizinine Gitmek İçin:

Windows Komut İstemi (CMD) veya PowerShell’i yönetici olarak açarak aşağıdaki dizine gidin:

C:\Program Files\VMware\HorizonAgents\DCT>

Bu dizin içerisinde bulunan support.bat dosyası, günlükleme seviyelerini yönetmek için kullanılacaktır.

2. Kullanılabilir Log Seviyelerini Görüntülemek:

DEBUG seviyesine geçmeden önce, mevcut günlükleme seviyelerini doğrulamak faydalı olacaktır. Bunun için support.bat komut dosyasını çalıştırarak hangi seviyelerin mevcut olduğunu kontrol edebiliriz.

Log seviyesini görütülemek için aşağıdaki komutu kullanabilirsiniz.

support.bat loglevels

Bu komutu çalıştırdığınızda Omnissa Horizon Agent tarafından desteklenen mevcut günlükleme seviyeleri listelenecektir.

1. ALL
2. Virtual Chanell 
3. Agent Core 
4. Blast
5. PCoIP
6. VDPService
7. Remote Features 
0. Reset to installation defaults

Bu çıktıda DEBUG seviyesinin 2 numaralı seçenek olarak sunulduğunu görebiliriz.

1. INFO
2. DEBUG
3. TRACE
4. VERBOSE

3. DEBUG Log Seviyesini Etkinleştirmek için;

Mevcut günlükleme seviyelerini görüntüledikten sonra, hata ayıklama amacıyla en uygun seviye olan DEBUG seviyesini seçmemiz gerekmektedir.

Günlük seviyeleri listesini gördükten sonra, ilgili seçeneğin numarasını (örneğin 2) girerek DEBUG seviyesini etkinleştiriniz.

4. Log Paketini (Log Bundle) Oluşturmak

DEBUG seviyesinde logları etkinleştirdikten sonra sorunun analiz edilmesine yardımcı olması için bir log paketinin (log bundle) oluşturulması gerekir. Bu loglar sıkıştırılmış bir ZIP dosyası olarak Windows Masaüstüne kaydedilir.

support.bat

Bu komut çalıştırıldığında Omnissa Horizon Agent tarafından kaydedilen loglar otomatik olarak toplanır ve sisteminizin masaüstüne bir ZIP dosyası halinde kaydedilir.

Log dosyaları oluşturulduktan sonra bunları analiz ederek sorunları teşhis edebilirsiniz. Log dosyaları genellikle şu tür hataları ve uyarıları içerebilir:

• Bağlantı sorunları (Horizon Agent’ın Connection Server’a bağlanamaması)
• Performans sorunları (Yavaş oturum açma, yüksek CPU/RAM kullanımı)
• Ağ hataları (Ağ gecikmesi veya kopmalar)
• Kimlik doğrulama problemleri (Active Directory veya SAML hataları)

Bu logları incelemek için bir metin düzenleyici (Notepad++, VS Code gibi) kullanabilir.