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

  1. Unzip LPAR2RRD-Win-agent-8.0.0.zip
  2. 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 (PowerShell install window immediatelly disapears)
    you might need to Set-ExecutionPolicy to enable running powershell for current user.
    That is a common case on Windows desktops.

  3. Run: Setup.vbs

  4. Select installation directory
    Note that 'C:\Program Files\<whatever...>\' does not work on all Windows (especially Desktops) due to some permission issue, files are not copied there, an use alternative path
    Hyper-V OS agent install

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

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

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

  8. Select monitored mode
    Hyper-V OS agent install

  9. In case of a cluster: add there cluster name and names of all nodes as well like: cluster1,node1,node2,cluster2,node...

    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...

  10. Wait about 30 minutes, then you should see it in your XorMon UI under 'Server ➡ Windows' folder in the main menu

You can also use manual OS agent installation


Troubleshooting