Pular para o conteúdo
Skillpedia
Deploy e nuvem (DevOps)40 mil · #5017

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

https://github.com/github/awesome-copilot/blob/main/skills/aws-resource-health-diagnose/SKILL.md

Mensagem pronta para colar

Use esta skill para me ajudar: https://github.com/github/awesome-copilot/blob/main/skills/aws-resource-health-diagnose/SKILL.md Leia o arquivo SKILL.md desse link e siga as instruções dele na minha tarefa.
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-diagnose

Ou baixe só o arquivo:

curl -L https://raw.githubusercontent.com/github/awesome-copilot/main/skills/aws-resource-health-diagnose/SKILL.md -o SKILL.md
Conteú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

Essa skill é útil?

0

Entre para votar.

Comentários

  • …

Mais skills deste repositório

Skills parecidas