メトリクスフィルター、サブスクリプションフィルター、フィルターログイベント、およびライブテールのフィルターパターン構文 - Amazon CloudWatch Logs

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

メトリクスフィルター、サブスクリプションフィルター、フィルターログイベント、およびライブテールのフィルターパターン構文

フィルターパターンは、メトリクスフィルター、サブスクリプションフィルター、ログイベント、Live Tail がログイベントの語句を照合するために使用する構文を構成します。語句には、単語、正確なフレーズ、または数値を指定できます。正規表現 (regex) は、スタンドアロンのフィルターパターンの作成に使用するか、JSON やスペース区切りのフィルターパターンに組み込むことができます。

照合する語句を使用してフィルターパターンを作成します。フィルターパターンは、定義する語句を含むログイベントのみを返します。CloudWatch コンソールでフィルターパターンをテストできます。

CloudWatch Logs では、メトリクスフィルターを使用してログデータを実用的なメトリクスに変換し、サブスクリプションフィルターを使用してログイベントを他の AWS サービスにルーティングし、ログイベントをフィルタリングしてログイベントを検索し、Live Tail を使用してログを取り込み時にインタラクティブにリアルタイムで表示できます。

注記

フィルタパターンは、ログイベントをリアルタイムで照合およびフィルタリングするか、特定のオペレーション用に設計されています。ログデータ全体のインタラクティブな分析と複雑なクエリについては、CloudWatch Logs Insights を使用したログデータの分析」を参照してください。

これらのフィルターパターンを使用する一般的なシナリオを次に示します。

  • アプリケーションエラーのモニタリング: ERRORアプリケーションログ全体のエラー発生を追跡するために使用します。

  • API アクティビティの追跡: を使用して特定の CloudTrail イベントをモニタリング{ $.eventType = "UpdateTrail" }する

  • ウェブサーバーの問題を分析する: [ip, user, timestamp, request, status_code = 4*, bytes]を使用して失敗した HTTP リクエストを検索する

以下のセクションでは、各パターンタイプの完全な構文と、各ユースケースの例を示します。