Hyper-V VM guest heartbeat powershell

Download hyperv-vm-heartbeat.ps1

On a Hyper-V host, walks every VM and reports state + integration-services heartbeat. Flags any running VM whose guest agent isn't reporting healthy — usually means the VM is stuck before login, kernel panicked, or the integration services died.

Placeholders only. Before running, replace YOUR_URL with your capture endpoint's POST URL . (Open this page from your capture object to have these auto-filled.)

# hyperv-vm-heartbeat.ps1 — per-VM heartbeat + state on a Hyper-V host.
# Requires the Hyper-V module (RSAT-Hyper-V-Tools or the role installed).

$Url = "YOUR_URL/hyperv"

try {
  $VMs = Get-VM -ErrorAction Stop
} catch {
  $Body = (@{ hostname = $env:COMPUTERNAME; error = "$($_.Exception.Message)" }) | ConvertTo-Json -Compress
  Invoke-RestMethod -Uri $Url -Method Post -Body $Body -ContentType "application/json" -TimeoutSec 15 | Out-Null
  exit 1
}

$Stats        = @{}
$AnyUnhealthy = $false
foreach ($vm in $VMs) {
  $hb        = "$($vm.Heartbeat)"
  $state     = "$($vm.State)"
  # 'OkApplicationsHealthy' or 'OkApplicationsUnknown' both count as healthy;
  # 'NoContact' / 'LostCommunication' / null mean the guest agent is silent.
  $healthy   = ($state -eq 'Running' -and $hb -match '^Ok')
  $Stats[$vm.Name] = @{
    state           = $state
    heartbeat       = $hb
    uptime_seconds  = if ($vm.Uptime) { [int]$vm.Uptime.TotalSeconds } else { 0 }
    healthy         = $healthy
  }
  if (-not $healthy -and $state -eq 'Running') { $AnyUnhealthy = $true }
}

$Body = (@{
  hostname       = $env:COMPUTERNAME
  vm_count       = $VMs.Count
  vms            = $Stats
  any_unhealthy  = $AnyUnhealthy
}) | ConvertTo-Json -Compress -Depth 5

Invoke-RestMethod -Uri $Url -Method Post -Body $Body `
  -ContentType "application/json" -TimeoutSec 15 | Out-Null

Recommended pairing

Add a capture.value check to this capture object.
json_path = any_unhealthy, op = ==, threshold = true (severity: crit). For per-VM: json_path = vms.MyVm.healthy, op = ==, threshold = false.

What is the filename?

hyperv-vm-heartbeat.ps1 — this is the suggested name for the downloaded file. Rename freely if you prefer.