Hyper-V Reporting Script v1.0

Üzerinde çok sayıda iş yükü barındıran ve giderek karmaşıklaşan kurum içi sanallaştırma yapılarının izlenmesi ortam ölçeği genişledikçe zorlaşır. İşlemci gücü, bellek kapasiteleri, depolama kaynağı, sanal makine kopyaları gibi çeşitli platform bileşenlerinde beklenmedik sorunlar ortaya çıktığında büyümeden anlamak veya sorun oluşmadan hemen önce yakalamak, platform ve servis erişilebilirliğini sürekli kılmak adına oldukça önemlidir. Öte yandan sanallaştırma envanterini çıkartmak, atanmış veya bekleyen kaynak miktarları gibi bilgilere ulaşmak, altyapı yatırımının daha verimli kullanımı ve kapasite planlama hususlarında destek olabilmektedir. Günümüzde bu gibi işleri ve aslında çok daha fazlasını yapmaya aday uygulamalar mevcut. Kimisi düşük maliyetli ama eh işte, kimisi oldukça kapsamlı ancak aradığını bulmak zor, kimisi istenen sonucu veremiyorken kimisi tamam ama gerçekten pahalı, kurması işletmesi meşakkatli… Ama yine de gerekliler çünkü ortamda özellikle geriye dönük raporlama yapabilen, geçmişte yaşanmış olayları ve değerleri kayıt altına alıp bunları gerektiğinde gösterebilen bir izleme uygulaması belirli ölçeğin üzerindeki yapılarda mutlaka çalışıyor olmalı. Ama bazen de izleme uygulamasının sorunlarıyla boğuşmadan, belirli bir bilgiye ulaşmak için menüler/pencereler arasında kaybolmadan hemen o an neler olup bittiğini bir bakışta anlamak istemez miyiz? İşte tam olarak bu fikirle yola çıktım ve “Hyper-V Reporting Script” isimli bir raporlama aracı hazırladım. Windows Powershell tabanlı olan Get-HyperVReport.ps1 tam olarak Hyper-V sanallaştırma ortamlarını raporlamak ve durumun anlık fotoğrafını çekmek üzere kullanabileceğiniz bir araç.

Hyper-V Reporting Script v1.0

Get-HyperVReport.ps1 aracı Clustered veya Standalone durumda çalışan Hyper-V ortamlarını aşağıdaki üçün farklı açıdan hızlı ve kolay bir şekilde raporlar.

• Fiziksel sunucular (node/host)
• Depolama alanları (storage)
• Sanal makineler (vm)

Belirttiğiniz Hyper-V Cluster yapısı veya Standalone Hyper-V sunucu gurubuyla ilgili o anki duruma ait çeşitli bilgileri toplar, topladığı verileri ekrana yazmak yerine in-line CSS ile biçimlendirilmiş ve tüm modern tarayıcılar ile uyumlu bir HTML dosyasına doldurur, disk üzerinde belirtilen alana kayıt eder ve eğer gerekiyor ise SMTP sunucunuza bağlanarak e-posta ile adresinize gönderir. Ayrıca belirli anlarda periyodik olarak çalışmak ve rapor göndermek üzere zamanlanmamayı da destekler. (Windows scheduled tasks)

Get-HyperVReport.ps1 Windows Powershell tabanlıdır ve doğrudan bir Windows Server üzerinde çalıştırılabilir. İlerleyiş aşamalarını ekranda gösterir ve HTML rapor oluştuğunda herhangi bir tarayıcıyla rahatlıkla incelenebilir. HTML raporda yer alan tablo alanları görsel açıdan sade ve aradığınızı hızlıca bulabileceğiniz bir tasarıma sahiptir. Cluster üyesi Hyper-V Node’ların listelendiği örnek bir tablo:

Hyper-V Cluster içerisindeki depolama alanı kaynaklarının raporlandığı örnek bir tablo:

Ortamdaki sanal makinelerin raporlandığı örnek bir tablo:

Öne Çıkanlar

Get-HyperVReport.ps1 1.0 sürümünde altını çizmek istediğim başlıklar aşağıdaki gibi.

• Windows Server 2012 Hyper-V ve Windows Server 2012 R2 Hyper-V ortamlarıyla uyumludur.
• Çalışması için gerekli ön koşulları (runtime environment) kontrol eder ve eğer eksik varsa bazılarını otomatik olarak tamamlar. Tamamlayamadıkları konusunda ise bilgi verir.
• Ortamdaki verileri toplarken standart Powershell cmdlet’lerinin yanı sıra WMI query’leri de kullanır.
• Topladığı verileri düzgün ve okunabilir tablolara yerleştirir, anlamlandırır, gerekiyor ise belirli eşik değerlerine göre renklendirir ve tamamını CSS ile biçimlendirilmiş tek bir HTML dosyasına kayıt eder.
• Tablo hücrelerindeki tüm yıldız karakterli (*) alanlar ile bazı highlighted alanlar üzerine geldiğinizde açılan tooltip içerisinde o durumla ilgili bir miktar daha bilgi sağlanır.
• Doğrudan komut satırından veya zamanlanmış işletim sistemi görevi şeklinde periyodik olarak çalışabilir.
• Oluşan HTML rapor dosyasını diske kayıt edebildiği gibi eğer isterseniz SMTP sunucunuza bağlanıp belirlediğiniz adreslere e-posta olarak da gönderebilir. Üstelik bunu yaparken SMTP authentication veya TLS/SSL gibi gelişmiş yöntemleri de destekler. Bu sayede eğer isterseniz Gmail, Hotmail veya diğer servis sağlayıcıları da e-posta göndermek için kullanabilirsiniz.
• Gerektiğinde rapor dosyası ismini değiştirmenize ve kayıt edileceği dizini belirlemenize izin verir.
• Sahip olduğu HighlightsOnly Mode sayesinde, tüm altyapıyı raporlamak yerine sadece problemli olan kayıtları listeleyebilir. Bu modu aktif eden -HighlightsOnly parametresini kullanarak özellikle çok sayıda sunucu ve sanal makine bulunan ortamlarda uzun raporlar incelemek durumunda kalmadan doğrudan üzerinde uyarı bulunan satırları filtrelemeniz mümkün.

Neleri Raporlayabilir?

Belirttiğiniz Hyper-V ortamından toplanan bilgiler, oluşan HTML tabanlı rapor dosyasında 3 ana tablo altında yer alır.

Hyper-V Sunucular (Clustered veya Standalone)

• Hostname
• İşletim sistemi sürümü
• Durumu (up, down, paused, joined, vs..)
• Açık kalma süresi (Uptime)
• Domain üyeliği
• Toplam sanal makine sayısı ve kapalı/açık oranı
• İşlemci sayısı (mantıksal işlemciler, fiziksel soket ve çekirdekler, hyper-threading durumu)
• Bellek için kapasite bilgileri: kullanılan, müsait ve toplam bellek

Depolama Alanları (Clustered veya Local)

• Volume
  • İsim (Local Volume, Clustered Volume, Cluster Shared Volume)
  • Etiket veya CSV ise path (tooltip olarak)
  • Fiziksel disk ismi (Clustered dahil)
  • Fiziksel disk için toplam, atanmış ve henüz atanmamış depolama alanı miktarları (tooltip olarak)
• Disk/Volume durumu (online, failed, maintenance)
• Kullanım amacı (Logical Partition, Cluster Volume, Cluster Shared Volume, Quorum, System Volume)
• Sahibi
• Fiziksel disk için Bus Type (SAS, iSCSI, FC, vb..)
• Volume için dosya sistemi
• Volume için kapasite bilgileri: kullanılan, müsait ve toplam depolama alanı

Sanal Makineler

• Sanal Makine
  • İsim
  • Yapılandırma dosyasının yer aldığı dizin (XML)
  • Jenerasyon
  • Versiyon
• Durumu (running, off, saved, failed, offline, vb..)
• Açık kalma süresi (Uptime)
• Sahibi
• Atanmış sanal işlemci sayısı
• Atanmış sanal bellek değerleri (startup, minimum, maksimum, assigned)
• Yüklü Integration Services sürümü ve güncellik durumu
• Checkpoint (snapshot) durumu, sayısı ve tüm zincir diskler
• Çoğaltma (Hyper-V Replica) durumu, sağlığı, çoğaltma sıklığı ve çoğaltılan sunucu bilgisi
• Tüm sanal diskler
  • VHD isimleri ve bulundukları dizinler
  • VHD dosya boyutları ve maksimum genişleme değerleri
  • VHD türü
  • Varsa VHD zincir yapısı (differencing)
  • VHD fragmentation oranı
  • Sanal disklerin bağlı olduğu sanal controller türü
  • Pass-through diskler (eğer varsa)
  • Bağlı ama kayıp VHD dosyaları (eğer varsa)
• Clustered sanal makinelerde yaşanabilen offline configuration resource problemlerinin tespiti ve raporlanması
• Clustered sanal makinelerde yaşanabilen failed durumlarının tespiti ve raporlanması

Nasıl Kullanılır?

Get-HyperVReport.ps1’in kullanımı oldukça basit. Öncelikle aşağıdaki ön gereksinimlere göz atın.

Hyper-V Ortamı (Raporlanacak Hyper-V sunucular)

• Clustered veya Standalone olabilir
• Active Directory üyeliği
• Desteklenen Hyper-V Sürümleri
  • Windows Server 2012 Hyper-V
  • Windows Server 2012 R2 Hyper-V
  • Hyper-V Server 2012
  • Hyper-V Server 2012 R2

Script Çalışma Ortamı (Script’in çalışacağı sunucu)

• Bir uzak Windows Server olabileceği gibi doğrudan ortam içerisindeki herhangi bir Hyper-V sunucusu da olabilir
• Hyper-V ile aynı veya güvenilen Active Directory üyeliği
• Desteklenen Windows Server Sürümleri
  • Windows Server 2012
  • Windows Server 2012 R2 (Önerilir)
• Windows PowerShell (Desteklenen Windows Server sürümlerinde varsayılan olarak yüklü gelir)
  • 3.0
  • 4.0 (Önerilir)
• Windows Powershell Execution Policy için RemoteSigned veya Unrestircted ataması (Set-ExecutionPolicy)
• Hyper-V Powershell (Eğer yüklü değilse tespit edilir ve otomatik olarak yüklenir)
• Clustering Powershell (Eğer yüklü değilse tespit edilir ve otomatik olarak yüklenir)
• Hyper-V sunucularında yerel yönetici hakkı. Özellikle WMI query’lerin çalışabilmesi için script’in çalıştırıldığı oturum/hesap, raporlanacak sunucular üzerinde yerel yönetici haklarına sahip olmalı.

Get-HyperVReport.ps1’i indirip bir dizine koyun. Ortamda yetkili hesap ile oturum açın, Powershell aracını başlatın ve script’in bulunduğu dizine geçin.

Komut string’ini oluştururken kullanabileceğiniz parametreler, alabilecekleri değerler ve kullanım örnekleri script dosyası içerisindeki Help bölümünde detaylı olarak yer alıyor. Yine de kısaca bahsetmek gerekirse;

-Cluster Bir Hyper-V Cluster ortamını raporlarken cluster name’i belirtmek için kullanılır.

-VMHost Bir veya birden fazla Standalone Hyper-V sunucusunu raporlarken sunucu isimlerini belirtmek için kullanılır.

-HighlightsOnly Raporda tüm sonuçlara yer vermek yerine sadece üzerinde uyarı olan kaynakları listeler. Özellikle çok sayıda sanal makine ve sunucu bulunan ortamlarda raporu incelemeyi kolaylaştırır. (Opsiyonel)

-ReportFilePath HTML rapor dosyasının kayıt edileceği dizini değiştirmek için kullanılır. (Opsiyonel)

-ReportFileNamePrefix HTML rapor dosyasının isim ön ekini değiştirmek için kullanılır. (Opsiyonel)

-SendMail HTML raporu e-posta şeklinde göndermek için e-posta özelliğini aktif eder.

-SMTPServer E-posta sunucusu adresi. (Eğer -SendMail aktif ise zorunludur)

-SMTPPort E-posta sunucu portu. (Varsayılan olarak 25 değerindedir)

-MailTo E-posta alıcı adresleri. (Eğer -SendMail aktif ise zorunludur ve virgül ile ayrılarak birden fazla adres belirtilebilir)

-MailFrom E-posta gönderici adresi. (Eğer -SendMail aktif ise zorunludur)

-MailFromPassword E-posta gönderici adresi parola bilgisi (Sadece SMTP Authentication gerekliyse kullanılır)

-SMTPServerTLSorSSL E-posta gönderimi için TLS/SSL desteğini aktif eder. (Sadece e-posta sunucusu tarafından isteniyorsa kullanılır)

Aşağıda ise birkaç komut örneği bulabilirsiniz.

1) Hvcluster1 isimli bir Hyper-V Cluster ortamını raporlamak için.

.\Get-HyperVReport.ps1 -Cluster Hvcluster1

2) Hvcluster1 isimli Hyper-V Cluster ortamında çok sayıda sanal makine ve sunucu var, bu yüzden sadece üzerinde uyarı olan kayıtları raporlamak için. Yani HighlightsOnly mode.

.\Get-HyperVReport.ps1 -Cluster Hvcluster1 -HighlightsOnly $true

3) Birkaç Standalone Hyper-V sunucusunu raporlamak için

.\Get-HyperVReport.ps1 -VMHost Host1,Host2,Host3

4) Bir Hyper-V Cluster’ı raporlamak ama oluşan rapor dosyasını farklı bir ön ekle farklı bir dizine kayıt etmek için.

.\Get-HyperVReport.ps1 -Cluster Hvcluster1 -ReportFileNamePrefix YeniOnEk -ReportFilePath c:\yeni-raporlar

5) Bir Hyper-V Cluster’ı raporlamak ve oluşan HTML dosyayı aynı zamanda SMTP Authentication istemeyen bir e-posta sunucusu üzerinden birkaç alıcıya göndermek için.

.\Get-HyperVReport.ps1 -Cluster Hvcluster1 -SendMail $true -SMTPServer 10.20.30.5 -MailFrom sender@hyperv.corp -MailTo recepient1@hyperv.corp,recepient2@hyperv.corp,recepient2@hyperv.corp

6) Bir Hyper-V Cluster’ı raporlamak ve oluşan HTML dosyayı aynı zamanda SMTP Authentication ve TLS isteyen bir e-posta sunucusu üzerinden alıcılara göndermek için. Örneğin Gmail üzerinden.

.\Get-HyperVReport.ps1 -Cluster Hvcluster1 -SendMail $true -SMTPServer smtp.gmail.com -SMTPPort 587 -MailFrom sender@gmail.com -MailFromPassword P@ssw0rd -SMTPServerTLSorSSL $true -MailTo sakinci@inprowise.com

Önemli Notlar

• Script tek bir noktadan çalıştırılır; doğrudan bir Cluster üyesi, Standalone Hyper-V Host veya tamamen farklı bir görevdeki uzak Windows Server üzerinden çalıştırabilirsiniz.
• -Cluster ve -VMHost parametreleri aynı anda kullanılamaz. Yani ya Cluster ortamınızı ya da Standalone Hyper-V sunucu grubunu raporlayabilirsiniz. Eğer her ikisini de raporlamanız gerekiyorsa yine ayrı ayrı olmak koşuluyla iki farklı pencerede (veya zamanlanmış görevde) veya sırayla raporlamanız mümkün.
• Bir Hyper-V sunucu eğer Cluster üyesi ise sadece -Cluster parametresi kullanılarak diğer Cluster Node’ları ile birlikte raporlanabilir çünkü ortam bilgileri aynı Cluster içerisindeki diğer kaynaklarla birlikte değerlendirildiğinde anlamlıdır.
• Raporlama için -Cluster parametresine aynı anda sadece tek bir cluster ismi verilebilir. Birden fazla Cluster’ın aynı rapor içerisinde gösterilmesi desteklenmez.
• Bir Hyper-V sunucu eğer Cluster üyesi değil ise sadece -VMHost parametresi kullanılarak raporlanabilir.

Get-HyperVReport.ps1 İndirme Bağlantısı

İndirme ve versiyon takibini tek noktadan yapabilmek için script’in bu 1.0 sürümünü ve önümüzdeki günlerde yayınlanacak sonraki sürümlerini Technet Gallery üzerinde host etmeye karar verdim. Blog’da sürümler ve özellikler hakkında yazılara yer vermeye devam edeceğim tabii ki, ama yeni sürümler de dahil indirme kaynağı Technet Gallery olacak. Aşağıdaki bağlantıyı kullanarak Get-HyperVReport.ps1’in 1.0 sürümünü indirip kullanmaya başlayabilirsiniz.