aws-resource-health-diagnose
Ajuda seu agente a diagnosticar problemas de saúde em recursos AWS. Ele analisa logs e métricas para criar um plano de correção.
O que ela faz
Esta ferramenta ajuda a verificar a saúde de recursos na nuvem da Amazon (AWS), identificar problemas usando registros e métricas, e sugere um plano para consertá-los.
Quando usar
- ✓Quando um serviço AWS não está funcionando como esperado.
- ✓Para entender por que um recurso AWS está lento ou com erros.
- ✓Antes de fazer mudanças importantes para verificar a saúde atual.
Exemplo do que pedir para a IA
“Verifique a saúde da minha função Lambda chamada 'minha-funcao-api' e me diga como corrigir quaisquer problemas.”
Quer saber mais? Abra as seções abaixo.
Como usar
O jeito mais fácil: copie a mensagem abaixo e cole no Claude, ChatGPT, Cursor ou outra IA. Ela lê a skill e segue as instruções.
Link da skill
Mensagem pronta para colar
Como funciona
A ferramenta primeiro busca informações gerais sobre como monitorar e resolver problemas na AWS. Depois, ela encontra o recurso que você especificou e verifica seu status atual e métricas importantes. Por fim, ela analisa os registros de erros e sugere passos para corrigir os problemas encontrados.
Instalação
Jeito mais fácil: copie o link da skill e cole no Claude, ChatGPT ou Cursor pedindo para seguir as instruções.
No terminal (Claude Code, Codex, Cursor), na pasta do projeto:
npx skills add github/awesome-copilot --skill aws-resource-health-diagnoseOu baixe só o arquivo:
curl -L https://raw.githubusercontent.com/github/awesome-copilot/main/skills/aws-resource-health-diagnose/SKILL.md -o SKILL.mdConteúdo técnico (SKILL.md)
Tradução do texto original do autor no GitHub. Os comandos e códigos estão como no original.
Saúde de Recursos AWS e Diagnóstico de Problemas
Este fluxo de trabalho analisa um recurso AWS específico para avaliar seu status de saúde, diagnosticar problemas potenciais usando logs e métricas do CloudWatch e desenvolver um plano de remediação abrangente para quaisquer problemas descobertos.
Pré-requisitos
- AWS CLI configurado e autenticado
- Recurso AWS alvo identificado (nome, tipo e, opcionalmente, região/conta)
- Logs e métricas do CloudWatch habilitados no recurso alvo
Etapas do Fluxo de Trabalho
Etapa 1: Obter Melhores Práticas de Diagnóstico AWS
Busque https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/ para orientação de monitoramento e solução de problemas para informar a abordagem de diagnóstico.
Etapa 2: Descoberta e Identificação de Recursos
Localize o recurso alvo usando o comando AWS CLI apropriado para seu tipo:
# EC2
aws ec2 describe-instances --filters "Name=tag:Name,Values=<name>"
# Lambda
aws lambda get-function --function-name <name>
# RDS
aws rds describe-db-instances --db-instance-identifier <name>
# ECS
aws ecs describe-services --cluster <cluster> --services <name>
# ALB
aws elbv2 describe-load-balancers --names <name>
# DynamoDB
aws dynamodb describe-table --table-name <name>
# SQS
aws sqs get-queue-attributes --queue-url <url> --attribute-names All
# API Gateway
aws apigatewayv2 get-apis
Se várias correspondências forem encontradas, solicite ao usuário que especifique a região/conta.
Etapa 3: Avaliação do Status de Saúde
Execute verificações de saúde específicas do serviço:
# EC2
aws ec2 describe-instance-status --instance-ids <id>
# RDS
aws rds describe-db-instances --db-instance-identifier <name> \
--query 'DBInstances[0].DBInstanceStatus'
# Lambda - error rate over 24h
aws cloudwatch get-metric-statistics --namespace AWS/Lambda \
--metric-name Errors --dimensions Name=FunctionName,Value=<name> \
--start-time $(date -u -d '24 hours ago' +%Y-%m-%dT%H:%M:%SZ) \
--end-time $(date -u +%Y-%m-%dT%H:%M:%SZ) \
--period 3600 --statistics Sum
# ECS
aws ecs describe-services --cluster <cluster> --services <name> \
--query 'services[0].[status,runningCount,desiredCount,pendingCount]'
Principais indicadores de saúde por tipo de serviço:
- Lambda: Taxa de erros, taxa de throttling, duração P99, execuções simultâneas
- RDS: Utilização de CPU, Espaço Livre de Armazenamento, Conexões de Banco de Dados, Latência de Leitura/Latência de Gravação
- ECS: Contagem de tarefas em execução vs. desejada, motivo de parada da tarefa
- ALB: Tempo de Resposta do Destino, Contagem de Códigos HTTP_ELB_5XX, Contagem de Hosts Não Saudáveis
- SQS: Número Aproximado de Mensagens Não Visíveis, Idade Aproximada da Mensagem Mais Antiga
- DynamoDB: Unidades de Capacidade de Leitura Consumidas, Requisições Throttled, Latência de Requisição Bem-Sucedida
Etapa 4: Análise de Logs e Métricas
Encontre grupos de logs e execute consultas do CloudWatch Logs Insights:
# Find log groups
aws logs describe-log-groups --log-group-name-prefix /aws/<service>/<name>
# Start a query (last 24h errors)
aws logs start-query \
--log-group-name /aws/lambda/<name> \
--start-time $(date -u -d '24 hours ago' +%s) \
--end-time $(date -u +%s) \
--query-string 'filter @message like /ERROR/ | stats count(*) as errorCount by bin(1h)'
# Get results
aws logs get-query-results --query-id <id>
# Lambda cold starts
aws logs start-query \
--log-group-name /aws/lambda/<name> \
--start-time $(date -u -d '24 hours ago' +%s) \
--end-time $(date -u +%s) \
--query-string 'filter @type = "REPORT" | filter @initDuration > 0 | stats count() as coldStarts by bin(1h)'
# RDS Performance Insights (if enabled)
aws pi get-resource-metrics \
--service-type RDS --identifier db:<identifier> \
--metric-queries '[{"Metric":"db.load.avg"}]' \
--start-time $(date -u -d '24 hours ago' +%Y-%m-%dT%H:%M:%SZ) \
--end-time $(date -u +%Y-%m-%dT%H:%M:%SZ) \
--period-in-seconds 3600
Identifique: padrões de erro recorrentes, correlação com implantações (CloudTrail), tendências de desempenho, falhas de dependência.
Etapa 5: Classificação de Problemas e Análise de Causa Raiz
Gravidade:
- Crítico: Serviço indisponível, perda de dados, incidentes de segurança
- Alto: Degradação de desempenho, taxas de erro >5%, falhas intermitentes
- Médio: Avisos, configuração subótima, problemas de desempenho menores
- Baixo: Alertas informativos, oportunidades de otimização
Categorias de Causa Raiz:
- Problemas de Configuração: configurações incorretas, variáveis de ambiente ausentes, negações de permissão IAM
- Restrições de Recursos: limites de CPU/memória/disco, throttling do Lambda, esgotamento de conexões RDS
- Problemas de Rede: regras de grupo de segurança, roteamento VPC, DNS, NACLs
…
Perguntas frequentes
O que são 'logs' e 'métricas'?
Logs são como diários de bordo que registram o que aconteceu em um serviço. Métricas são dados numéricos que mostram o desempenho, como uso de processador ou número de erros.
Preciso ter alguma coisa configurada antes de usar?
Sim, você precisa ter as ferramentas da AWS configuradas no seu computador e o serviço que você quer verificar precisa estar enviando logs e métricas para o CloudWatch.
Quais tipos de recursos AWS ela pode verificar?
Ela pode verificar vários tipos, como EC2 (servidores virtuais), Lambda (funções sem servidor), RDS (bancos de dados), ECS (contêineres), ALB (balanceadores de carga), DynamoDB (banco de dados NoSQL), SQS (filas de mensagens) e API Gateway.
Detalhes
Descrição original do autor
Analyze AWS resource health, diagnose issues from CloudWatch logs and metrics, and create a remediation plan for identified problems.
repo: github/awesome-copilot
Popularidade
- Estrelas no GitHub
- 40 mil
- Posição no ranking
- #5017
- Licença
- MIT
- Atualizada em
- 15/10/2026
Comentários
- …
Mais skills deste repositório
acquire-codebase-knowledge
Ajuda seu agente a entender e documentar um projeto de código existente. É útil para novas pessoas entrarem no projeto ou para ter uma visão geral da arquitetura.
github/awesome-copilot
acreadiness-assess
Faz seu agente avaliar a prontidão de um projeto para IA e gerar um relatório. É útil para entender o quão bem um projeto está preparado para usar ferramentas de IA.
github/awesome-copilot
acreadiness-generate-instructions
Ajuda seu agente a criar instruções para ferramentas de IA baseadas em uma avaliação. É útil para melhorar a forma como a IA interage com o código e fecha lacunas identificadas.
github/awesome-copilot
acreadiness-policy
Faz seu agente ajudar a definir ou aplicar políticas para avaliação de projetos de IA. É útil para padronizar a forma como os projetos são avaliados e garantir conformidade.
github/awesome-copilot
Skills parecidas
bun-runtime
Faz seu agente usar o Bun para rodar, organizar e testar código. Ajuda a escolher o Bun em vez de outras ferramentas e a migrar projetos existentes.
affaan-m/ECC
database-migrations
Ajuda seu agente a fazer mudanças seguras em bancos de dados. Ele garante que as alterações possam ser desfeitas e minimiza o tempo de inatividade.
affaan-m/ECC
deployment-patterns
Configura fluxos de implantação e CI/CD, containerização e estratégias de rollback para garantir lançamentos seguros.
affaan-m/ECC