しくみ
Awnexa の役割は、AWS の構成についての事実を集め、その変化を記録することだけです。集めた事実の判断(レビュー、改善の提案、IaC の生成、障害の原因探し)は Claude Code が行います。
リージョンを並列に読み取り、結果をスナップショットとして保存します。IAM・CloudFront・Organizations などのグローバルなサービスは 1 回だけ読み取ります。
取得網羅性(Coverage)
Section titled “取得網羅性(Coverage)”API とリージョンごとに、取得が complete・partial・access_denied・failed・unsupported、または not_applicable(そのリージョンでサービスが提供されていない・有効になっていない)・skipped(--services で除外した)・unknown(スキャンの中断などで実行していない)のどれだったかを記録します。件数が分からないときは 0 ではなく null にします。Coverage を読んだ AI エージェントは「存在しない」ではなく「確認していない」と答えられます。
取得根拠(Evidence)と確度
Section titled “取得根拠(Evidence)と確度”リソースのもとになった API レスポンスを、機密値をマスキングして保存します。すべての事実に確度が付きます。
| 確度 | 意味 |
|---|---|
direct |
AWS の API から得た事実 |
derived |
機械的に導いたもの(導いたルールを記録する) |
inferred |
推定。事実としては保存しない |
Security Group のルールは「許可されていること」として記録し、実際に通信している証拠としては扱いません。
関係性と影響範囲
Section titled “関係性と影響範囲”ID と ARN の参照から関係のグラフを作り、参照先がスキャンで見つかった(resolved)か、参照されているが取得していない(unresolved)か、アカウントの外(external)かを記録します。Lambda 関数や ECS タスク定義の環境変数の値がリソースを指す形(SQS キューの URL、RDS のエンドポイント、ARN)なら、inferred の関係にします。TABLE_NAME=orders のような名前だけの値も、スキャンの中でその型のリソースがちょうど 1 つその名前を持つときは同じく関係にします。残すのは変数名だけで、値は保存しません。awnexa impact は、あるリソースに依存しているものを、経路とスキャンの範囲の注意書き付きで列挙します。
スナップショットと差分
Section titled “スナップショットと差分”awnexa snapshot diff は 2 つのスキャンの間で作成・変更・削除されたものを示します。部分的なスキャンからは削除を確定せず、unknown として報告します。両方のスキャンにあるリソースの間で追加・削除された関係も示し、関係が無い側のスキャンで元のリソースを完全に取得できていなければ未確定とします。
利用状況のメトリクス(任意)
Section titled “利用状況のメトリクス(任意)”awnexa scan --metrics を付けると、利用状況の要約も取得します。EC2 インスタンス・NAT ゲートウェイ・RDS・Lambda・SQS・SNS・ロードバランサー・ターゲットグループ・API Gateway・DynamoDB・ECS サービス・S3 バケット・CloudFront について、リソースごとに少数の CloudWatch メトリクス(リクエスト・呼び出し・接続・通信量・使用率・保存量)の直近 14 日の日ごとの値です。あるリソースに依存するもののうち、どれが実際に動いていたかを Claude Code が見分ける助けになります。構成情報とは分けて保存し、スナップショットの差分には含めません。CloudWatch の GetMetricData は要求したメトリクスの数で課金されるため、既定では取得しません。awnexa status に最新のスキャンでの件数と費用の見込みが、スキャンの出力に実際に要求した数が出ます。
取得しないもの
Section titled “取得しないもの”カスタムメトリクスや細かいメトリクスの時系列、ログの中身、CloudTrail のイベント、S3 のオブジェクト、データベースのデータ、シークレットや SecureString の値。Secrets Manager・Systems Manager のパラメータ・KMS はメタデータだけを取得します。