Setting the file. One moment.
Chapter 15 · Azure Diagnostics
Subchapter 15.35
troubleshooting/compute/vm-troubleshooting.mdMarkdown3 KBView on GitHub
Primary compute troubleshooting guide for incidents routed from ../../SKILL.md. Use for Azure VM RDP/SSH failures, NSG/firewall blocks, credential resets, and VM agent/tooling issues.
| Property | Details |
|---|---|
| Best for | RDP/SSH failures, port 3389/22 timeouts, black screen, credential reset, VM agent issues |
| Primary tools | mcp_azure_mcp_compute, mcp_azure_mcp_resourcehealth, mcp_azure_mcp_monitor, CLI fallback |
| Router | references/cannot-connect-to-vm.md |
| Tool | Purpose |
|---|---|
mcp_azure_mcp_compute | VM state, instance view, VM agent, extension, NIC evidence |
mcp_azure_mcp_resourcehealth | Platform health before deeper diagnosis |
mcp_azure_mcp_monitor | Logs/metrics when workspace or resource scope is known |
mcp_azure_mcp_documentation | Current Microsoft Learn guidance for the matched symptom |
az vm user update, az vm user reset-ssh, az vm user reset-remote-desktop, az vm run-command invoke) until Pre-Flight Safety Checks pass.mcp_azure_mcp_documentation to fetch current docs for the selected URL or symptom.mcp_azure_mcp_documentation
intent: "find current Azure VM RDP SSH troubleshooting docs for <symptom>"
parameters:
query: "<documentation URL or user's symptom>"| Error | Action |
|---|---|
| Docs lookup empty | Use the reference quick commands and tell user the doc URL may have changed |
| VM name/resource group wrong | Ask user to verify resource identity |
Run Command timeout or VMAgentStatusCommunicationError | Do not run extension commands; use Serial Console/offline repair |
| Serial Console unavailable | Enable Boot Diagnostics first |
| Password reset fails | Check VMAccess alternatives in the credential and VM agent references |
| Extension stuck updating | Do not add extensions; use Portal/Serial Console/offline repair |