vSAN Performance Service: Stats Object Hatası & Çözümü

1. Sorun Tanımı

vSAN Performance Service, vSphere ortamlarında cluster genelinde performans metriklerinin toplanması ve görselleştirilmesi için kullanılan kritik bir bileşendir. Bu servis düzgün çalışmadığında aşağıdaki belirtiler ortaya çıkar:

• Stats object health alanı boş (--) görünür
• Stats object UUID atanmamış
• Stats object storage policy bağlı değil
• Compliance status doğrulanamıyor
• “Failed to extract performance charts data” hatası alınır
• “vSAN Performance Service is disabled on this cluster” uyarısı çıkar

İlginç olan nokta şudur: Servis arayüzde Enabled görünmesine rağmen gerçekte çalışmıyor olabilir. Bu durum genellikle vSAN Stats DB objesinin hiç oluşturulmamış ya da bozulmuş olmasından kaynaklanmaktadır.

2. Olası Nedenler

• vSAN datastore mevcut değil veya erişilemiyor
• vSAN disk group’ları claim edilmemiş
• Stats DB objesi hiç oluşturulmamış (yeni cluster kurulumu)
• Stats DB objesi bozulmuş veya silinmiş
• Performance Service UI toggle’ı (Disable/Enable) sorunu çözmüyor

⚠️ Disable → Enable toggle işlemi stats objesini otomatik oluşturmadığı durumlarda aşağıdaki RVC yöntemi kullanılmalıdır.

3. Çözüm: RVC ile Stats Objesi Yeniden Oluşturma

Bu makalede çözüm, VMware Remote Console (RVC) aracı kullanılarak vSphere 7.x ortamında gerçekleştirilmiştir. RVC, VCSA bünyesinde gömülü olarak gelen Ruby tabanlı bir komut satırı arayüzüdür.

3.1 vCenter Appliance’a SSH Bağlantısı

vCenter Server Appliance’a (VCSA) root hesabıyla SSH ile bağlanın:

ssh root@<vcenter_ip_adresi>

3.2 RVC’yi Başlatma

Bağlantı kurulduktan sonra RVC aracını başlatın:

rvc [email protected]@localhost

Şifre sorulduğunda vCenter yönetici şifrenizi girin. Başarılı girişin ardından komut istemi rvc > şekline dönüşür.

⚠️ vSphere 7.x ve 8.x ortamlarında RVC başlatıldığında [DEPRECATED] RVC will be deprecated. It will not be available in the next major release. uyarısı görünebilir. Bu uyarı işlemi engellemez, güvenle devam edilebilir.

3.3 Cluster Path’inin Belirlenmesi

Cluster’ın RVC içindeki tam yolunu bulmak için:

ls
ls localhost/
ls localhost/<datacenter_adı>/computers/

3.4 Stats Objesinin Silinmesi ve Yeniden Oluşturulması

Önce mevcut stats objesini silmeye çalışın. Obje yoksa “Didn’t find any existing stats object” mesajı gelir — bu normaldir. Ardından yeni objeyi oluşturun:

> vsan.perf.stats_object_delete localhost/<datacenter>/computers/<cluster>/
Didn't find any existing stats object

> vsan.perf.stats_object_create localhost/<datacenter>/computers/<cluster>/
Creating vSAN Stats DB object, which will enable vSAN Performance Service ...
Task: Enable vSAN performance service
New progress: 1%
Task result: success

⚠️ “Didn’t find any existing stats object” bir hata değildir; stats objesinin daha önce hiç oluşturulmadığını gösterir.

4. Doğrulama

RVC’den çıktıktan sonra vCenter arayüzünden durumu doğrulayın:

• Cluster → Configure → vSAN → Services → Performance Service bölümüne gidin
• Stats object health alanının dolu geldiğini kontrol edin
• Stats object UUID’nin atandığını doğrulayın
• Storage policy’nin bağlandığını ve Compliance status’ün OK olduğunu teyit edin
• Cluster → Monitor → vSAN → Performance altında grafiklerin geldiğini kontrol edin

5. RVC Versiyon Desteği ve Alternatifler

Bu çözümde kullanılan RVC (Ruby vSphere Console), vSphere’in tüm versiyonlarında desteklenmemektedir. Ortamınızın versiyonuna göre aşağıdaki tabloyu referans alabilirsiniz:

5.1 vSphere 7.x — Bu Makaledeki Senaryo

Bu makalede kullanılan ortam vSphere 7.x’tir. RVC, VCSA üzerinde fiziksel olarak mevcuttur ve çalışmaktadır. Başlatıldığında deprecated uyarısı görünse de tüm vsan.perf.* komutları sorunsuz çalışır.

✅ vSphere 7.x: RVC ile stats_object_create komutu başarıyla çalışır.

5.2 vSphere 8.x — Hâlâ Kullanılabilir

vSphere 8.x ortamlarında RVC hâlâ VCSA bünyesinde gömülüdür ve aynı komutlarla kullanılabilir. Ancak Broadcom, resmi olarak RVC’yi deprecated ilan etmiştir. Başlatma sırasında şu uyarı görünür:

[DEPRECATED] RVC will be deprecated.
It will not be available in the next major release.

Bu uyarıya rağmen vSphere 8.x’te aynı adımlar uygulanabilir. Broadcom’un kendi KB makaleleri de vSphere 8.x için RVC komutlarını hâlâ referans göstermektedir.

ℹ️ vSphere 8.x için uzun vadeli çözüm olarak PowerCLI tercih edilmesi önerilir.

5.3 vSphere 9.x / VCF 9 — RVC Kaldırıldı

vSphere 9.0 ve VCF 9 ile birlikte RVC, VCSA’dan tamamen kaldırılmıştır. Bu versiyonlarda aynı işlem PowerCLI ile gerçekleştirilmelidir:

# PowerCLI ile vCenter'a bağlan
Connect-VIServer -Server <vcenter_ip> -User [email protected] -Password <sifre>

# vSAN Performance Service API nesnesini al
$cluster = Get-Cluster -Name "<cluster_adi>"
$vsanPerf = Get-VsanView -Id "VsanPerformanceManager-vsan-performance-manager"

# Stats objesini yeniden oluştur
$vsanPerf.VsanPerfCreateStatsObjectTask($cluster.ExtensionData.MoRef, $null)

❌ vSphere 9.x / VCF 9: rvc komutu bulunamaz. PowerCLI veya vCenter UI kullanılmalıdır.

5.4 Tüm Versiyonlarda Çalışan Yöntem: vCenter UI

Cluster → Configure → vSAN → Services → Performance Service → EDIT ekranından “Recreate stats object” seçeneği tüm desteklenen vSphere versiyonlarında mevcuttur. Eğer bu seçenek çalışmazsa (toggle sonuç vermiyorsa), yukarıdaki CLI yöntemine başvurulmalıdır.

6. Özet

vSAN Performance Service, UI üzerinde Enabled görünmesine rağmen Stats DB objesi eksikse çalışmaz. Bu durumda Disable/Enable toggle’ı sorunu çözmez; stats objesinin elle oluşturulması gerekir.

• vSphere 6.x – 8.x: RVC aracı ile vsan.perf.stats_object_create komutu
• vSphere 9.x / VCF 9: RVC kaldırıldı, PowerCLI veya vCenter UI kullanılmalı
• Tüm versiyonlarda: UI üzerinden “Recreate stats object” seçeneği denenebilir

ℹ️ Bu makaledeki örnek vSphere 7.x ortamında test edilmiş ve başarıyla uygulanmıştır.

Bu makale gerçek bir production ortamında karşılaşılan sorun ve uygulanan çözüm esas alınarak hazırlanmıştır.