建立排程查詢

建立排程查詢 （主控台）

1. 在 https：//https://us-east-1.console.aws.amazon.com/cloudwatch/home?region=us-east-1#logsV2:logs-insights 開啟 CloudWatch Logs 主控台。

2. 在導覽窗格中，選擇 Logs Insights。

3. 選擇建立排程查詢。

4. 在查詢定義區段中：

   1. 針對查詢語言，從清單中選擇要使用的查詢語言。

   2. 針對查詢字串，在方塊中輸入您的 CloudWatch Logs Insights 查詢。

   3. 對於日誌群組，從清單中選擇要查詢的日誌群組。

5. 在排程設定區段中：

   1. 對於排程表達式，請在查詢執行時設定 。從預先定義的選項中選擇或輸入自訂 Cron 表達式。

   2. 對於建立時生效，請指定排程何時變成作用中。選擇立即開始，或使用 YYYY/MM/DD 格式在特定日期和時間開始。

   3. 針對時間範圍，指定每個查詢執行的回顧期間。以分鐘為單位輸入持續時間，以定義從執行時間開始查詢的時間。

   4. 對於無限期繼續，請指定排程何時結束。選擇無限期執行，或使用 YYYY/MM/DD 格式直到特定日期和時間。

6. 主控台會根據您的組態顯示接下來三個排程的查詢執行，以 UTC 顯示執行查詢的確切日期和時間。

7. 在將查詢結果發佈至 S3 - 選用區段中 （如果使用 S3 目的地）：

   1. 對於 Amazon S3 URI，輸入將存放結果的 Amazon S3 儲存貯體和字首 （例如 s3://my-bucket/query-results/)。

   2. 選擇檢視 Amazon S3，在新索引標籤中開啟 Amazon S3 主控台，並驗證儲存貯體組態。

   3. 選擇瀏覽 Amazon S3，使用 Amazon S3 瀏覽器選取現有的 Amazon S3 位置。

8. 在用於將查詢結果發佈至 Amazon S3 的 IAM 角色區段中：

   1. 針對選取 IAM 角色，選擇具有必要政策的現有 IAM 角色，或在 IAM 主控台中選擇建立新角色以建立新的角色。

   2. 使用搜尋欄位，從清單中選擇適當的 IAM 角色。

9. 在排程查詢執行的 IAM 角色區段中：

   1. 針對選取 IAM 角色，選擇具有所需政策的現有 IAM 角色，或在 IAM 主控台中選擇建立新角色以建立新的角色。

   2. 使用搜尋欄位，從清單中選擇適當的 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動作建立新的排程查詢。下列範例會建立每小時執行的排程查詢：

  {
      "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"
  }