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: キーボードの矢印キーまたはタブを使用して、検出された無駄カテゴリをシームレスにナビゲーションでき、集約されたサマリービューも備えています。
• グレースフルデグラデーション: 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 Gateway、アイドルロードバランサー、過剰プロビジョニングされたLambdaメモリ、アイドルSageMakerリアルタイム推論エンドポイント、タグなしイメージのあるECRリポジトリ、ライフサイクルポリシーの欠如、またはイメージが全くない状態、未使用のSecrets Managerシークレット、未使用のIAMユーザーまたはMFAなしのルートアカウントをスキャンします。選択的サービスフィルタリングをサポート（ec2、s3、elb、cloudwatch、rds、vpc、lambda、sagemaker、ecr、secrets-manager、iam）。
• 📊 6ヶ月トレンド: 支出の速度を高精細なANSIで可視化します。
• 📤 複数出力形式: 結果を table、json、 形式でエクスポートでき、他のツールやレポートに簡単に統合できます。

💡 動機

クラウドアーキテクトとして、AWSのコストと請求情報を確認する必要が頻繁にあります。AWSコンソールは生データを提供しますが、私が答えたい質問に対して即座のコンテキストが不足しています：「私たちは効率的に支出しているのか？」

*aws-doctor* はそのギャップを埋めるために作成しました。単に請求書を表示するだけでなく、お金が *どこに* 流れているか、そして *何を* クリーンアップできるかを理解するための診断ツールとして機能します。私が手動で行っていた定型的なチェックを自動化し、AWS Trusted Advisorの有料推奨事項に対する無料のオープンソース代替手段として提供します。

👥 コミュニティ

コントリビューター

aws-doctor に貢献してくださったすべての方に心から感謝します！皆さんの助けにより、このツールはより良いものになっています。

スター履歴

🤝 コントリビューション

コントリビューションを歓迎します！新しい検出ルールでもバグ修正でも、コミュニティダッシュボードから始めてください。

[!IMPORTANT] プルリクエストは常に development ブランチをターゲットにしてください。 main ブランチはプロダクションリリース用です。詳細は コントリビューションガイドライン をご覧ください。