Amazon CloudWatch Logs
このトピックは、ウェブ ACL トラフィックログの CloudWatch Logs ロググループへの送信に関する情報を提供します。
AWS WAF の使用料金に加えて、ログ記録の料金が請求されます。詳細については、「ウェブ ACL トラフィックのログ記録の料金に関する情報」を参照してください。
Amazon CloudWatch Logs にログを送信するには、CloudWatch Logs ロググループを作成します。AWS WAF へのログインを有効にするときは、ロググループ ARN を指定します。ウェブ ACL のログ記録を有効にした後、AWS WAF は、ログストリームの CloudWatch Logs ロググループにログを配信します。
CloudWatch Logs を使用すると、AWS WAF コンソールでウェブ ACL のログを調べることができます。ウェブ ACL ページで、[Logging insights] (ログ記録のインサイト) タブを選択します。このオプションは、CloudWatch コンソールで CloudWatch Logs に提供されるログ記録インサイトに追加されるものです。
ウェブ ACL と同じリージョンで、ウェブ ACL の管理に使用するのと同じアカウントを使用して、AWS WAF ウェブ ACL ログのロググループを設定します。CloudWatch Logs ロググループの設定については、「ロググループとログストリームの操作」を参照してください。
ロググループのクォータ
次のデフォルトの最大クォータは、CloudWatch Logs ロググループの容量とスループットの許容値に適用されます。ログ記録の要件がこれらの設定に対して高すぎる場合は、アカウントの PutLogEvent
のスロットリングメトリクスが表示されます。スロットリングの兆候が見られる場合は、Service Quotas
-
ウェブ ACL あたりのログストリームの数 – 35。AWS WAF からこの引き上げをリクエストできます。
-
ログストリームあたりのスループット – 1 秒あたり 5 MB。この設定は修正されています。
-
アカウントのすべてのログストリームのスループット – 1 秒あたり 1,500 MB。CloudWatch Logs からこれの引き上げをリクエストできます。
ロググループの命名
ロググループ名は aws-waf-logs-
で始まる必要があり、末尾を任意のサフィックスにすることができます (例: aws-waf-logs-testLogGroup2
)。
結果として生じる ARN 形式は次のとおりです。
arn:aws:logs:
Region
:account-id
:log-group:aws-waf-logs-log-group-suffix
ログストリームの命名形式は次のとおりです。
Region
_web-acl-name
_log-stream-number
ログストリーム番号は、前述のように、ウェブ ACL あたりのログストリーム数の AWS WAF クォータ以下の正の整数です。デフォルトのクォータは 35 です。
リージョン us-east-1
のウェブ ACL TestWebACL
のログストリームの例を次に示します。
us-east-1_TestWebACL_19
CloudWatch Logs にログを発行するための許可
CloudWatch Logs ロググループのウェブ ACL トラフィックログ記録を設定するには、このセクションで説明する許可設定が必要です。AWS WAF フルアクセスマネージドポリシーのいずれか (AWSWAFConsoleFullAccess
または AWSWAFFullAccess
) を使用すると、許可が設定されます。ログ記録と AWS WAF リソースへのよりきめ細かいアクセスを管理したい場合は、自分で許可を設定できます。許可の管理については、「IAM ユーザーガイド」の「AWS リソースの アクセス管理」を参照してください。AWS WAF マネージドポリシーの詳細については、「AWS WAF の AWS マネージドポリシー」を参照してください。
これらの許可を使用すると、ウェブ ACL ログ記録設定の変更、CloudWatch Logs のログ配信の設定、およびロググループに関する情報の取得が可能となります。これらの許可は、AWS WAF の管理に使用するユーザーにアタッチされる必要があります。
{ "Version":"2012-10-17", "Statement":[ { "Action":[ "wafv2:PutLoggingConfiguration", "wafv2:DeleteLoggingConfiguration" ], "Resource":[ "*" ], "Effect":"Allow", "Sid":"LoggingConfigurationAPI" } { "Sid":"WebACLLoggingCWL", "Action":[ "logs:CreateLogDelivery", "logs:DeleteLogDelivery", "logs:PutResourcePolicy", "logs:DescribeResourcePolicies", "logs:DescribeLogGroups" ], "Resource":[ "*" ], "Effect":"Allow" } ] }
すべての AWS リソースでアクションが許可されている場合、その旨はポリシーの "*"
の "Resource"
設定で示されます。これは、各アクションがサポートするすべての AWS リソースでアクションが許可されることを意味します。例えば、アクション wafv2:PutLoggingConfiguration
は、wafv2
のログ記録設定リソースでのみサポートされます。