> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getthread.com/llms.txt
> Use this file to discover all available pages before exploring further.

# VMware vSAN and vMotion

> Diagnose VMware vSphere: vSAN health warnings, resync storms, vMotion and DRS migration failures, datastore latency, and APD or PDL via vCenter events.

<Info>
  **Category:** Troubleshooting Playbooks · [View source ↗](https://github.com/Thread-Magic/super-magic-skills/blob/main/skills/troubleshooting-playbooks/vmware-vsan-vmotion/SKILL.md)
</Info>

**Runs as:** <span className="thread-chips" data-skill-tier="skill"><span className="thread-chip thread-chip-tier-skill">Skill</span></span> — you run it in Super Magic and confirm each write; there's no Flow trigger for this one.

**Connectors:** <span className="thread-chips"><span className="thread-chip">IT Glue</span><span className="thread-chip">Hudu</span></span>

**Role:** [Technician](/start-here/roles/technician)

**Outcome:** Faster Resolution & Response

**When to use:** vSAN Skyline Health shows warnings/errors or the cluster is resyncing; vMotion / Storage vMotion fails or DRS won't balance or evacuate a host for maintenance; datastore latency spikes, VMs stunned, or an APD/PDL event; or a host is disconnected, not-responding, or won't enter maintenance mode.

**Run it:** on the one ticket you're working — a tech with vSphere access works it hands-on; not unattended.

## Prompt

```
Read vCenter's health checks before anyone evacuates a host — migrating VMs onto a
stressed cluster, or rebooting one mid-resync, turns a warning into an outage. esxcli
and PowerCLI steps are guidance for a tech; hypervisor management is not an RMM action.

Climb the Troubleshooting Ladder base skill first, topology as its top rung: vCenter and
ESXi build, storage model (vSAN vs SAN/NFS), the vSAN and vMotion VMkernel networks, and
the storage policy's FTT — failures to tolerate decides how many hosts can be down
safely, so establish it first. Then history: recent patching, a firmware or driver
change (vSAN is exquisitely sensitive to storage-controller firmware/driver mismatches),
a disk replacement, a network change.

Then read the actual failing check, never "vSAN is unhealthy": Skyline Health, resync
objects and ETA, disk-group and disk state; the task error and DRS faults panel for
migrations; per-datastore latency and APD/PDL events in vmkernel.log.

a. vSAN health or resync — Skyline Health names it: a failing capacity or cache disk, an
   HCL firmware/driver mismatch, a vSAN VMkernel network fault (MTU and jumbo-frame
   mismatches are classic), or object non-compliance. A resync is the cluster
   self-healing: don't reboot or evacuate during one, and NEVER take a second host down
   while it rebuilds from a first failure — that breaches FTT and loses data. Hardware,
   HCL, and firmware are the vendor's and storage owner's: package evidence, don't push
   firmware.

b. vMotion or Storage vMotion failure — read the error: vMotion network or MTU,
   insufficient target resources, CPU/EVC mismatch across host generations, a device the
   VM can't migrate with (mounted ISO, passthrough, USB, an affinity rule). A failed
   vMotion normally leaves the VM running on the source — confirm before retrying.
   Storage vMotion failures are usually target-datastore space or latency.

c. DRS won't balance, or a host won't enter maintenance mode — evacuation stalls when
   DRS can't place VMs (resource shortfall, anti-affinity, a VM pinned by a device) or,
   on vSAN, when data evacuation would breach availability. Never force "no data
   migration" maintenance mode on vSAN without understanding the availability impact.

d. Datastore latency, APD, or PDL — latency points at the backend (array, HBA or NIC,
   fabric, vSAN disk pressure). APD is paths temporarily gone, PDL the device
   permanently gone; PDL usually needs the device removed or replaced and affected VMs
   handled deliberately. Check multipathing and the physical path per host. SAN, fabric,
   and array faults are the storage owner's and the vendor's.

Success is vCenter's report: Skyline Health green or resync complete and objects
compliant, a clean test vMotion, latency at baseline. Note it (apply the PSA Note
Discipline base skill): build, FTT, evidence, branch, action, verification.
```


## Related topics

- [Liongard VMware Read](/skill-library/liongard-inspectors/liongard-vmware.md)
- [Hypervisor Alert Triage](/skill-library/devices-and-infrastructure/hypervisor-alerts.md)
- [Agents](/skill-library/agents.md)