テーマ別の解説テーマ:イベント処理の監視と復旧
CloudWatch Logsの設計|残す記録・保持期間・機密データを決める
障害調査に必要な記録は、ログを書き出す前に決めます。 画像変換の架空例で、調査に必要な項目を残しながら、機密情報と費用を抑える設計を考えます。
ロググループとストリームの役割を区別し、調査期間・閲覧権限・記録の粒度を要件に合わせて選べる。
同じ依頼を追跡するため、教材用の依頼IDを使います。実際のログや個人情報は不要です。
ログに書くものと、誰が読むかを先に決める
CloudWatch Logsのロググループは保持やアクセス制御の単位で、ストリームは同じ発生元からのログの並びです。記録前に対象項目を絞ると、秘密を保存する必要がなくなります。
- 記録する処理 → 必要な項目必要項目を選ぶ
- 必要な項目 → 保存と閲覧保持と閲覧範囲を確認
- 保存と閲覧 → 調査必要な範囲だけ読む
- 記録する処理
- 変換受付と保存結果
- 必要な項目
- 時刻、依頼ID、処理段階
- 保存と閲覧
- グループ単位で要件を設定
- 調査
- 時間範囲を絞り同じ依頼を追う
ログの項目を調査目的で選ぶ
| 情報 | 扱い | 判断の理由 |
|---|---|---|
| 受け付け時刻・依頼ID img-17・処理段階 | 残す | 同じ依頼の失敗箇所を照合できる。 |
| 画像本文・認証ヘッダー | 一般の調査ログには書かない | 処理段階の特定に不要で、漏えいの影響が大きい。 |
| エラーの種類と合成コード | 残す | 内容全体を記録せずに失敗を分類できる。 |
| 障害区間の照会 | 対象グループと時間を狭める | 同じ条件で必要な記録を読み、クエリの走査を抑える。 |
保持期間を短くすると保存する期間が変わります。出力を減らしたときの取り込みと、検索範囲を狭めたときの走査量は、それぞれ別に確認します。
保存後のマスキングと保存前の抑制を分ける
機密データの取り扱い。 CloudWatch Logsのマスキングは、選択した識別子に一致する取り込み後の表示を制御する機能です。既存の取り込み分には遡及せず、許可された利用者が元の値を見られる場合もあります。
必要な調査期間を残す。 遅れて報告される障害の調査期間や組織の保持要件を確認します。期限だけを変えても過去に取り込んだ量は変わりません。
記録と照会の選択を試す
選択すると、正誤と理由が表示されます。
確認して、自分の言葉で説明する
- 障害調査に使う項目と使わない項目を決める。
- ロググループごとに保持と閲覧条件を照合する。
- 取り込み・保存・照会の変化を別々に確認する。
理解を確かめる: マスキングを追加すれば、認証情報を記録してよいですか?
調査に不要な認証情報は記録前に除きます。
表示が保護される範囲には条件があり、保存された値の扱いも別に必要です。
出典と確認した条件
説明に用いた公式資料を、確認した内容・条件と本文の参照箇所に分けてまとめています。専門家による監修・実際のAWSとの比較検証は行っていません。
確認した内容・条件グループとストリーム、保持期間とアクセスの範囲。
参照した本文ログに書くものと、誰が読むかを先に決める ログの項目を調査目的で選ぶ 保存後のマスキングと保存前の抑制を分ける
確認した内容・条件マスキングの対象、遡及制限、Unmask権限。
確認した内容・条件ログの取り込み・保存・クエリに関する料金項目。