Windows, Hyper-V monitoring

XorMon is able to monitor stand-alone MS Windows servers and MS Hyper-V performance metrics (hosts and VMs).
The agent monitoring even Storage Spaces Direct(S2D).

Implementation is done through single Windows OS agent running on any Windows host in the Windows domain.
This OS agent gets all required configuration from the AD and performance data of monitored hosts through WMI.
It passes such data to XorMon server where data is saved and presented.

Is used LPAR2RRD Windows OS agent which works everywhere where is available PowerShell 3 and higher
It does not directly depends on the Windows version, if you are able to upgrade PowerShell to 3.0+ on older machines then it will work.

Hyper-V schema

Installation summary

  • Allow TCP connection initiated from Windows LPAR2RRD Hyper-V agent server to XorMon server on port 8162
  • PowerShell version 3 and higher only is supported on Windows hosts

User creation

  1. Create the user in the AD with membership in these groups:
    • Event Log Readers
    • Hyper-V Administrators
    • Performance Log Users
    • Performance Monitor Users
    This must be done for all Hyper-V nodes and MS Windows servers that are supposed to be monitored (this can be set globally in AD).

  2. Set rights in GPO and AD using this manual

  3. Give local admin rights to the the user on the Win server where LPAR2RRD Hyper-V agent will be running.
    Add him into Domain Users group.

  4. Assign read-only rights for monitored Hyper-V clusters to the user
    Hyper-V cluster rights 1
    Hyper-V cluster rights 2

OS agent installation

    Unzip LPAR2RRD-Win-agent-1.3.3.zip
    Unblock these files by right clicking them and checking "Unblock"
    • Setup.vbs
    • Configuration.vbs
    • LPAR2RRD-agent.ps1
    • LPAR2RRD-agent-Configuration.ps1
    • LPAR2RRD-agent-Installer.ps1
    Hyper-V OS agent install

    When 'Unblock" does not help and installation does not start (install windows immediatelly disapears), you might need to Set-ExecutionPolicy to enable running powershell for current user.


    Run Setup.vbs

    Select installation directory
    Hyper-V OS agent install

    Put hostname of the XorMon server
    Hyper-V OS agent install

    Test connection to the XorMon server
    Hyper-V OS agent install

    Put user which will run LPAR2RRD OS agent on this machine
    Hyper-V OS agent install

    Select monitored mode (agent v1.3.3+)
    Hyper-V OS agent install
    You can also use manuall OS agent installation
    In case of a cluster: add there cluster name and names of all nodes as well like: cluster1,node1,node2,cluster2,node...
  • Wait about 30 minutes, then Ctrl-F5 in your XorMon UI and you should see Hyper-V folder in the main menu

Monitored modes

    The agent can run in these modes:
    1. leave it in default mode and monitor just the server where it is installed
    2. monitor all visible servers from AD
    3. monitor only specific servers (recommended), added into cfg file
      for monitoring of cluster - add its name to servers/nodes too like: cluster1,node1,node2,cluster2,node...

Troubleshooting