Skip to main content

HyperV - Integration Service Monitoring

Summary​

This monitor generates alerts for HyperV host virtual machines with failing Integration Services.

Dependencies​

Monitor Setup Location​

Monitors Path: ENDPOINTS -> Alerts -> Monitors

Monitor Summary​

  • Name: HyperV - Integration Service Monitoring
  • Description: This monitor generates alerts for HyperV host virtual machines with failing Integration Services.
  • Type: Script
  • Severity: Others
  • Family: Hyper-V

Image1

Targeted Resources​

  • Target Type: Device Groups
  • Group Name: HyperV Integration Service Monitoring

Image2

Conditions​

  • Run Script on: Schedule
  • Repeat every: 15 Minutes
  • Script Language: PowerShell
  • Use Generative AI Assist for script creation: False
  • PowerShell Script Editor:
$ProgressPreference = 'SilentlyContinue'
$WarningPreference = 'SilentlyContinue'

if (-not (Get-Service -Name 'vmms' -ErrorAction SilentlyContinue)) {
    return 'The Hyper-V Virtual Machine Management Service (vmms) is not found. This system is not a Hyper-V host.'
}

$output = @()
try {
    $vms = Get-VM -ErrorAction Stop |
        Where-Object -FilterScript {
            $_.State -eq 'Running'
        }

    if ($vms) {
        foreach ($vm in $vms) {
            $services = Get-VMIntegrationService -VMName $vm.Name -ErrorAction Stop

            $failingServices = $services | Where-Object -FilterScript {
                $_.Enabled -eq $true -and
                $_.PrimaryStatusDescription -ne 'OK'
            }

            if ($failingServices) {
                $badServiceNames = ($failingServices.Name) -join ', '
                $output += ('{0}: Failing ({1})' -f $vm.Name, $badServiceNames)
            }
        }

        if ($output.Count -gt 0) {
            return ('Detected issues with Integration Services state:{0}{1}' -f [Environment]::NewLine, ($output -join [Environment]::NewLine))
        }

        return 'Integration Services are UpToDate and reporting OK.'
    }

    return 'No running VMs found.'
} catch {
    return ('Script failed to run properly. Reason: {0}' -f $Error[0].Exception.Message)
}
  • Criteria: Contains
  • Operator: AND
  • Script Output: Detected issues with Integration Services state
  • Escalate ticket on script failure: False
  • Add Automation: NONE

Image3

Ticket Resolution​

Automatically resolve: False

Image4

Monitor Output​

Output: Generate Ticket

Image5

Completed Monitor​

Image6

Changelog​

2026-06-17​

  • Initial version of the document