ASD

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.

Oficial
Estrellas
1.4k

en todo el repo

Actividad
66

0–100, la ruta de este skill

Actualizado
hace 4 días

último commit aquí

Commits
6

últimos 90 días

Contexto
1.6k tok

193 tok en reposo

Paquete
49 archivos

183 KB

Instalar

Funciona con cualquier agente que lea SKILL.md

npx -y skills add microsoft/azure-skills --skill azure-diagnostics --agent claude-code

Se instala solo en este repositorio.

Este skill makes network requests, reads environment config.

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.

Úsalo cuando

  • 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.

No lo uses cuando

    Qué lo activa

    Di cualquiera de estas frases y el agente debería cargar este skill.

    • 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

    SKILL.md

    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/
    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

    Reproducido de microsoft/azure-skills bajo licencia MIT. Leer esta página en markdown.

    Archivos

    49 archivos en el paquete. Solo se lee SKILL.md al activarse — las referencias se cargan si el skill decide que las necesita.

    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:awkazcurlkubectlpython3sed

    Variables de entorno:ALL_PODSAZ_SUB_ARGSCLUSTERCONTAINERDEBUGDISPLAY_CMDDNS_OKDNS_RESULTDRY_RUNEXTRA_FILTERSFILTERSFQDNFULL_CMDGADGETHTTPS_RESULTIG_CMDIG_IMAGEIG_IMAGE_REPOIG_VERSIONINCLUDE_KAFKALASTEXITCODENAMESPACENODEP443P5671P5672P9093POSITIONALRESOLVED_IPRESOURCE_GROUPSUBSCRIPTIONSUB_ARGSTCPDUMP_AVAILTIMEOUTUNHEALTHY

    Detalles

    Creador
    microsoft
    Licencia
    MIT
    Recursos incluidos
    scripts en bash + referencias
    Código fuente
    Ver SKILL.md

    Etiquetas

    Más de microsoft/azure-skills

    Este repo incluye 41 skills. Si instalas uno, normalmente ya tienes los demás.

    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).

    Costo de contexto al activarse
    6.5k tok
    Tamaño del paquete
    185 archivos
    Última actualización
    hace 3 días
    Oficialherramientas desarrollo

    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.

    Costo de contexto al activarse
    3.2k tok
    Tamaño del paquete
    164 archivos
    Última actualización
    hace 4 días
    Oficialdevops infraestructura

    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.

    Costo de contexto al activarse
    901 tok
    Tamaño del paquete
    27 archivos
    Última actualización
    hace 4 días
    Oficialdevops infraestructura

    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.

    Costo de contexto al activarse
    1.8k tok
    Tamaño del paquete
    17 archivos
    Última actualización
    hace 4 días
    Oficialdevops infraestructura

    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.

    Costo de contexto al activarse
    1.6k tok
    Tamaño del paquete
    68 archivos
    Última actualización
    hace 4 días
    Oficialdevops infraestructura

    Planifica, crea y configura clústeres AKS listos para producción: checklist Day-0, elección de SKU (Automatic o Standard), redes, seguridad y operaciones (autoescalado, upgrades, costes).

    Costo de contexto al activarse
    2.7k tok
    Tamaño del paquete
    53 archivos
    Última actualización
    hace 4 días
    Oficialdevops infraestructura

    Skills relacionados

    Fase 2 del pipeline azure-app-onboard: mapea los componentes de la app a servicios de Azure con estimación de costes y validación de cuota. No es invocable directamente.

    Costo de contexto al activarse
    1.6k tok
    Tamaño del paquete
    13 archivos
    Última actualización
    hace 21 días
    Oficialdevops infraestructura

    Despliega una app web o API existente en un clúster AKS ya en marcha: detecta el framework, genera Dockerfile y manifiestos, valida contra los Deployment Safeguards y despliega con verificación.

    Costo de contexto al activarse
    503 tok
    Tamaño del paquete
    42 archivos
    Última actualización
    hace 4 días
    Oficialdevops infraestructura

    Deploy

    1.4k

    Fase 4 del pipeline azure-app-onboard: ejecuta la IaC validada contra Azure y verifica la salud de los recursos desplegados. No es invocable directamente.

    Costo de contexto al activarse
    1.8k tok
    Tamaño del paquete
    16 archivos
    Última actualización
    hace 21 días
    Oficialdevops infraestructura