How elc0mpa/aws-doctor works
aws-doctor is a terminal AWS account health checker for cost comparisons, spending trends, and waste discovery, with table/JSON/CSV output and PDF reports. The principal workflow is CLI invocation, AWS configuration, analysis against AWS APIs, then rendered results or a report. Waste analysis also supports selected checks and interactive navigation. The source index and sampled excerpts establish several service dependencies; other documented capabilities are retained where their internal wiring was not sampled, so those links are marked unverified or omitted.
Main entry points: orchestrator Workflow orchestrator · root.go CLI commands · service.go Regional pricing · service_waste.go PDF reports
Components 25
CLI and orchestration
- CLI commands
cmd/root.go - Workflow orchestrator
service/orchestrator - Analyzer registry
service/analyzer/registry.go
Cost and analysis
- Cost Explorer
service/costexplorer/service.go - Regional pricing
service/pricing/service.go
AWS resource checks
- EC2 checks
service/ec2/service.go - S3 checks
service/s3/service.go - RDS checks
service/rds/service.go - VPC checks
service/vpc/service.go - Lambda checks
service/lambda/service.go - CloudWatch Logs
service/cloudwatchlogs/service.go - CloudWatch metrics
service/cloudwatchmetrics/service.go - SageMaker checks
service/sagemaker/service.go - IAM checks
service/iam/service.go - ECR checks
service/ecr/service.go - Load balancer checks
service/elb/service.go
Results and reports
- Terminal and data output
service/output/service.go - JSON presentation
utils/json_output/json_output.go - Interactive waste UI
utils/tui/waste_model.go - PDF reports
service/report/service_waste.go
Account support
- AWS configuration
service/aws_config/service.go - Local cache
service/cache/service.go - Update notifications
service/update/service.go
Other components
- Terminal user
- AWS APIs
Connections 28
- Terminal user → CLI commands: runs command
README.md - CLI commands → AWS configuration: loads credentials
cmd/root.go - CLI commands → Workflow orchestrator: dispatches workflow
cmd/root.go - CLI commands → Regional pricing: configures rates
cmd/root.go - Workflow orchestrator → Cost Explorer: requests cost data
- Workflow orchestrator → Analyzer registry: selects checks
- Cost Explorer → AWS APIs: queries costs
- Regional pricing → AWS APIs: loads rates
- EC2 checks → AWS APIs: scans resources
- S3 checks → AWS APIs: scans resources
- RDS checks → AWS APIs: scans resources
- VPC checks → AWS APIs: scans resources
- Lambda checks → AWS APIs: scans functions
- Lambda checks → CloudWatch Logs: queries usage
service/lambda/service.go - CloudWatch Logs → AWS APIs: queries logs
- SageMaker checks → CloudWatch metrics: checks invocations
service/sagemaker/service.go - SageMaker checks → Regional pricing: estimates cost
- IAM checks → AWS APIs: checks identity
- ECR checks → AWS APIs: scans repositories
- Load balancer checks → AWS APIs: scans load balancers
- Workflow orchestrator → Terminal and data output: renders results
service/orchestrator/service_waste.go - Workflow orchestrator → PDF reports: generates report
service/orchestrator/service_waste.go - PDF reports → Regional pricing: uses rate estimates
service/report/service_waste.go - PDF reports → JSON presentation: uses presenters
service/report/service_waste.go - Terminal and data output → Interactive waste UI: offers interactive view
- Workflow orchestrator → Local cache: uses cached data
- CLI commands → Update notifications: checks versions
- Update notifications → Local cache: caches check
service/update/service.go