Habilidades azure-diagnostics

📦

azure-diagnostics

Name: azure-diagnostics
Author: microsoft

Seguro

Depurar Problemas de Produção do Azure

Esta skill ajuda desenvolvedores a diagnosticar e solucionar problemas de produção no Azure, fornecendo fluxos de depuração estruturados, comandos de diagnóstico e consultas KQL para Container Apps.

Suporta: Claude Codex Code(CC)

📊 69 Adequado

Baixar o ZIP da skill

Upload no Claude

Vá em Configurações → Capacidades → Skills → Upload skill

Ative e comece a usar

Testar

A utilizar "azure-diagnostics". Meu Container App mostra status 'Running' mas retorna erros 502

Resultado esperado:

Verificar se a configuração targetPort do ingress corresponde à porta de escuta do seu aplicativo
Verificar se o endpoint de saúde retorna HTTP 200
Revisar logs de inicialização do contêiner para erros
Garantir que o EXPOSE do Dockerfile corresponda à configuração de ingress

A utilizar "azure-diagnostics". Escrever uma consulta KQL para encontrar solicitações com falha

Resultado esperado:

AppRequests
| where Success == false
| where TimeGenerated > ago(1h)
| summarize count() by Name, ResultCode
| order by count_ desc

Auditoria de Segurança

Seguro

v1 • 2/20/2026

This skill contains only documentation with example Azure CLI commands and KQL queries. Static scanner flagged 70 instances of 'external_commands' but these are markdown code blocks showing example commands, not executable code. Network findings are documentation URLs. Env access findings reference standard Azure Container Apps environment variables. All high/critical findings are false positives - the skill is safe for publication.

Arquivos analisados

393

Linhas analisadas

achados

Total de auditorias

Problemas Críticos (1)

multiple:1

False Positive: Dangerous Combination Heuristic

Scanner flagged 'Code execution + Network + Credential access' pattern. This is a documentation skill with no executable code. The 'external_commands' findings are Azure CLI examples in markdown code blocks. Network findings are documentation URLs. No credential access exists.

Problemas de Alto Risco (1)

SKILL.md:3 SKILL.md:45 SKILL.md:78 references/kql-queries.md:19 references/kql-queries.md:30 references/kql-queries.md:41

False Positive: Weak Cryptographic Algorithm

Scanner flagged 'Weak cryptographic algorithm' in KQL query files. This is a false positive - the scanner misinterprets KQL keywords like 'where', 'state' as cryptographic terms. These are Kusto Query Language queries for log analysis.

Problemas de Risco Médio (3)

SKILL.md:57-120 references/azure-resource-graph.md:3-93 references/container-apps/README.md:7-105 references/kql-queries.md:14-60

False Positive: External Commands in Documentation

Scanner flagged 70 instances of 'Ruby/shell backtick execution'. These are Azure CLI commands shown in markdown code blocks as documentation examples. The skill is a documentation reference - it shows users example commands but does not execute them.

references/container-apps/README.md:62 references/kql-queries.md:64-65

False Positive: Hardcoded URLs

Scanner flagged 3 hardcoded URLs. These are legitimate Microsoft Learn documentation links and example curl commands for health check endpoints.

references/container-apps/README.md:81

False Positive: Environment Variable Access

Scanner flagged 'process.env.PORT' as sensitive. This is standard Azure Container Apps documentation showing how to read the container port from environment variables.

Auditado por: claude

Pontuação de qualidade

Arquitetura

100

Manutenibilidade

Conteúdo

Comunidade

Segurança

Conformidade com especificações

O Que Você Pode Construir

Depurar falhas de pull de imagem do Container App

Diagnosticar por que uma imagem de contêiner falha ao ser pullada do Azure Container Registry e obter comandos de correção passo a passo

Analisar logs de aplicação com KQL

Consultar o Application Insights para encontrar erros recentes, solicitações com falha e problemas de desempenho lento

Corrigir problemas de timeout de inicialização a frio

Identificar e resolver problemas de primeira solicitação lenta no Azure Container Apps ajustando configurações de réplicas

Tente Estes Prompts

Solicitação de diagnóstico básica

Meu Azure Container App está falhando ao iniciar. Ajude-me a diagnosticar o problema usando a skill azure-diagnostics.

Solução de problemas de falha de pull de imagem

Estou tendo erros de pull de imagem no meu Container App. Como corrijo problemas de autenticação do ACR?

Análise de logs com KQL

Ajude-me a escrever consultas KQL para encontrar erros nos meus logs do Application Insights da última hora.

Investigação de probe de saúde

Meu contêiner continua reiniciando devido a falhas de probes de saúde. O que devo verificar?

Melhores Práticas

Comece com verificações de saúde de recursos antes de se aprofundar em logs detalhados
Use fluxo de diagnóstico sistemático: sintomas -> saúde -> logs -> métricas -> alterações
Aproveite o AppLens MCP para análise de causa raiz orientada por IA quando disponível
Documente todas as etapas de remediação tentadas para referência futura

Evitar

Não pule verificações de saúde ao investigar reinicializações de contêineres
Não assuma a saúde do serviço do Azure sem verificar HealthResources primeiro
Não ignore falhas de estado de provisionamento - estas indicam problemas de implantação

Perguntas Frequentes

O que esta skill realmente faz?

Esta skill fornece guias de solução de problemas, comandos de diagnóstico e consultas KQL para Azure Container Apps. Ela não executa comandos, mas ensina você a diagnosticar problemas.

Esta skill pode corrigir meus problemas do Azure?

Não. Esta skill fornece orientação e comandos que você pode executar. Você mesmo deve executar os comandos da CLI do Azure usando suas credenciais do Azure.

Quais serviços do Azure são suportados?

Atualmente cobre diagnóstico do Azure Container Apps, incluindo problemas de pull de imagem, inicialização a frio e probes de saúde. Mais serviços em breve.

Preciso ter a CLI do Azure instalada?

Sim, você precisa ter a CLI do Azure instalada para executar os comandos de diagnóstico mostrados. A skill fornece os comandos, mas você deve ter a CLI do Azure configurada.

O que é AppLens?

AppLens é uma ferramenta MCP do Azure que fornece diagnósticos orientados por IA. Ela pode detectar automaticamente problemas e sugerir etapas de remediação.

Como consulto o Azure Resource Graph?

Use a ferramenta MCP extension_cli_generate com a intent 'query Azure Resource Graph' ou construa comandos az graph query com KQL.