Hyper-V Reporting Script v1.5

04.03.2015
8

ⓘ   Dikkat: Bu araç uzun süre önce sonlanmıştır / This script is no longer available

Standalone veya Clustered Hyper-V ortamlarını raporlamak ve belirli açılardan izlemek için kullanabileceğiniz Get-HyperVReport.ps1 raporlama script’inin 1.5 sürümü indirmek için hazır! Her zamanki gibi TechNet Gallery bağlantısını ziyaret ederek yeni sürümü edinebilirsiniz. Bu arada blog üzerinde bahsetme fırsatım olmadı ama geçen ay ufak bir bakım sürümü de yayınlamıştım (v1.1). Bir güncelleme var mı diye TehNet Gallery’i ziyaret edenler fark etmiş olabilirler. Şimdi gelelim yeni sürüme.

Get-HyperVReport.ps1 v1.5

Bu sürümde yer alan tüm yenilikleri ve bu yeni özellikler hakkında bazı ilave bilgileri aşağıda listeledim.

Cluster Overview bölümü

Cluster içerisinde kaç adet node var ve bunlardan kaçı up durumda? Ortamda kaç adet kullanılabilir logical processor var ve bunlar üzerinde kaç adat virtual processor çalışıyor? Cluster’ın toplam bellek ve depolama alanı kapasiteleri ne durumda? Cluster’a üye kaç VM var ve kaçı çalışır durumda? Veya bu VM’ler cluster’ın bellek ve depolama kaynaklarının toplamda ne kadarını tüketiyor? gibi soruların yanıtlarını bu bölümde bulabilirsiniz. Cluster Overview bölümünü sadece -Cluster parametresiyle raporlama yaparken görebileceğinizi unutmayın.

Storage Overcommitment (Active VHD) sütunu

Script, raporladığı herhangi bir depolama alanı içerisindeki aktif VHD’leri tespit ediyor ve bu VHD’lerin maximum genişleme kapasitelerini hesaplayıp o fiizksel depolama alanının maximum size’ı ile karşılaştırıyor. Söz konusu VHD’lere eğer mevcut kapasitenin üzerinde atama yapılmışsa, ileride oluşabilecek taşma durumuna karşı önceden uyarı oluşturuyor. Özellikle dinamik VHD’lerle çalışan ortamlar için günde 1 doz öneririm :)

storage-overcommitment

Extended Replica için raporlama desteği

Artık aynı rapor içerisinde -extended dahil- her üç replication mode’u da izleyip o anki durumları hakkında bilgiler alabilirsiniz. Mesela aşağıdaki VM, node14.ipw.corp isimli Primary Server’dan bu sunucuya Replica olarak gelmiş ve buradan da external.inprowise.com isimli bir başka Hyper-V sunucusuna Extended Replica ile çoğaltılmış durumda. Son replikasyon ne zaman gerçekleşmiş, replikasyon sıklığı, replikasyon durumu gibi ek bilgiler de izlerken işinizi kolaylaştıracaktır.

extended-replica

Hyper-V Host’lar için bazı yeni bilgiler

Aşağıdaki bilgileri her bir Hyper-V Host için raporda görmeniz mümkün. Diğer birçok ilave bilgi gibi tamamı tooltip’ler içerisinde sağlanıyor.

  • Logical Processor başına düşen Virtual Processors oranı. (ratio)
  • Host Computer Manufacturer, Model.
  • Processor Manufacturer, Model, Ghz.
  • Çalışır durumdaki VM’ler için Clustered ve non-clustered dağılımı.

VM Virtual Network bilgileri

VM’lere bağlı network adapter’ler üzerinde yer alan ağıdaki bilgileri yine VM bazlı olarak raporda görmeniz mümkün.

  • Network adapter device type (Synthetic/Legacy)
  • Connection status (Connected/Not-connected)
  • Virtual switch name (Eğer bağlıysa)
  • IP address (v4/v6)
  • VLAN ID (Eğer atanmışsa)
  • Advanced – MAC Address, MAC Type, DHCP Guard, Raouter Guard, Port Mirroring, Protected Network

Yeni $ReportFileNameTimeStamp parametresi

Varsayılan olarak $true’dur. Script’i çalıştırırken bu parametreyi $false yaparsanız çalışma sonunda oluşan rapor dosyası ismine tarih/saat bilgisi eklenmez ve her zaman aynı isme sahip bir html dosyası oluşur. Mesela bu parametreyle ve belirli periyotlarda çalışmak üzere zamanlanmış bir Windows görevinin çıktısını doğrudan bir web server dizinine yazdırarak raporu daha kolay takip etmek mümkün olabilir. Hatta zamanlanmış görevin çalışma periyotlarını ve web sayfasının yenileme sıklığını düzenleyerek belki basit bir monitoring ekranı bile oluşturabilirsiniz.

$ReportIsBodyHTML parametresi artık yok

Bu parametreyi 1.1 sürümünde eklemiştim ve HTML raporu doğrudan e-mail message body olarak gönderiyordu. Böylece gelen mail’de her seferinde dosyayı açmak yerine doğrudan mail body alanında rapor sonucuna bakabiliyordunuz. Ancak Outlook gibi mail istemcilerin HTML/CSS yorumlamadaki farklı yaklaşımları nedeniyle uyumlu görünümü koruma noktasında sorunlar yaşadım. Farklı browser’lar için görünüm standardını korumak nispeten kolay ama mail istemciler tam bir baş belası. Geldiğim noktada bununla daha fazla uğraşmak istemediğim için kaldırdım. Zaten rapor da bir mail istemcide okumak için fazla geniş.

Runtime environment olarak Windows 8 ve Windows 8.1 desteği

Artık Get-HypervReport.ps1’i domain member istemciler üzerinden de çalıştırabilirsiniz. Öncesinde Hyper-V ve Clustering PowerShell module’lerinin aktif edilmiş olması gerektiğini unutmayın.

Şimdilik böyle.

Yorumlar (8)

  1. Mesut GUVEN

    Merhaba Serhat Hocam,

    Yine eline, fikrine, emeğine sağlık.

  2. Nedim

    Kullanıyoruz, mükemmel :)

  3. Emre

    Merhaba Serhat Bey,
    Bu güzel çalışma için çok teşekkürler.
    Scripti çalıştırdığımda çalıştırdığım makine üzerinde sanal makine olmadığına dair hata veriyor.

    [DEBUG] – 29.Jun.2016 11:38:14 – —– Start —–
    [INFO] – 29.Jun.2016 11:38:14 – Logging started: C:\Users\emre\ScriptLog.txt
    [INFO] – 29.Jun.2016 11:38:17 – Checking prerequisites to run script on the NODE3…
    [DEBUG] – 29.Jun.2016 11:38:17 – NODE3: Operating system is supported as script runtime environment.
    [DEBUG] – 29.Jun.2016 11:38:18 – NODE3: Hyper-V PowerShell Module is OK.
    [DEBUG] – 29.Jun.2016 11:38:18 – NODE3: Failover Clustering PowerShell Module is OK.
    [INFO] – 29.Jun.2016 11:38:18 – NODECLS is accessible. Gathering Node information…
    [INFO] – 29.Jun.2016 11:38:21 – Checking prerequisites for Hyper-V Cluster reporting…
    [DEBUG] – 29.Jun.2016 11:38:26 – Operating system version and Hyper-V role on the cluster owner node is OK.
    [INFO] – 29.Jun.2016 11:38:27 – Available Hyper-V Cluster Node(s) for reporting: NODE1 NODE2 NODE3
    [INFO] – 29.Jun.2016 11:38:30 – Gathering Hyper-V Host information…
    [INFO] – 29.Jun.2016 11:38:45 – Gathering Virtual Machine information…
    [WARNING] – 29.Jun.2016 11:43:18 – NODE3: Does not have Virtual Machine.
    [INFO] – 29.Jun.2016 11:43:21 – Gathering Disk/Volume information…
    [INFO] – 29.Jun.2016 11:43:24 – Writing output to file C:\Users\emre\HyperVReport-29Jun16-113814AM.html
    [INFO] – 29.Jun.2016 11:43:24 – Report created successfully.
    [INFO] – 29.Jun.2016 11:43:24 – Completed!
    [DEBUG] – 29.Jun.2016 11:43:24 – —– End —–

    Bu konuda bir yorumunuz olur mu acaba?

  4. Andras

    HI!

    I found your very good script here: https://gallery.technet.microsoft.com/scriptcenter/Hyper-V-Reporting-Script-4adaf5d0
    Do you have a updated version for this script? Every integration versin is marked update needed.

    Br Andras

  5. Halil Kerem

    Merhaba Serhat Hocam ,

    Windows Server 2016 işletim sistemleri HYPER-V raporu almayı çalışıyorum. https://gallery.technet.microsoft.com/Hyper-V-Reporting-Script-4adaf5d0/view/Discussions/1 linki konuda dediğimiz yapmıştık. Ama Script Terminated olarak görünüyor.

    Bu konuda yardımcın olur musun?

  6. Halil Kerem

    PS C:\Script> .\Get-HyperVReport.ps1 -Cluster ClusterName
    [INFO] – 16:00:38 – Started! Hyper-V Reporting Script (Version 1.5)
    [INFO] – 16:00:41 – Logging started: C:\Script\ScriptLog.txt
    [INFO] – 16:00:44 – Checking prerequisites to run script on the OCTISTHYP02…
    [INFO] – 16:00:46 – OCTISTHYPCLS is accessible. Gathering Node information…
    [INFO] – 16:00:49 – Checking prerequisites for Hyper-V Cluster reporting…
    [WARNING] – 16:00:52 – OCTISTHYPCLS: Incompatible operating system version detected. Supported operating systems are Win
    dows Server 2012 and Windows Server 2012 R2.
    [ERROR] – 16:00:52 – Script terminated!

  7. Gul

    Hi Serhat,

    Could you help me with the script. The script gives an error! please help me with it.

    PS C:\Windows\system32> cd C:\Get-HyperVReport_Copy
    PS C:\Get-HyperVReport_Copy> .\Get-HyperVReport.ps1
    [INFO] – 13:51:21 – Started! Hyper-V Reporting Script (Version 1.6)
    [INFO] – 13:51:24 – Logging started: C:\Get-HyperVReport_Copy\ScriptLog.txt
    [ERROR] – 13:51:27 – Hyper-V target parameter is missing. Use -Cluster or -VMHost parameter to define target.
    [WARNING] – 13:51:27 – For technical information, type: Get-Help .\Get-HyperVReport.ps1 -examples
    [ERROR] – 13:51:27 – Script terminated!

  8. Jim

    could you help me with the script run in windows 2022 hyper-v …it gives error in 2022.
    your great help would be highly Appreciated….thanks

Yorum Ekle

* Gerekli

* Gerekli

* Tercihen