スケジュールされたクエリの作成

スケジュールされたクエリを作成するには (コンソール)

1. で CloudWatch Logs コンソールを開きますか? https://us-east-1.console.aws.amazon.com/cloudwatch/homeregion=us-east-1#logsV2:logs-insights。

2. ナビゲーションペインで、Logs Insights を選択します。

3. スケジュールされたクエリの作成を選択します。

4. クエリ定義セクションで、次の操作を行います。

   1. クエリ言語 で、リストから使用するクエリ言語を選択します。

   2. クエリ文字列には、ボックスに CloudWatch Logs Insights クエリを入力します。

   3. ロググループで、リストからクエリするロググループを選択します。

5. 「スケジュール設定」セクションで、次の操作を行います。

   1. スケジュール式では、クエリが実行されるタイミングを設定します。事前定義されたオプションから選択するか、カスタム cron 式を入力します。

   2. 「作成時に有効」で、スケジュールがいつアクティブになるかを指定します。すぐに開始するか、YYYY/MM/DD 形式を使用して特定の日時から開始するかを選択します。

   3. 時間範囲には、各クエリ実行のルックバック期間を指定します。実行時間からクエリまでの時間を定義する時間を分単位で入力します。

   4. 「無期限に続行する」で、スケジュールの終了時刻を指定します。無期限に実行するか、YYYY/MM/DD 形式を使用して特定の日時まで実行するかを選択します。

6. コンソールには、設定に基づいて次の 3 つのスケジュールされたクエリ実行が表示され、クエリが実行される正確な日時が UTC で表示されます。

7. 「クエリ結果を S3 に投稿する - オプション」セクション (S3 送信先を使用している場合):

   1. S3 バケットの場合、送信先バケットが同じアカウントにある場合はこの AWS アカウントを選択し、バケットが別の AWS アカウントにある場合は別のアカウントを選択し、バケット所有アカウントのアカウント ID を入力として指定します。

   2. Amazon S3 URI の場合は、結果が保存される Amazon S3 バケットとプレフィックス (例: ) を入力しますs3://my-bucket/query-results/。このアカウントを選択した場合は、Amazon S3 の参照を選択して移動し、既存の Amazon S3 の場所を選択できます。

   3. (オプション) KMS キー ARN には、カスタマーマネージド AWS KMS キーの ARN を入力して、SSE-KMS を使用してクエリ結果を暗号化します。キーは、送信先の Amazon S3 バケットと同じ AWS リージョンにある必要があります。

8. Amazon Amazon S3ロールセクションで、次のいずれかのオプションを選択します。

   1. デフォルトのアクセス許可を持つ新しいロールの自動作成を選択すると、CloudWatch Logs がクエリ結果を Amazon S3 に配信するために必要なアクセス許可を持つ IAM ロールが自動的に設定されます。

   2. 既存のロールを使用して、CloudWatch Logs がクエリ結果を Amazon S3 に配信するために必要なポリシーを持つ既存の IAM ロールを選択します。検索フィールドを使用して、リストから適切な IAM ロールを検索して選択します。

9. スケジュールされたクエリ実行の IAM ロールセクションで、次のいずれかのオプションを選択します。

   1. デフォルトのアクセス許可を持つ新しいロールを自動作成を選択して、CloudWatch Logs がスケジュールされたクエリを実行するために必要なアクセス許可を持つ IAM ロールを自動的にセットアップします。

   2. 既存のロールを使用して、CloudWatch Logs がスケジュールされたクエリを実行するために必要なポリシーを持つ既存の IAM ロールを選択します。検索フィールドを使用して、リストから適切な IAM ロールを検索して選択します。

10. スケジュールの作成を選択して、スケジュールされたクエリを作成します。

スケジュールされたクエリを作成するには (AWS CLI)

• create-scheduled-query コマンドを使用して、新しいスケジュールされたクエリを作成します。

  aws logs create-scheduled-query \
      --name "ErrorAnalysisQuery" \
      --query-language "CWLI" \
      --query-string "fields @timestamp, @message | filter @message like /ERROR/ | stats count() by bin(5m)" \
      --schedule-expression "cron(8 * * * ? *)" \
      --execution-role-arn "arn:aws:iam::123456789012:role/CloudWatchLogsScheduledQueryRole" \
      --log-group-identifiers "/aws/lambda/my-function" "/aws/apigateway/my-api" \
      --state "ENABLED"

スケジュールされたクエリを作成するには (API)

• CreateScheduledQuery アクションを使用して、新しいスケジュールされたクエリを作成します。次の例では、1 時間ごとに実行されるスケジュールされたクエリを作成します。

  {
      "name": "ErrorAnalysisQuery",
      "queryLanguage": "CWLI",
      "queryString": "fields @timestamp, @message | filter @message like /ERROR/ | stats count() by bin(5m)",
      "scheduleExpression": "cron(8 * * * ? *)",
      "executionRoleArn": "arn:aws:iam::123456789012:role/CloudWatchLogsScheduledQueryRole",
      "logGroupIdentifiers": ["/aws/lambda/my-function", "/aws/apigateway/my-api"],
      "state": "ENABLED"
  }