Uma ferramenta baseada em terminal que funciona como uma verificação abrangente de saúde para suas contas AWS. Construído com Golang, aws-doctor diagnostica anomalias de custo, detecta recursos ociosos e fornece uma análise proativa da sua infraestrutura em nuvem.

[!TIP] Veja a documentação completa, guia de permissões e exemplos de uso em awsdoctor.compacompila.com

👀 Visão rápida

⚖️ Análise Comparativa de Custos

📈 Análise de Tendência de 6 Meses

🧟 Detecção de Desperdício

Suporta varredura seletiva: aws-doctor waste ec2 s3 cloudwatch rds vpc lambda sagemaker elb ecr secrets-manager iam

• Interface de Terminal Interativa: Navegue facilmente pelas categorias de desperdício detectadas usando as setas do teclado ou teclas Tab, com uma visão agregada de Resumo.
• Degradação Suave: Rodando em CI/CD? O aws-doctor detecta automaticamente se está sendo redirecionado ou canalizado e recua graciosamente para tabelas estáticas.

📄 Relatórios Profissionais

O aws-doctor agora pode gerar relatórios PDF profissionais e detalhados, prontos para as partes interessadas. Os relatórios incluem cabeçalhos personalizados, tabelas estilizadas e análises abrangentes de custo/desperdício.

[!TIP] Veja exemplos de relatórios PDF e detalhes em awsdoctor.compacompila.com/docs/reporting/

Gerar um Relatório de Comparação de Custos

Gerar um Relatório de Análise de Desperdício

Gerar um Relatório de Tendência

[!TIP] Argumentos de subcomando: Assim como os comandos de terminal, report waste aceita verificações específicas (ex.: ec2, s3, rds, lambda) e report trend aceita nomes de serviços específicos.

[!TIP] Por padrão, os relatórios são salvos na sua pasta Documentos. Use a flag --path para especificar um diretório ou nome de arquivo personalizado: aws-doctor report cost --path ./billing-analysis.pdf

🚀 Instalação

Homebrew (macOS/Linux):

Script de Uma Linha (macOS/Linux):

Windows (PowerShell):

Usando Go:

✨ Principais Funcionalidades

• 📄 Relatórios PDF Profissionais: Gere documentos PDF personalizados e prontos para compartilhar para custos, tendências e análise de desperdício.
• 📉 Comparação Justa de Custos: Compara janelas de tempo idênticas entre meses para identificar anomalias reais.
• 🧟 Descoberta de Zumbis: Varre por EIPs ociosos, instâncias paradas, instâncias EC2 em execução ociosas, snapshots órfãos, instâncias RDS ociosas, NAT Gateways ociosos, Load Balancers ociosos, memória Lambda superdimensionada, endpoints de inferência em tempo real SageMaker ociosos, repositórios ECR com imagens sem tag, políticas de ciclo de vida ausentes ou sem imagens, segredos Secrets Manager não utilizados e usuários IAM não utilizados ou contas Root sem MFA. Suporta filtragem seletiva de serviços (ec2, s3, elb, cloudwatch, rds, vpc, lambda, sagemaker, ecr, secrets-manager, iam).
• 📊 Tendências de 6 Meses: Visualização ANSI de alta fidelidade da sua velocidade de gastos.
• 📤 Múltiplos Formatos de Saída: Exporte resultados em table, json ou csv para fácil integração com outras ferramentas ou relatórios.
• 🔔 Notificações de Atualização: Verifica automaticamente por novas versões em segundo plano e notifica você após a saída do comando.
• 🚀 Cache Eficiente: Usa um serviço de cache local para minimizar chamadas de rede redundantes. Atualmente usado para notificações de verificação de versão (TTL de 2 horas) e previsto para expansão para dados de preços e outros fluxos pesados.
• 🔐 Pronto para MFA: Suporte nativo para perfis que exigem Autenticação Multifator.
• 🌍 Preços Cientes de Região: Consulta a API de Preços da AWS na inicialização para usar tarifas da região configurada, recorrendo aos padrões us-east-1 se a API estiver indisponível. Requer pricing:GetProducts na política IAM do chamador; sem isso, as estimativas recaem silenciosamente para os padrões.

💡 Motivação

Como Arquiteto de Nuvem, frequentemente preciso verificar custos e informações de faturamento da AWS. Embora o Console AWS forneça dados brutos, falta o contexto imediato que preciso para responder à pergunta: "Estamos gastando de forma eficiente?"

Criei o *aws-doctor* para preencher essa lacuna. Ele não apenas mostra a conta; atua como uma ferramenta de diagnóstico que ajuda a entender *para onde* o dinheiro está indo e *o que* pode ser limpo. Ele automatiza as verificações de rotina que eu costumava fazer manualmente, servindo como uma alternativa gratuita e de código aberto às recomendações pagas encontradas no AWS Trusted Advisor.

👥 Comunidade

Contribuidores

Um enorme agradecimento a todos que contribuíram para o aws-doctor! Sua ajuda torna esta ferramenta melhor para todos.

Histórico de Estrelas

🤝 Contribuindo

Adoramos contribuições! Seja uma nova regra de detecção ou uma correção de bug, consulte nosso Painel da Comunidade para começar.

[!IMPORTANT] Sempre direcione seus Pull Requests para a branch development. A branch main é reservada para versões prontas para produção. Consulte nossas Diretrizes de Contribuição para mais detalhes.