예약된 쿼리 생성

예약된 쿼리를 생성하려면(콘솔)

1. 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 작업을 사용하여 새 예약된 쿼리를 생성합니다. 다음 예제에서는 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"
  }