フィルターパターンを使用してログデータを検索する - Amazon CloudWatch Logs

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

フィルターパターンを使用してログデータを検索する

ログデータは、メトリクスフィルター、サブスクリプションフィルター、フィルターログイベント、およびライブテールのフィルターパターン構文 を使用して検索できます。ロググループ内のすべてのログストリームを検索するか、 を使用して特定のログストリームを検索 AWS CLI することもできます。各検索を実行すると、最大で、見つかったデータの最初のページと、データの次のページを取得するか検索を続行するためのトークンが返されます。結果が返されない場合は、検索を続行できます。

クエリを実行する時間範囲を設定し、検索範囲を制限することができます。広い範囲から開始して関心のあるログ行が収まっている場所を確認した後、時間範囲を短縮し、関心のある時間範囲のログまでビューを絞り込みます。

ログから抽出したメトリクスを直接、対応するログに移動することもできます。

CloudWatch クロスアカウントオブザーバビリティでモニターリングアカウントとして設定されたアカウントにサインインしている場合は、このモニターリングアカウントにリンクされているソースアカウントのログイベントを検索してフィルタリングできます。詳細については、CloudWatch クロスアカウント オブザーバビリティを参照してください。

コンソールを使用してログエントリを検索する

コンソールを使用して、指定した基準を満たすログエントリを検索することができます。

コンソールを使用してログを検索するには
  1. https://console.aws.amazon.com/cloudwatch/ で CloudWatch コンソールを開きます。

  2. ナビゲーションペインで、[ロググループ] を選択します。

  3. [ロググループ] で、検索するログストリームを含むロググループの名前を選択します。

  4. [ログストリーム] で、検索するログストリームの名前を選択します。

  5. [Log Events (ログイベント)] で、使用するフィルター構文を入力します。

コンソールを使用してすべてのログエントリで時間範囲を検索するには
  1. https://console.aws.amazon.com/cloudwatch/ で CloudWatch コンソールを開きます。

  2. ナビゲーションペインで、[ロググループ] を選択します。

  3. [ロググループ] で、検索するログストリームを含むロググループの名前を選択します。

  4. [ロググループの検索] を選択します。

  5. [Log Events (ログイベント)] で、日付と時刻の範囲を選択し、フィルター構文を入力します。

を使用したログエントリの検索 AWS CLI

を使用して、指定された基準を満たすログエントリを検索できます AWS CLI。

を使用してログエントリを検索するには AWS CLI

コマンドプロンプトで、次の filter-log-events コマンドを実行します。結果を指定したフィルターパターンに限定するには --filter-pattern を使用し、結果を指定したログストリームに限定するには --log-stream-names を使用します。

aws logs filter-log-events --log-group-name my-group [--log-stream-names LIST_OF_STREAMS_TO_SEARCH] [--filter-pattern VALID_METRIC_FILTER_PATTERN]
を使用して特定の時間範囲のログエントリを検索するには AWS CLI

コマンドプロンプトで、次のfilter-log-eventsコマンドを実行します。

aws logs filter-log-events --log-group-name my-group [--log-stream-names LIST_OF_STREAMS_TO_SEARCH] [--start-time 1482197400000] [--end-time 1482217558365] [--filter-pattern VALID_METRIC_FILTER_PATTERN]

メトリクスからログへのピボット

コンソールの他の部分から、特定のログエントリに移動することができます。

ダッシュボードウィジェットからログに移動するには
  1. https://console.aws.amazon.com/cloudwatch/ で CloudWatch コンソールを開きます。

  2. ナビゲーションペインで、ダッシュボードを選択します。

  3. ダッシュボードを選択します。

  4. ウィジェットで [View logs] アイコンを選択し、[View logs in this time range] を選択します。メトリクスフィルターが複数ある場合は、リストから 1 つ選択します。メトリクスフィルターをリストに表示しきれない場合は、[More metric filters] を選択し、メトリクスフィルターを選択するか検索します。

メトリクスからログに移動するには
  1. https://console.aws.amazon.com/cloudwatch/ で CloudWatch コンソールを開きます。

  2. ナビゲーションペインで メトリクスを選択します。

  3. [All metrics] タブの検索フィールドに、メトリクスの名前を入力して Enter キーを押します。

  4. 検索結果から 1 つ以上のメトリクスを選択します。

  5. [Actions]、[View logs] の順に選択します。メトリクスフィルターが複数ある場合は、リストから 1 つ選択します。メトリクスフィルターをリストに表示しきれない場合は、[More metric filters] を選択し、メトリクスフィルターを選択するか検索します。

トラブルシューティング

[Search takes too long to complete]

ログデータが多い場合、検索の完了に時間がかかる場合があります。検索の速度を上げるには、次を実行します:

  • を使用している場合は AWS CLI、検索対象を関心のあるログストリームのみに制限できます。例えば、ロググループに 1000 個のログストリームがあるが、関連性がわかっているログストリームを 3 つだけ表示する場合は、 を使用して、検索をロググループ内の 3 つのログストリームのみ AWS CLI に制限できます。

  • 時間範囲を短く、細かくして検索対象のデータ量を減らし、クエリの速度を上げます。