# Azure Diagnostics > Depura incidencias de producción en Azure con AppLens, Azure Monitor, resource health y triaje seguro. Cubre App Service, Container Apps, Functions, AKS, VMs y mensajería. Fuente: https://skillsagentes.com/skills/microsoft/azure-skills/azure-diagnostics Markdown: https://skillsagentes.com/skills/microsoft/azure-skills/azure-diagnostics.md Repositorio: https://github.com/microsoft/azure-skills Autor: microsoft Licencia: MIT Actualizado: el mes pasado Coste de contexto: 193 tok instalada, 1.6k tok al activarse, 46.7k tok con todos los archivos del bundle Bundle: 49 archivos, 183 KB Permisos que pide: ninguno declarado ## Instalación Un skill son archivos markdown: los mismos archivos valen para cualquier agente y lo único que cambia es el directorio de destino, es decir la bandera `--agent`. Añade `-g` para instalarlo en todos los proyectos de la máquina. ```bash # Claude Code npx -y skills add microsoft/azure-skills --skill azure-diagnostics --agent claude-code # Cursor npx -y skills add microsoft/azure-skills --skill azure-diagnostics --agent cursor # Codex npx -y skills add microsoft/azure-skills --skill azure-diagnostics --agent codex # Gemini CLI npx -y skills add microsoft/azure-skills --skill azure-diagnostics --agent gemini # Windsurf npx -y skills add microsoft/azure-skills --skill azure-diagnostics --agent windsurf # Cline npx -y skills add microsoft/azure-skills --skill azure-diagnostics --agent cline ``` ## Qué hace - Depura incidencias de producción en Azure usando AppLens, Azure Monitor, resource health y triaje seguro. - Cubre App Service (CPU alta, fallos de despliegue, TLS y dominios), Function Apps, AKS (nodos, pods, ingress, CoreDNS, crashloop) y VMs (RDP, SSH, NSG, reseteo de credenciales). - Localiza el workspace de App Insights o Log Analytics enlazado a una Function App. - Incluye diagnóstico del SDK de mensajería: fallos de conexión AMQP, pérdida de lock y dead letter. ## Cuándo usarla - Hay que depurar o diagnosticar incidencias en producción. - Hay que analizar logs o métricas, o escribir KQL. - Hay fallos de descarga de imagen, arranque en frío o sondas de salud. ## Qué la activa - "mi App Service tiene la CPU al 100%" - "no puedo conectar por RDP a la VM" - "los pods están en crashloop" - "encuentra la causa raíz de estos errores" ## Antes de instalar - Se apoya en AppLens, Azure Monitor y resource health; el análisis de logs se hace con consultas KQL. - Necesita en el PATH: awk, az, curl, kubectl, python3, sed - Variables de entorno: ALL_PODS, AZ_SUB_ARGS, CLUSTER, CONTAINER, DEBUG, DISPLAY_CMD, DNS_OK, DNS_RESULT, DRY_RUN, EXTRA_FILTERS, FILTERS, FQDN, FULL_CMD, GADGET, HTTPS_RESULT, IG_CMD, IG_IMAGE, IG_IMAGE_REPO, IG_VERSION, INCLUDE_KAFKA, LASTEXITCODE, NAMESPACE, NODE, P443, P5671, P5672, P9093, POSITIONAL, RESOLVED_IP, RESOURCE_GROUP, SUBSCRIPTION, SUB_ARGS, TCPDUMP_AVAIL, TIMEOUT, UNHEALTHY - makes network requests - reads environment config ## Archivos - SKILL.md — 6 KB - references/app-service/README.md — 7 KB - references/azure-resource-graph.md — 3 KB - references/container-apps/README.md — 3 KB - references/functions/README.md — 4 KB - references/kql-queries.md — 1 KB - scripts/aks-baseline.ps1 — 7 KB - scripts/aks-baseline.sh — 7 KB - scripts/appservice-diagnostics.ps1 — 2 KB - scripts/appservice-diagnostics.sh — 3 KB - scripts/containerapp-diagnostics.ps1 — 2 KB - scripts/containerapp-diagnostics.sh — 3 KB - scripts/run-ig.ps1 — 6 KB - scripts/run-ig.sh — 7 KB - scripts/test-messaging-connectivity.ps1 — 6 KB - scripts/test-messaging-connectivity.sh — 7 KB - troubleshooting/aks/aks-troubleshooting.md — 5 KB - troubleshooting/aks/general-diagnostics.md — 2 KB - troubleshooting/aks/load-balancer-and-ingress.md — 4 KB - troubleshooting/aks/network-policy.md — 832 B - troubleshooting/aks/networking.md — 5 KB - troubleshooting/aks/node-issues.md — 5 KB - troubleshooting/aks/pod-failures.md — 8 KB - troubleshooting/aks/references/aks-mcp.md — 2 KB - troubleshooting/aks/references/command-flows.md — 3 KB - troubleshooting/aks/references/inspektor-gadget.md — 8 KB - troubleshooting/aks/references/structured-input-modes.md — 1 KB - troubleshooting/aks/spot-and-zone-issues.md — 3 KB - troubleshooting/aks/upgrade-operations.md — 2 KB - troubleshooting/compute/references/cannot-connect-to-vm.md — 3 KB - troubleshooting/compute/references/credential-auth-errors.md — 2 KB - troubleshooting/compute/references/firewall-blocking.md — 2 KB - troubleshooting/compute/references/network-connectivity.md — 3 KB - troubleshooting/compute/references/rdp-connectivity.md — 3 KB - troubleshooting/compute/references/rdp-service-config.md — 3 KB - troubleshooting/compute/references/ssh-connectivity.md — 2 KB - troubleshooting/compute/references/vm-agent-not-responding.md — 4 KB - troubleshooting/compute/vm-troubleshooting.md — 3 KB - troubleshooting/messaging/README.md — 2 KB - troubleshooting/messaging/auth-best-practices.md — 6 KB - troubleshooting/messaging/azure-eventhubs-dotnet.md — 3 KB - troubleshooting/messaging/azure-eventhubs-java.md — 3 KB - troubleshooting/messaging/azure-eventhubs-js.md — 3 KB - troubleshooting/messaging/azure-eventhubs-py.md — 4 KB - troubleshooting/messaging/azure-servicebus-dotnet.md — 3 KB - troubleshooting/messaging/azure-servicebus-java.md — 2 KB - troubleshooting/messaging/azure-servicebus-js.md — 2 KB - troubleshooting/messaging/azure-servicebus-py.md — 2 KB - troubleshooting/messaging/service-troubleshooting.md — 5 KB ## SKILL.md Reproducido tal cual desde microsoft/azure-skills bajo MIT. Esta sección es el documento original y está en inglés. # 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 1. Start with systematic diagnosis flow 2. Use AppLens (MCP) for AI-powered diagnostics when available 3. Check resource health before deep-diving into logs 4. Select appropriate troubleshooting guide based on service type 5. Document findings and attempted remediation steps 6. Route AKS incidents to the dedicated AKS troubleshooting document --- ## Quick Diagnosis Flow 1. **Identify symptoms** - What's failing? 2. **Check resource health** - Is Azure healthy? 3. **Review logs** - What do logs show? 4. **Analyze metrics** - Performance patterns? 5. **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/](references/container-apps/README.md) | | **App Service** | High CPU, deployment failures, crashes, slow responses, TLS/custom domains | [app-service/](references/app-service/README.md) | | **Function Apps** | App details, invocation failures, timeouts, binding errors, cold starts, missing app settings | [functions/](references/functions/README.md) | | **AKS** | Cluster access, nodes, `kube-system`, scheduling, crash loops, ingress, DNS, upgrades | [AKS Troubleshooting](troubleshooting/aks/aks-troubleshooting.md) | | **Compute** | VM RDP/SSH connectivity, NSG/firewall blocks, credential resets, VM agent/tooling issues | [VM Connectivity Troubleshooting](troubleshooting/compute/vm-troubleshooting.md) | | **Messaging** | Event Hubs & Service Bus SDK errors, AMQP failures, message lock, connectivity | [Messaging Troubleshooting](troubleshooting/messaging/README.md) | --- ## 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](troubleshooting/aks/aks-troubleshooting.md). - Route Azure VM RDP/SSH connectivity, NSG/firewall, credential reset, and VM agent troubleshooting to [VM Connectivity Troubleshooting](troubleshooting/compute/vm-troubleshooting.md). - Route Azure Messaging SDK troubleshooting (Event Hubs, Service Bus) to [Messaging Troubleshooting](troubleshooting/messaging/README.md). --- ## Quick Reference ### Common Diagnostic Commands ```bash # 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 " command: "diagnose" parameters: resourceId: "" 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 " command: "logs_query" parameters: workspaceId: "" query: "" ``` See [kql-queries.md](references/kql-queries.md) for common diagnostic queries. --- ## Check Azure Resource Health ### Using MCP ``` mcp_azure_mcp_resourcehealth intent: "check health status of " command: "get" parameters: resourceId: "" ``` ### Using CLI ```bash # Check specific resource health az resource show --ids RESOURCE_ID # Check recent activity az monitor activity-log list -g RG --max-events 20 ``` --- ## References - [KQL Query Library](references/kql-queries.md) - [Azure Resource Graph Queries](references/azure-resource-graph.md) - [App Service Troubleshooting](references/app-service/README.md) - [Function Apps Troubleshooting](references/functions/README.md) - [VM Connectivity Troubleshooting](troubleshooting/compute/vm-troubleshooting.md) - [Messaging Troubleshooting](troubleshooting/messaging/README.md) ## Dónde encaja - Categoría: [DevOps e infraestructura](https://skillsagentes.com/categorias/devops-infraestructura.md) — Despliegues, contenedores, IaC y flujos de gestión de incidentes. - Creador: [microsoft](https://skillsagentes.com/creators/microsoft.md) — 43 skills en el directorio - [Todas las skills](https://skillsagentes.com/skills.md) - [Ranking de instalaciones](https://skillsagentes.com/ranking.md) ## Otras skills del mismo repositorio - [Microsoft Foundry](https://skillsagentes.com/skills/microsoft/azure-skills/microsoft-foundry.md): Despliega, evalúa, ajusta y gestiona agentes de Foundry de punta a punta con azd: agentes hospedados, evaluación por lotes y continua, optimizador de prompts y fine-tuning (SFT/DPO/RFT). - [Azure Prepare](https://skillsagentes.com/skills/microsoft/azure-skills/azure-prepare.md): Prepara proyectos Azure basados en azd para desplegar: genera azure.yaml, la infraestructura (Bicep o Terraform) y los Dockerfiles del flujo del Azure Developer CLI. - [Azure Validate](https://skillsagentes.com/skills/microsoft/azure-skills/azure-validate.md): Validación previa al despliegue en Azure. Comprueba en profundidad la configuración, la infraestructura (Bicep o Terraform), los roles RBAC, los permisos de identidad administrada y los prerrequisitos. - [Azure App Onboard](https://skillsagentes.com/skills/microsoft/azure-skills/azure-app-onboard.md): Orquestador de punta a punta: de una idea o una app existente hasta un despliegue en Azure, con estimación de costes y aprobación previa. Analiza tu app y detecta los servicios adecuados. - [Deploy Model](https://skillsagentes.com/skills/microsoft/azure-skills/deploy-model.md): Skill unificado de despliegue de modelos de Azure OpenAI con enrutado por intención: despliegues rápidos con preset, despliegues personalizados y descubrimiento de capacidad entre regiones y proyectos. ## Skills relacionadas - [Airunway Aks Setup](https://skillsagentes.com/skills/microsoft/azure-skills/airunway-aks-setup.md): Instala AI Runway sobre AKS, de un clúster desnudo a un modelo funcionando: verificación del clúster, instalación del controlador, evaluación de GPU, configuración del proveedor y primer despliegue. - [Appinsights Instrumentation](https://skillsagentes.com/skills/microsoft/azure-skills/appinsights-instrumentation.md): Guía para instrumentar aplicaciones web con Azure Application Insights: patrones de telemetría, configuración del SDK y referencias. Para añadirlo a tu app, usa azure-prepare. - [Azure App Onboard](https://skillsagentes.com/skills/microsoft/azure-skills/azure-app-onboard.md): Orquestador de punta a punta: de una idea o una app existente hasta un despliegue en Azure, con estimación de costes y aprobación previa. Analiza tu app y detecta los servicios adecuados. - [Azure App Onboard Prereq](https://skillsagentes.com/skills/microsoft/azure-skills/azure-app-onboard-prereq.md): Evalúa si tu código está listo para desplegar en Azure, antes del trabajo de infraestructura: salud del build, dependencias, compatibilidad del stack y bloqueantes de despliegue. - [Azure Cloud Migrate](https://skillsagentes.com/skills/microsoft/azure-skills/azure-cloud-migrate.md): Evalúa y migra cargas de trabajo de otras nubes a Azure con informes y conversión de código. Soporta Lambda→Functions, Beanstalk/Heroku/App Engine→App Service y Fargate/Kubernetes/Cloud Run→Container Apps. --- Skills Agentes · [Índice de páginas en markdown](https://skillsagentes.com/sitemap.md) · [Inicio](https://skillsagentes.com/index.md)