Skip to content

Hyper-V health and alert architecture ​

Health answers what is currently unhealthy; alerts answer what an operator should act on. They are related but not identical. Unit monitors establish object health, aggregate monitors organize the four SCOM health dimensions, dependency monitors propagate service impact, and alerts originate at the most actionable layer. Rules collect diagnostic history or alert on discrete events that do not have a durable state model.

Health construction ​

Rendering diagram…

Aggregate and dependency monitors normally do not generate duplicate alerts. The leaf monitor that has the evidence and remediation context alerts; its state then rolls up for service impact.

Standard health dimensions ​

DimensionHyper-V examplesTypical evidence
AvailabilityHost role, VM service, cluster/node/resource, CSV online, Replica availabilityService state, cluster state, authoritative events, heartbeat
ConfigurationVersion drift, unsupported topology, integration configuration, network authority driftRegistry, CIM, PowerShell, configuration provider
PerformanceSustained CPU pressure, memory pressure, latency, queue, packet lossPerformance counters and calculated property bags
SecurityExplicit security posture signals that are both supported and actionableSecurity/configuration provider; disabled unless evidence supports default health

Security is not a catch-all for general configuration. The first release includes Security health only for signals with a documented source, owner, remediation, and support boundary.

Stateful threshold pattern ​

Rendering diagram…

SCOM may render a missing or uninitialized state as unmonitored rather than a custom fourth state; the implementation must map that platform behavior explicitly. It must not substitute Healthy for missing evidence.

Threshold contract ​

Every numeric monitor defines the complete time behavior, not only a percentage:

Rendering diagram…

The default host-memory design does not alert at 75% utilization alone. It combines available or reserved host memory, Hyper-V pressure, paging, sustained duration, topology, and lab evidence. The same evidence contract applies to CPU, storage, network, and VM pressure.

Alert decision flow ​

Rendering diagram…

Alert contract ​

Every enabled alert-generating workflow must define:

  • source object and monitor/rule ID;
  • condition, operational impact, and evidence captured in alert parameters;
  • severity and priority with a consistent mapping;
  • whether the alert auto-resolves, and the exact healthy/reset evidence;
  • suppression key and repeat-count behavior for event storms;
  • maintenance, migration, backup, checkpoint, drain, and failover behavior;
  • probable causes, validation commands or views, remediation, escalation, and recovery verification;
  • related performance, event, state, and task views; and
  • DA branch and parent impact.

Dependency and symptom suppression ​

Rendering diagram…

Suppression must be implemented only where targeting and correlation are deterministic. When SCOM cannot safely suppress a symptom, the MP should delay the child condition or provide correlation knowledge instead of hiding a potentially independent fault.

Population-aware VM health ​

Rendering diagram…

An intentionally powered-off VM must not make the DA unhealthy by default. Expected state is an explicit discovered or configured policy, not a guess based on one sample.

Rollup defaults ​

ScopeProposed defaultReason
Unit monitor to dimensionWorst state within that dimensionPreserve the most severe supported condition
Dimension to objectStandard SCOM object health behaviorKeep Health Explorer predictable
Critical infrastructure child to branchWorst stateOne failed quorum, CSV, or required host dependency can be service-critical
Redundant host populationTopology-aware or percentage rollupOne drained node may not equal cluster outage
VM populationExpected-state plus absolute and percentage policyAvoid one intentionally stopped VM poisoning a large service
Monitoring pipelineWorst state with explicit freshness deadlinesPrevent false confidence when telemetry is absent
Branch to DA rootImpact-weighted dependency monitorsAvailability-critical branches may affect root differently from advisory configuration

Monitoring coverage sets ​

Coverage setIntended behavior
CoreLow-noise availability, data-integrity, and monitoring-pipeline health enabled
BalancedCore plus validated predictive performance and configuration monitoring
Deep diagnosticHigh-cardinality collection and disabled-by-default monitors enabled selectively

Coverage sets describe which validated workflows are selected. Lab, Standard, and Strict tuning templates describe environment posture and the values applied to selected workflows. These are orthogonal decisions, not separate sealed runtime products. Discovery changes remain in the customer Discovery Overrides MP; monitor, rule, alert, and collection changes remain in the customer Monitoring Overrides MP. See Override and tuning architecture.

Detailed health rollup and dependency hierarchy ​

The Distributed Application aggregates thousands of underlying property-bag signals into a clean, hierarchical health model:

Rendering diagram…

Rollup policy specifics ​

  1. Virtual Machines Rollup (Anti-Noise Guard):
    • Rollup Monitor: HyperVPrivateCloud.VirtualMachines.Members.Availability.Dependency.Monitor
    • Algorithm: Percentage
    • Parameter: 25 (Requires >25% of VMs to be unhealthy before degrading the Virtual Machines component)
    • MemberUnAvailable: Success (An unmonitored or newly provisioned VM does not poison the health tree)
  2. Management Infrastructure Rollup:
    • Rollup Monitors: DomainHealth, DnsHealth, DeploymentService roll directly into ManagementInfrastructureComponent.
    • Algorithm: WorstOf (Because Active Directory and DNS are critical prerequisites for cluster authentication and host operations).
  3. Compute and Host Rollup:
    • Evaluates host services (vmms, hcs), hypervisor presence, host headroom, and reboot status.
    • Algorithm: WorstOf for core service availability; Warning for pending reboots.

Implemented monitor catalog and override settings ​

The table below details core unit monitors, their health dimensions, default intervals, warning/error evaluation criteria, and overridable parameters:

Monitor IDTarget ClassDimensionDefault IntervalWarning / Critical ConditionOverridable Parameters
Host.VmmsService.MonitorHostRoleAvailability60sVMMS service stoppedIntervalSeconds, TimeoutSeconds
Host.HostComputeService.MonitorHostRoleAvailability60sHCS service stoppedIntervalSeconds, TimeoutSeconds
Host.Hypervisor.MonitorHostRoleAvailability300sHypervisor present flag falseIntervalSeconds, TimeoutSeconds
Host.CpuPressure.MonitorHostRolePerformance120sCPU usage > 90% (Warning), > 95% (Critical)WarningThreshold, CriticalThreshold, SampleCount
Host.AvailableMemory.MonitorHostRolePerformance120sFree RAM < 2048 MB (Warning), < 1024 MB (Critical)WarningThresholdMB, CriticalThresholdMB
Host.PendingReboot.MonitorHostRoleConfiguration3600sCBS or Windows Update reboot pendingIntervalSeconds, TimeoutSeconds
Host.DomainHealth.MonitorActiveDirectoryServiceAvailability900sAD secure channel broken or PDC unreachableIntervalSeconds, TimeoutSeconds
Host.DnsHealth.MonitorDnsServiceConfiguration900sAdapter DNS missing or forward resolution failingIntervalSeconds, TimeoutSeconds
Host.DeploymentService.MonitorDeploymentServiceAvailability900sWDSServer stopped or TFTP/PXE ports closedIntervalSeconds, TimeoutSeconds
Host.PipelineFreshness.MonitorMonitoringPipelineAvailability300sPowerShell 7 engine failure or telemetry driftIntervalSeconds, MaxDriftSeconds
Vm.State.MonitorVirtualMachineAvailability60sVM not in expected operational stateIntervalSeconds, TimeoutSeconds
Vm.Heartbeat.MonitorVirtualMachineAvailability60sIntegration services heartbeat missedIntervalSeconds, MissedThreshold
Vm.IntegrationServices.MonitorVirtualMachineConfiguration300sIntegration components outdated or degradedIntervalSeconds, TimeoutSeconds
Vm.MemoryPressure.MonitorVirtualMachinePerformance120sVM memory demand > 95% of limitWarningThreshold, SampleCount
Vm.StorageLatency.MonitorVirtualMachinePerformance120sAverage virtual disk latency > 40msLatencyThresholdMs, SampleCount
Vm.StorageQueue.MonitorVirtualMachinePerformance120sVirtual disk queue depth > 32QueueDepthThreshold, SampleCount
Cluster.Quorum.MonitorClusterRoleAvailability60sCluster quorum degraded or offlineIntervalSeconds, TimeoutSeconds
Cluster.CSVState.MonitorClusterRoleAvailability60sCSV volume offline or in redirected IO modeIntervalSeconds, TimeoutSeconds
Cluster.CSVFreeSpace.MonitorClusterRolePerformance300sFree space < 15% (Warning), < 5% (Critical)WarningPercent, CriticalPercent

Operator tasks catalog ​

The management pack suite equips operators with read-only diagnostics and controlled remediations directly from the SCOM console:

Task NameTarget ClassTypeWhat it does
TestDomainHealthActiveDirectoryServiceDiagnosticValidates domain trust, secure channel status, PDC emulator responsiveness, and AD site topology.
TestDnsResolutionDnsServiceDiagnosticProbes adapter DNS server configuration, forward name resolution, and domain controller SRV record lookups.
TestPortConnectivityHostRoleDiagnosticPerforms TCP synthetic port checks against default gateways (HTTP/HTTPS/SMB) and Domain Controllers (LDAP/RPC/Kerberos/SMB/WinRM).
TestPxeWdsHealthDeploymentServiceDiagnosticVerifies WDSServer service status, active UDP listeners on ports 67/68/69/4011, and the REMINST deployment share.
GetLldpNeighborPhysicalNetworkRoleDiagnosticProbes physical host adapters and driver DCB properties to extract connected ToR switch port IDs and chassis IDs.
PfcEtsCountersPhysicalNetworkRoleDiagnosticGathers real-time RDMA Activity, PFC pause frames, DCB traffic classes, and QoS priority policy drop counters.
CollectDiagnosticSummaryHostRoleDiagnosticGenerates a complete environmental summary of the host, Hyper-V services, and PowerShell 7 runtime health.
RestartVmmsHostRoleRemediationGracefully restarts the Virtual Machine Management Service (vmms). Requires operator confirmation.
RestartHcsHostRoleRemediationGracefully restarts the Host Compute Service (hcs). Requires operator confirmation.
MoveCsvCoordinatorClusterRoleRemediationRebalances or live-moves CSV ownership to an optimal cluster node.
DrainNodeClusterRoleRemediationPauses and safely live-migrates all virtual machines away from the target host for maintenance.
ResumeNodeClusterRoleRemediationResumes cluster scheduling on a maintenance-completed node.
LiveMigrateVmVirtualMachineRemediationInitiates a live migration of the target VM to the best available host in the cluster.

Released under the MIT License.