コンテンツにスキップ

しくみ

Awnexa の役割は、AWS の構成についての事実を集め、その変化を記録することだけです。集めた事実の判断(レビュー、改善の提案、IaC の生成、障害の原因探し)は Claude Code が行います。

リージョンを並列に読み取り、結果をスナップショットとして保存します。IAM・CloudFront・Organizations などのグローバルなサービスは 1 回だけ読み取ります。

API とリージョンごとに、取得が complete・partial・access_denied・failed・unsupported、または not_applicable(そのリージョンでサービスが提供されていない・有効になっていない)・skipped(--services で除外した)・unknown(スキャンの中断などで実行していない)のどれだったかを記録します。件数が分からないときは 0 ではなく null にします。Coverage を読んだ AI エージェントは「存在しない」ではなく「確認していない」と答えられます。

リソースのもとになった API レスポンスを、機密値をマスキングして保存します。すべての事実に確度が付きます。

確度 意味
direct AWS の API から得た事実
derived 機械的に導いたもの(導いたルールを記録する)
inferred 推定。事実としては保存しない

Security Group のルールは「許可されていること」として記録し、実際に通信している証拠としては扱いません。

ID と ARN の参照から関係のグラフを作り、参照先がスキャンで見つかった(resolved)か、参照されているが取得していない(unresolved)か、アカウントの外(external)かを記録します。Lambda 関数や ECS タスク定義の環境変数の値がリソースを指す形(SQS キューの URL、RDS のエンドポイント、ARN)なら、inferred の関係にします。TABLE_NAME=orders のような名前だけの値も、スキャンの中でその型のリソースがちょうど 1 つその名前を持つときは同じく関係にします。残すのは変数名だけで、値は保存しません。awnexa impact は、あるリソースに依存しているものを、経路とスキャンの範囲の注意書き付きで列挙します。

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 に最新のスキャンでの件数と費用の見込みが、スキャンの出力に実際に要求した数が出ます。

カスタムメトリクスや細かいメトリクスの時系列、ログの中身、CloudTrail のイベント、S3 のオブジェクト、データベースのデータ、シークレットや SecureString の値。Secrets Manager・Systems Manager のパラメータ・KMS はメタデータだけを取得します。