Una herramienta basada en terminal que actúa como un chequeo de salud integral para tus cuentas de AWS. Construida con Golang, aws-doctor diagnostica anomalías de costos, detecta recursos inactivos y proporciona un análisis proactivo de tu infraestructura en la nube.

[!TIP] Consulta la documentación completa, la guía de permisos y ejemplos de uso en awsdoctor.compacompila.com

👀 Vistazo rápido

⚖️ Análisis Comparativo de Costos

📈 Análisis de Tendencia a 6 Meses

🧟 Detección de Desperdicio

Admite escaneo selectivo: aws-doctor waste ec2 s3 cloudwatch rds vpc lambda sagemaker elb ecr secrets-manager iam

• Interfaz de Terminal Interactiva: Navega sin problemas por las categorías de desperdicio detectadas usando las flechas del teclado o las pestañas, con una vista resumida agregada.
• Degradación Elegante: ¿Ejecutando en CI/CD? aws-doctor detecta automáticamente si está siendo redirigido o canalizado y retrocede elegantemente a tablas estáticas.

📄 Informes Profesionales

aws-doctor ahora puede generar informes PDF detallados y profesionales listos para las partes interesadas. Los informes incluyen encabezados personalizados, tablas con estilo y análisis completos de costos/desperdicio.

[!TIP] Consulta ejemplos y detalles de informes PDF en awsdoctor.compacompila.com/docs/reporting/

Generar un Informe de Comparación de Costos

Generar un Informe de Análisis de Desperdicio

Generar un Informe de Tendencia

[!TIP] Argumentos de Subcomandos: Al igual que los comandos de terminal, report waste acepta verificaciones específicas (ej., ec2, s3, rds, lambda) y report trend acepta nombres de servicios específicos.

[!TIP] Por defecto, los informes se guardan en tu carpeta Documentos. Usa la bandera --path para especificar un directorio o nombre de archivo personalizado: aws-doctor report cost --path ./billing-analysis.pdf

🚀 Instalación

Homebrew (macOS/Linux):

Script de una línea (macOS/Linux):

Windows (PowerShell):

Usando Go:

✨ Características Principales

• 📄 Informes PDF Profesionales: Genera documentos PDF personalizados y listos para compartir para costos, tendencias y análisis de desperdicio.
• 📉 Comparación Justa de Costos: Compara ventanas de tiempo idénticas entre meses para detectar anomalías reales.
• 🧟 Descubrimiento de Zombies: Escanea en busca de EIPs inactivas, instancias detenidas, instancias EC2 en ejecución inactivas, snapshots huérfanos, instancias RDS inactivas, NAT Gateways inactivos, Balanceadores de Carga inactivos, memoria Lambda sobreaprovisionada, endpoints de inferencia en tiempo real de SageMaker inactivos, repositorios ECR con imágenes sin etiqueta, políticas de ciclo de vida faltantes o sin imágenes, secretos de Secrets Manager no utilizados, y usuarios IAM no utilizados o cuentas Root sin MFA. Admite filtrado selectivo de servicios (ec2, s3, elb, cloudwatch, rds, vpc, lambda, sagemaker, ecr, secrets-manager, iam).
• 📊 Tendencias a 6 Meses: Visualización ANSI de alta fidelidad de la velocidad de tu gasto.
• 📤 Múltiples Formatos de Salida: Exporta resultados en table, json o csv para una fácil integración con otras herramientas o informes.
• 🔔 Notificaciones de Actualización: Verifica automáticamente nuevas versiones en segundo plano y te notifica después de la salida del comando.
• 🚀 Caché Eficiente: Utiliza un servicio de caché local para minimizar llamadas de red redundantes. Actualmente se usa para notificaciones de verificación de versiones (TTL de 2 horas) y está previsto expandirlo a datos de precios y otros flujos pesados.
• 🔐 Listo para MFA: Soporte nativo para perfiles que requieren autenticación multifactor.
• 🌍 Precios Conscientes de la Región: Consulta la API de Precios de AWS al inicio para usar tarifas de la región configurada, recurriendo a los valores predeterminados de us-east-1 si la API no está disponible. Requiere pricing:GetProducts en la política IAM del llamante; sin él, las estimaciones recurren silenciosamente a los valores predeterminados.

💡 Motivación

Como Arquitecto de la Nube, a menudo necesito verificar los costos de AWS y la información de facturación. Si bien la Consola de AWS proporciona datos sin procesar, carece del contexto inmediato que necesito para responder la pregunta: "¿Estamos gastando de manera eficiente?"

Creé *aws-doctor* para llenar ese vacío. No solo te muestra la factura; actúa como una herramienta de diagnóstico que te ayuda a entender *dónde* va el dinero y *qué* se puede limpiar. Automatiza las comprobaciones rutinarias que solía realizar manualmente, sirviendo como una alternativa gratuita y de código abierto a las recomendaciones pagas que se encuentran en AWS Trusted Advisor.

👥 Comunidad

Contribuidores

Un enorme agradecimiento a todos los que han contribuido a aws-doctor! Tu ayuda hace que esta herramienta sea mejor para todos.

Historial de Estrellas

🤝 Contribuciones

¡Nos encantan las contribuciones! Ya sea una nueva regla de detección o una corrección de errores, consulta nuestro Panel de la Comunidad para comenzar.

[!IMPORTANT] Siempre dirige tus Pull Requests a la rama development. La rama main está reservada para versiones listas para producción. Consulta nuestras Guías de Contribución para más detalles.