elc0mpa/aws-doctorPoderosa CLI de código aberto para auditar segurança, custos e melhores práticas na AWS. 🩺 ☁️
# aws-doctor <p align="center"> <a href="https://awsdoctor.compacompila.com/"><img src="https://img.shields.io/badge/Documentation-Website-blue?style=for-the-badge&logo=hugo" alt="Website"></a> </p> <p align="center"> <a href="https://github.com/avelino/awesome-go"><img src="https://awesome.re/mentioned-badge.svg" alt="awesome-go"></a> </p> <p align="center"> <a href="https://github.com/elC0mpa/aws-doctor/blob/main/go.mod"><img src="https://img.shields.io/github/go-mod/go-version/elC0mpa/aws-doctor" alt="Go Version"></a> <a href="https://pkg.go.dev/github.com/elC0mpa/aws-doctor"><img src="https://pkg.go.dev/badge/github.com/elC0mpa/aws-doctor.svg" alt="Go Reference"></a> <a href="https://goreportcard.com/report/github.com/elC0mpa/aws-doctor"><img src="https://goreportcard.com/badge/github.com/elC0mpa/aws-doctor" alt="Go Report Card"></a> <a href="https://codecov.io/gh/elC0mpa/aws-doctor"><img src="https://codecov.io/gh/elC0mpa/aws-doctor/graph/badge.svg" alt="codecov"></a> <a href="https://github.com/elC0mpa/aws-doctor/releases"><img src="https://img.shields.io/github/downloads/elC0mpa/aws-doctor/total?color=blue&label=Downloads" alt="GitHub all releases"></a> <a href="https://github.com/elC0mpa/aws-doctor/actions/workflows/ci.yml"><img src="https://github.com/elC0mpa/aws-doctor/actions/workflows/ci.yml/badge.svg" alt="CI"></a> <a href="https://github.com/elC0mpa/aws-doctor/blob/main/LICENSE"><img src="https://img.shields.io/github/license/elC0mpa/aws-doctor" alt="License"></a> </p> 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](https://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/](https://awsdoctor.compacompila.com/docs/reporting/)** ### Gerar um Relatório de Comparação de Custos ```bash aws-doctor report cost ``` ### Gerar um Relatório de Análise de Desperdício ```bash # Relatório completo de desperdício aws-doctor report waste # Verificações seletivas (ex.: ec2, s3 e lambda apenas) aws-doctor report waste ec2 s3 lambda sagemaker ``` ### Gerar um Relatório de Tendência ```bash # Relatório completo de tendência (todos os serviços) aws-doctor report trend # Serviços seletivos (ex.: ec2 e rds apenas) aws-doctor report trend ec2 rds ``` > [!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):** ```bash brew install elC0mpa/homebrew-tap/aws-doctor ``` **Script de Uma Linha (macOS/Linux):** ```bash curl -sSfL https://raw.githubusercontent.com/elC0mpa/aws-doctor/main/install.sh | sh ``` **Windows (PowerShell):** ```powershell irm https://raw.githubusercontent.com/elC0mpa/aws-doctor/main/install.ps1 | iex ``` **Usando Go:** ```bash go install github.com/elC0mpa/aws-doctor@latest ``` ## ✨ 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. <a href="https://github.com/elC0mpa/aws-doctor/graphs/contributors"> <img src="https://contrib.rocks/image?repo=elC0mpa/aws-doctor" alt="Contribuidores" /> </a> ### Histórico de Estrelas <a href="https://www.star-history.com/?type=date&legend=top-left&repos=elC0mpa%2Faws-doctor"> <picture> <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/chart?repos=elC0mpa/aws-doctor&type=date&theme=dark&legend=top-left" /> <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/chart?repos=elC0mpa/aws-doctor&type=date&legend=top-left" /> <img alt="Gráfico do Histórico de Estrelas" src="https://api.star-history.com/chart?repos=elC0mpa/aws-doctor&type=date&legend=top-left" /> </picture> </a> ## 🤝 Contribuindo Adoramos contribuições! Seja uma nova regra de detecção ou uma correção de bug, consulte nosso [Painel da Comunidade](https://awsdoctor.compacompila.com/#join-the-community) 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](https://github.com/elc0mpa/aws-doctor/blob/main/CONTRIBUTING.md) para mais detalhes.
