View a markdown version of this page

サブスクリプションを使用したログデータのリアルタイム処理 - Amazon CloudWatch Logs

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

サブスクリプションを使用したログデータのリアルタイム処理

サブスクリプションを使用して CloudWatch Logs からログイベントのリアルタイムフィードにアクセスし、カスタム処理、分析、他のシステムへのロードを行うために、Amazon Kinesis ストリーム、Amazon Data Firehose ストリーム、 AWS Lambda などの他のサービスに配信することができます。ログイベントを受信側サービスに送信すると、gzip 形式で圧縮されます。 awslogs.dataフィールドでエンコードされたデータベース 64 AWS Lambda を受け取ります。Amazon Kinesis Data Streams レコードには gzip バイトが含まれ、 AWS CLI および AWS Lambda イベントソースには base64 でエンコードされたレコードが表示されます。

CloudWatch Logs の一元化を使用して、複数のアカウントとリージョンのログデータを一元的にレプリケートすることもできます。詳細については、「クロスアカウントクロスリージョンログの一元化」を参照してください。

ログイベントのサブスクライブを開始するには、イベントが配信される Amazon Kinesis Data Streams ストリームなどの受信リソースを作成します。サブスクリプションフィルターは、 AWS リソースに配信されるログイベントをフィルタリングするために使用するフィルターパターンと、一致するログイベントの送信先に関する情報を定義します。ログイベントは、取り込み後すぐに (通常は 3 分未満) 受信側リソースに送信されます。

注記

サブスクリプションを持つロググループがログ変換を使用する場合、フィルターパターンは変換されたバージョンのログイベントと比較されます。詳細については、「取り込み中のログの変換」を参照してください。

サブスクリプションは、アカウントレベルとロググループレベルで作成できます。各アカウントには、リージョンごとに 1 つのアカウントレベルのサブスクリプションフィルターを含めることができます。各ロググループには、最大 5 つのサブスクリプションフィルターを関連付けることができます。

注記

送信先のサービスが、スロットリングの例外や再試行可能なサービス例外 (HTTP 5xx など) の再試行可能なエラーを返した場合、CloudWatch Logs は最大 24 時間配信を再試行し続けます。AccessDeniedException や ResourceNotFoundException などの再試行不可能なエラーの場合、CloudWatch Logs は再配信を試みません。このような場合、サブスクリプションフィルターは最大 10 分間無効になり、CloudWatch Logs は送信先へのログの送信を再試行します。この無効化期間中、ログはスキップされます。

また、CloudWatch Logs は、サブスクリプションへのログイベントの転送に関する CloudWatch メトリクスを作成します。詳細については、「CloudWatch メトリクスによるモニタリング」を参照してください。

CloudWatch Logs サブスクリプションを使用して、Amazon OpenSearch Service クラスターにほぼリアルタイムでログデータをストリーミングすることもできます。詳細については、「Amazon OpenSearch Service への CloudWatch Logs データのストリーミング」を参照してください。

サブスクリプションは、標準ログクラスのロググループでのみサポートされます。ログクラスの詳細については、「ログクラス」を参照してください。

注記

サブスクリプションフィルターは、ログイベントをバッチ処理して送信を最適化し、送信先への呼び出しの量を減らすことができます。バッチ処理は必ず行われるわけではありませんが、可能な場合は使用されます。

スケジュールに従ってログデータをバッチ処理および分析するには、 の使用を検討してくださいスケジュールされたクエリによるログ分析の自動化。スケジュールされたクエリは CloudWatch Logs Insights クエリを自動的に実行し、Amazon S3 バケットや Amazon EventBridge イベントバスなどの送信先に結果を配信します。

注記

サブスクリプションフィルターは、イベントの配信を少なくとも 1 回保証しますが、重複イベントが発生することがあります。