azure-diagnostics
Debug Azure production issues on Azure using AppLens, Azure Monitor, resource health, and safe triage. WHEN: debug production issues, troubleshoot app service, app service high CPU, app service deployment failure, troubleshoot container apps, troubleshoot functions, 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, service bus dead letter.
- License 许可
- MIT
- 最近更新
- 2026-08-19
- Stars
- ★ 2
- Forks
- 0
01 前言 Front Matter
- license
- MIT
- metadata
- { "author": "Microsoft", "version": "1.2.5" }
- description
- Debug Azure production issues on Azure using AppLens, Azure Monitor, resource health, and safe triage. WHEN: debug production issues, troubleshoot app service, app service high CPU, app service deployment failure, troubleshoot container apps, troubleshoot functions, 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, service bus dead letter.
02 资源文件 48
- 参考文档references/app-service/README.md7.2 KB
- 参考文档references/azure-resource-graph.md2.9 KB
- 参考文档references/container-apps/README.md2.9 KB
- 参考文档references/functions/README.md3.5 KB
- 参考文档references/kql-queries.md1.3 KB
- 脚本scripts/aks-baseline.ps17.0 KB
- 脚本scripts/aks-baseline.sh6.7 KB
- 脚本scripts/appservice-diagnostics.ps12.3 KB
- 脚本scripts/appservice-diagnostics.sh2.9 KB
- 脚本scripts/containerapp-diagnostics.ps12.1 KB
- 脚本scripts/containerapp-diagnostics.sh2.7 KB
- 脚本scripts/run-ig.ps15.6 KB
- 脚本scripts/run-ig.sh6.5 KB
- 脚本scripts/test-messaging-connectivity.ps16.3 KB
- 脚本scripts/test-messaging-connectivity.sh6.8 KB
- 参考文档troubleshooting/aks/aks-troubleshooting.md5.3 KB
- 参考文档troubleshooting/aks/general-diagnostics.md2.0 KB
- 参考文档troubleshooting/aks/load-balancer-and-ingress.md3.6 KB
- 参考文档troubleshooting/aks/network-policy.md832 B
- 参考文档troubleshooting/aks/networking.md5.5 KB
- 参考文档troubleshooting/aks/node-issues.md4.7 KB
- 参考文档troubleshooting/aks/pod-failures.md7.6 KB
- 参考文档troubleshooting/aks/references/aks-mcp.md1.5 KB
- 参考文档troubleshooting/aks/references/command-flows.md3.4 KB
- 参考文档troubleshooting/aks/references/inspektor-gadget.md7.6 KB
- 参考文档troubleshooting/aks/references/structured-input-modes.md1.5 KB
- 参考文档troubleshooting/aks/spot-and-zone-issues.md2.5 KB
- 参考文档troubleshooting/aks/upgrade-operations.md2.2 KB
- 参考文档troubleshooting/compute/references/cannot-connect-to-vm.md3.1 KB
- 参考文档troubleshooting/compute/references/credential-auth-errors.md2.3 KB
- 参考文档troubleshooting/compute/references/firewall-blocking.md2.3 KB
- 参考文档troubleshooting/compute/references/network-connectivity.md2.5 KB
- 参考文档troubleshooting/compute/references/rdp-connectivity.md2.7 KB
- 参考文档troubleshooting/compute/references/rdp-service-config.md3.2 KB
- 参考文档troubleshooting/compute/references/ssh-connectivity.md2.1 KB
- 参考文档troubleshooting/compute/references/vm-agent-not-responding.md3.6 KB
- 参考文档troubleshooting/compute/vm-troubleshooting.md3.3 KB
- 参考文档troubleshooting/messaging/auth-best-practices.md6.1 KB
- 参考文档troubleshooting/messaging/azure-eventhubs-dotnet.md3.5 KB
- 参考文档troubleshooting/messaging/azure-eventhubs-java.md3.2 KB
- 参考文档troubleshooting/messaging/azure-eventhubs-js.md2.7 KB
- 参考文档troubleshooting/messaging/azure-eventhubs-py.md4.3 KB
- 参考文档troubleshooting/messaging/azure-servicebus-dotnet.md2.5 KB
- 参考文档troubleshooting/messaging/azure-servicebus-java.md2.2 KB
- 参考文档troubleshooting/messaging/azure-servicebus-js.md2.4 KB
- 参考文档troubleshooting/messaging/azure-servicebus-py.md2.3 KB
- 参考文档troubleshooting/messaging/README.md1.6 KB
- 参考文档troubleshooting/messaging/service-troubleshooting.md5.1 KB
03 SKILL.md 正文
Azure Diagnostics
AUTHORITATIVE GUIDANCE — MANDATORY COMPLIANCE
This document is the official source for debugging and troubleshooting Azure production issues. Follow these instructions to diagnose and resolve common Azure service problems systematically.
Triggers
Activate this skill when user wants to:
- Debug or troubleshoot production issues
- Diagnose errors in Azure services
- Analyze application logs or metrics
- Fix image pull, cold start, or health probe issues
- Investigate why Azure resources are failing
- Find root cause of application errors
- Troubleshoot App Service issues (high CPU, deployment failures, crashes, slow responses, TLS/custom domains)
- Respond to prompts like "troubleshoot app service", "app service high CPU", or "app service deployment failure"
- Troubleshoot Azure Function Apps (invocation failures, timeouts, binding errors)
- Find the App Insights or Log Analytics workspace linked to a Function App
- Troubleshoot AKS clusters, nodes, pods, ingress, or Kubernetes networking issues
- Troubleshoot Azure VM connectivity issues (RDP/SSH failures, port 3389/22 timeouts, NSG or firewall blocking, credential resets)
- Troubleshoot Azure Messaging SDK issues (Event Hubs, Service Bus connection failures, AMQP errors, message lock issues)
Rules
- Start with systematic diagnosis flow
- Use AppLens (MCP) for AI-powered diagnostics when available
- Check resource health before deep-diving into logs
- Select appropriate troubleshooting guide based on service type
- Document findings and attempted remediation steps
- Route AKS incidents to the dedicated AKS troubleshooting document
Quick Diagnosis Flow
- Identify symptoms - What's failing?
- Check resource health - Is Azure healthy?
- Review logs - What do logs show?
- Analyze metrics - Performance patterns?
- Investigate recent changes - What changed?
Troubleshooting Guides by Service
| Service | Common Issues | Reference |
|---|---|---|
| Container Apps | Image pull failures, cold starts, health probes, port mismatches | container-apps/ |
| App Service | High CPU, deployment failures, crashes, slow responses, TLS/custom domains | app-service/ |
| Function Apps | App details, invocation failures, timeouts, binding errors, cold starts, missing app settings | functions/ |
| AKS | Cluster access, nodes, kube-system, scheduling, crash loops, ingress, DNS, upgrades |
AKS Troubleshooting |
| Compute | VM RDP/SSH connectivity, NSG/firewall blocks, credential resets, VM agent/tooling issues | VM Connectivity Troubleshooting |
| Messaging | Event Hubs & Service Bus SDK errors, AMQP failures, message lock, connectivity | Messaging Troubleshooting |
Routing
- Keep Container Apps and Function Apps diagnostics in this parent skill.
- Route active AKS incidents, AKS-specific intake, evidence gathering, and remediation guidance to AKS Troubleshooting.
- Route Azure VM RDP/SSH connectivity, NSG/firewall, credential reset, and VM agent troubleshooting to VM Connectivity Troubleshooting.
- Route Azure Messaging SDK troubleshooting (Event Hubs, Service Bus) to Messaging Troubleshooting.
Quick Reference
Common Diagnostic Commands
# Check resource health
az resource show --ids RESOURCE_ID
# View activity log
az monitor activity-log list -g RG --max-events 20
# Container Apps logs
az containerapp logs show --name APP -g RG --follow
# Function App logs (query App Insights traces)
az monitor app-insights query --apps APP-INSIGHTS -g RG \
--analytics-query "traces | where timestamp > ago(1h) | order by timestamp desc | take 50"
AppLens (MCP Tools)
For AI-powered diagnostics, use:
mcp_azure_mcp_applens
intent: "diagnose issues with <resource-name>"
command: "diagnose"
parameters:
resourceId: "<resource-id>"
Provides:
- Automated issue detection
- Root cause analysis
- Remediation recommendations
Azure Monitor (MCP Tools)
For querying logs and metrics:
mcp_azure_mcp_monitor
intent: "query logs for <resource-name>"
command: "logs_query"
parameters:
workspaceId: "<workspace-id>"
query: "<KQL-query>"
See kql-queries.md for common diagnostic queries.
Check Azure Resource Health
Using MCP
mcp_azure_mcp_resourcehealth
intent: "check health status of <resource-name>"
command: "get"
parameters:
resourceId: "<resource-id>"
Using CLI
# Check specific resource health
az resource show --ids RESOURCE_ID
# Check recent activity
az monitor activity-log list -g RG --max-events 20
References
04 同仓库更多 Skills
youtube-transcript
Extract transcripts from YouTube videos. Use when the user asks for a transcript, subtitles, or captions of a YouTube video and provides a YouTube URL (youtube.com/watch?v=, youtu.be/, or similar). Supports output with or without timestamps.
youtube-thumbnail-design
YouTube thumbnail design with specific dimensions, contrast rules, and mobile preview optimization. Covers safe zones, text placement, face expression psychology, and A/B testing. Use for: YouTube thumbnails, video cover images, click-through optimization. Triggers: youtube thumbnail, thumbnail design, video thumbnail, click through rate, ctr optimization, youtube cover, video cover image, thumbnail maker, thumbnail tips, youtube design, video preview image
youtube-short-maker
Make YouTube Shorts that hold attention with Pexo — vertical 9:16, fast-paced, hook in the first 3 seconds. Describe your topic and Pexo writes the script, generates the shots, picks the models, and assembles a finished Short with music and captions. Use for YouTube Shorts: "youtube short", "make a youtube short", "shorts video", "short-form video". NOT for long-form or landscape video.
xcode-project-setup
Safely modifies Xcode projects (.pbxproj) to add Swift Packages and link files. Use this skill whenever an iOS project needs dependencies installed (e.g. Firebase, Alamofire).
x402
Set up Browser Use Cloud payments with x402 — pay per request from a crypto wallet (USDC on Base mainnet), no signup or API key. Two setups it works out up front — "just use it" (set up a wallet so you or Claude Code can run cloud browser tasks paid from the wallet — Claude writes and runs throwaway scripts, nothing touches your codebase) or "build it in" (install the SDK and write the key + code into your project). Walks through wallet setup, funding, .env, and a ~$1 test run. Use when the user asks about x402, pay-per-use, USDC payments, or wants Browser Use Cloud without an API key. For the free-tier signup (reverse-CAPTCHA → API key), use `browser-use cloud signup` or the `cloud` skill instead.
x-twitter-scraper
Build GitHub Copilot workflows with Xquik X API SDKs, REST endpoints, hosted Apify Actor runs, MCP tools, TweetClaw OpenClaw plugin installs, signed webhooks, tweet search, user lookup, follower exports, media actions, and agent automation.