aws-doctor

AWS 계정에 대한 종합적인 상태 점검을 제공하는 터미널 기반 도구입니다. Golang으로 빌드된 aws-doctor는 비용 이상 징후를 진단하고, 유휴 리소스를 감지하며, 클라우드 인프라에 대한 사전 분석을 제공합니다.

[!TIP] 전체 문서, 권한 가이드 및 사용 예제는 awsdoctor.compacompila.com에서 확인하세요.

👀 빠른 미리보기

⚖️ 비교 비용 분석

📈 6개월 추세 분석

🧟 낭비 감지

선택적 스캔 지원: aws-doctor waste ec2 s3 cloudwatch rds vpc lambda sagemaker elb ecr secrets-manager iam

• 대화형 터미널 UI: 키보드 화살표 또는 탭을 사용하여 감지된 낭비 카테고리를 원활하게 탐색할 수 있으며, 집계된 요약 보기를 제공합니다.
• 우아한 저하(graceful degradation): CI/CD에서 실행 중인가요? aws-doctor는 자동으로 파이프 또는 리디렉션 여부를 감지하여 정적 테이블로 우아하게 전환합니다.

📄 전문 보고서 생성

aws-doctor는 이제 이해 관계자에게 바로 공유할 수 있는 상세하고 전문적인 PDF 보고서를 생성할 수 있습니다. 보고서에는 브랜드 헤더, 스타일이 적용된 테이블, 포괄적인 비용/낭비 분석이 포함됩니다.

[!TIP] PDF 보고서 예제 및 세부 정보는 awsdoctor.compacompila.com/docs/reporting/에서 확인하세요.

비용 비교 보고서 생성

aws-doctor report cost

낭비 분석 보고서 생성

# 전체 낭비 보고서
aws-doctor report waste

# 선택적 검사 (예: ec2, s3, lambda만)
aws-doctor report waste ec2 s3 lambda sagemaker

추세 보고서 생성

# 전체 추세 보고서 (모든 서비스)
aws-doctor report trend

# 선택적 서비스 (예: ec2, rds만)
aws-doctor report trend ec2 rds

[!TIP] 하위 명령 인수: 터미널 명령과 마찬가지로 report waste는 특정 검사(예: ec2, s3, rds, lambda)를 허용하고, report trend는 특정 서비스 이름을 허용합니다.

[!TIP] 기본적으로 보고서는 Documents 폴더에 저장됩니다. 사용자 정의 디렉토리나 파일 이름을 지정하려면 --path 플래그를 사용하세요. aws-doctor report cost --path ./billing-analysis.pdf

🚀 설치

Homebrew (macOS/Linux):

brew install elC0mpa/homebrew-tap/aws-doctor

원클릭 스크립트 (macOS/Linux):

curl -sSfL https://raw.githubusercontent.com/elC0mpa/aws-doctor/main/install.sh | sh

Windows (PowerShell):

irm https://raw.githubusercontent.com/elC0mpa/aws-doctor/main/install.ps1 | iex

Go 사용:

go install github.com/elC0mpa/aws-doctor@latest

✨ 주요 기능

• 📄 전문 PDF 보고서: 비용, 추세 및 낭비 분석을 위한 브랜드화된 바로 공유 가능한 PDF 문서를 생성합니다.
• 📉 공정한 비용 비교: 월별로 동일한 기간을 비교하여 실제 이상 징후를 발견합니다.
• 🧟 좀비 발견: 유휴 EIP, 중지된 인스턴스, 유휴 상태로 실행 중인 EC2 인스턴스, 고아 스냅샷, 유휴 RDS 인스턴스, 유휴 NAT 게이트웨이, 유휴 로드 밸런서, 과도하게 프로비저닝된 Lambda 메모리, 유휴 SageMaker 실시간 추론 엔드포인트, 태그되지 않은 이미지가 있는 ECR 리포지토리, 누락된 수명 주기 정책 또는 이미지가 전혀 없는 리포지토리, 사용되지 않는 Secrets Manager 비밀, 사용되지 않는 IAM 사용자 또는 MFA가 없는 Root 계정을 스캔합니다. 선택적 서비스 필터링(ec2, s3, elb, cloudwatch, rds, vpc, lambda, sagemaker, ecr, secrets-manager, iam)을 지원합니다.
• 📊 6개월 추세: 지출 속도를 고화질 ANSI 시각화로 보여줍니다.
• 📤 여러 출력 형식: 결과를 table, json 또는 csv 형식으로 내보내 다른 도구나 보고서와 쉽게 통합할 수 있습니다.
• 🔔 업데이트 알림: 백그라운드에서 자동으로 새 버전을 확인하고 명령 출력 후 알림을 표시합니다.
• 🚀 효율적인 캐싱: 로컬 캐시 서비스를 사용하여 중복 네트워크 호출을 최소화합니다. 현재는 버전 확인 알림(2시간 TTL)에 사용되며, 추후 가격 데이터 및 기타 대규모 흐름으로 확장될 예정입니다.
• 🔐 MFA 지원: 다중 인증이 필요한 프로필을 기본적으로 지원합니다.
• 🌍 리전 인식 가격: 시작 시 AWS Pricing API를 쿼리하여 구성된 리전의 요금을 사용하며, API를 사용할 수 없는 경우 us-east-1 기본값으로 대체됩니다. 호출자의 IAM 정책에 pricing:GetProducts가 필요합니다. 없으면 추정치가 자동으로 기본값으로 대체됩니다.

💡 동기

클라우드 아키텍트로서 저는 종종 AWS 비용과 청구 정보를 확인해야 합니다. AWS 콘솔은 원시 데이터를 제공하지만, "우리는 효율적으로 지출하고 있는가?" 라는 질문에 답하는 데 필요한 즉각적인 맥락이 부족합니다.

저는 이러한 격차를 해소하기 위해 *aws-doctor*를 만들었습니다. 이 도구는 단순히 청구서를 보여주는 것이 아니라, 돈이 *어디로* 가고 있는지, *무엇을* 정리할 수 있는지 이해할 수 있도록 돕는 진단 도구 역할을 합니다. 제가 수동으로 수행하던 일상적인 점검을 자동화하여, AWS Trusted Advisor의 유료 권장 사항에 대한 무료 오픈소스 대안을 제공합니다.

👥 커뮤니티

기여자

aws-doctor에 기여해 주신 모든 분들께 큰 감사를 드립니다! 여러분의 도움 덕분에 이 도구가 더 나아질 수 있었습니다.

스타 기록

🤝 기여

기여를 환영합니다! 새로운 탐지 규칙이든 버그 수정이든, 시작하려면 커뮤니티 대시보드를 확인하세요.

[!IMPORTANT] Pull Request는 항상 development 브랜치로 보내주세요. main 브랜치는 프로덕션 준비 릴리스를 위해 예약되어 있습니다. 자세한 내용은 기여 가이드라인을 참조하세요.