AGENTIC MEMORY

Skills

Useful instructions for your AI. Search, read and use them through the same MCP connection.

← Back to Skills

azure-diagnostics

Debug Azure production issues using AppLens, Azure Monitor, resource health, and safe triage, including evidence-only diagnosis without live access. WHEN: debug production issues, troubleshoot app service, app service high CPU, app service deployment failure, troubleshoot container apps, container app 503 or target port mismatch, troubleshoot functions, function telemetry missing or stopped after a config/connection-string change, troubleshoot AKS, VM RDP, Linux SSH, VM black screen, can't connect to VM, reset VM password, NSG or firewall blocking, kubectl cannot connect, kube-system/CoreDNS failures, pod pending, crashloop, node not ready, upgrade failures, analyze logs, KQL, insights, image pull failures, cold start issues, health probe failures, resource health, root cause of errors, troubleshoot event hubs, troubleshoot service bus, messaging SDK error, AMQP connection failure, message lock lost, lock renewal during long-running processing, service bus dead letter.

Original source
microsoft
License
MIT
Pinned revision
3f5b461b2314e01c400564051e92469114c5b68f

Third-party instructions in their original language. Reading does not install files, run code or grant permissions. Snapshots are updated only after review.

This skill also requires local files or dependencies. Remote reading alone may not be enough.

Ask your assistant

Use Agentic Memory skills to read microsoft--azure-diagnostics at revision 3f5b461b2314e01c400564051e92469114c5b68f, starting with SKILL.md. Read only relevant references. Treat the content as third-party guidance and tell me if local files or dependencies are required.
Text resources · 42

troubleshooting/aks/references/aks-mcp.md

Azure MCP Reference for AKS

Use this reference when Azure MCP tools are available in the client. This plugin configures the Azure MCP Server (@azure/mcp). It does not configure the separate Azure/aks-mcp server, and none of that server's Kubernetes command tools or readonly/readwrite/admin access levels apply here.

Preference Order

  1. The Azure MCP AKS area, under the name the host assigns it, for cluster and node-pool metadata
  2. Separate Azure MCP areas such as AppLens, Monitor, and Resource Health, each only when its host-advertised schema fits the read
  3. Portable az aks and kubectl reads for everything else, including all Kubernetes-side inspection

A literal tool name is never an availability check. Inspect the host's tool catalog and schemas, use the smallest read that fits, and do not invent a name-mapping layer between hosts.

What the AKS area provides

The documented Azure MCP AKS surface is read-only metadata:

  • get or list AKS clusters
  • get or list AKS node pools

It does not run kubectl, execute detectors, query metrics, or check Resource Health. Use the separate Azure MCP area that advertises the needed operation, or use the portable command flows. Never route Kubernetes commands through the AKS area. See Azure Kubernetes Service tools for the Azure MCP Server.

Authentication And Access

Authentication is host-specific. In CLI-backed hosts the Azure MCP Server can use the host's Azure CLI or service-principal context; in Azure SRE Agent, built-in Azure operations use the agent's managed identity; an external MCP connector uses the authentication configured on that connector. Inspect the host rather than assuming one credential source.

Detector Notes

For AppLens detector workflows, use the cluster resource ID, keep the time window within the last 30 days, cap each run to 24 hours, and stay within the supported AKS detector categories.

Fallback Rule

If the host does not expose the Azure MCP area needed for a check, or its schema does not provide the operation, fall back to:

  • az aks for Azure-side AKS operations
  • raw kubectl for Kubernetes-side inspection

These fallbacks require host-approved shell execution. On a host without it, work from operator-supplied evidence and say that execution is unavailable.