aws-doctor
A terminal-based tool that acts as a comprehensive health check for your AWS accounts. Built with Golang, aws-doctor diagnoses cost anomalies, detects idle resources, and provides a proactive analysis of your cloud infrastructure—effectively giving you the insights of AWS Trusted Advisor without the need for a Business or Enterprise support plan.
Demo
Basic usage
Trend
Waste
Features
📉 Cost Comparison: Compares costs between the current and previous month for the exact same period (e.g., comparing Jan 1–15 vs Feb 1–15) to give a fair assessment of spending velocity.
🏥 Waste Detection (The “Checkup”): Scans your account for “zombie” resources and inefficiencies that are silently inflating your bill.
📊 Trend Analysis: Visualizes cost history over the last 6 months to spot long-term anomalies.
Motivation
As a Cloud Architect, I often need to check AWS costs and billing information. While the AWS Console provides raw data, it lacks the immediate context I need to answer the question: “Are we spending efficiently?”
I created aws-doctor to fill that gap. It doesn’t just show you the bill; it acts as a diagnostic tool that helps you understand where the money is going and what can be cleaned up. It automates the routine checks I used to perform manually, serving as a free, open-source alternative to the paid recommendations found in AWS Trusted Advisor.
Installation
Golang
go install github.com/elC0mpa/aws-doctor@latest
Flags
–profile: Specify the AWS profile to use (default is “”).
–region: Specify the AWS region to use (default is “us-east-1”).
–trend: Shows a trend analysis for the last 6 months.
–waste: Makes an analysis of possible money waste you have in your AWS Account.
Unused EBS Volumes (not attached to any instance).
EBS Volumes attached to stopped EC2 instances.
Unassociated Elastic IPs.
EC2 reserved instance that are scheduled to expire in the next 30 days or have expired in the preceding 30 days.
EC2 instance stopped for more than 30 days.
EC2 instances stopped for more than 30 days.
Load Balancers with no attached target groups.
Inactive VPC interface endpoints.
Inactive NAT Gateways.
Idle Load Balancers.
RDS Idle DB Instances.
Roadmap
Add monthly trend analysis
Add waste / wastage analysis logic
Export reports to CSV and PDF formats (medical records for your cloud)
Distribute the CLI via Fedora, Ubuntu, and macOS repositories
