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

[x] Add monthly trend analysis.

[x] Add waste/waste analysis logic.

[ ] Export reports to CSV and PDF formats (Medical records for your cloud).

[ ] Distribute the CLI in Fedora, Ubuntu, and macOS repositories.