AWS CloudWatch 작업

이 페이지는 워크플로우 자동화 액션 카탈로그에서 사용할 수 있는 AWS CloudWatch 액션에 대한 참조를 제공합니다. 이러한 액션을 사용하여 AWS CloudWatch에서 로그 데이터를 검색하고 업로드하십시오.

전제 조건

사전 요구 사항 및 자격 증명 설정에 대해서는 AWS 자격 증명 설정을 참조하십시오.

로그 이벤트 가져오기

작업 식별자는 aws.cloudwatch.getLogEvents입니다.

AWS CloudWatch 로그의 지정된 로그 스트림에서 로그 이벤트 배치를 가져옵니다.

다음 표에서는 이 작업의 입력 필드를 설명합니다.

입력	유형	설명	예시
`awsRoleArn`	문자열	선택 사항. AWS API 호출을 위해 수임할 IAM 역할 ARN입니다.	`arn:aws:iam::123456789012:role/my-workflow-role`
`awsAccessKeyId`	문자열	선택 사항. AWS 액세스 키 ID입니다. 시크릿으로 전달하십시오.	`${{ :secrets:awsAccessKeyId }}`
`awsSecretAccessKey`	문자열	선택 사항. AWS 비밀 액세스 키입니다. 시크릿으로 전달하십시오.	`${{ :secrets:awsSecretAccessKey }}`
`awsSessionToken`	문자열	선택 사항. STS 인증을 위한 임시 세션 토큰. 시크릿으로 전달하십시오.	`${{ :secrets:awsSessionToken }}`
`region`	문자열	필수 항목입니다. 타겟 로그 그룹의 AWS 리전입니다.	`us-east-2`
`logStreamName`	문자열	필수 항목입니다. 이벤트를 가져올 로그 스트림의 이름입니다.	`2023/10/27/[$LATEST]abcdef123456`
`logGroupName`	문자열	선택 사항. 로그 스트림이 포함된 로그 그룹의 이름입니다.	`/aws/lambda/my-function`
`logGroupIdentifier`	문자열	선택 사항. 로그 그룹의 ARN 또는 이름입니다. ARN으로 로그 그룹을 참조할 때 `logGroupName` 대신 사용하십시오.	`arn:partition:service:region:account-id:resource`
`startTime`	Int	선택 사항. 밀리초 단위의 Unix 타임스탬프로 표시된 시간 범위의 시작입니다.	`1759296000000`
`endTime`	Int	선택 사항. 시간 범위의 끝으로, 밀리초 단위의 Unix 타임스탬프로 표현됩니다.	`1759296000000`
`limit`	Int	선택 사항. 반환할 로그 이벤트의 최대 수입니다.	`50`
`startFromHead`	부울	선택 사항. `true` 인 경우, 가장 빠른 로그 이벤트를 먼저 반환합니다. 기본값은 `false` 입니다.	`true`
`unmask`	부울	선택 사항. `true` 인 경우, 마스킹되지 않은 로그 이벤트 데이터를 반환합니다. 기본값은 `false` 입니다.	`false`
`nextToken`	문자열	선택 사항. 결과의 다음 페이지를 가져오기 위한 이전 응답의 페이지네이션 토큰입니다.	`f/39218833627378687642013305455131706539523449361490509828/s`

다음 표는 이 작업의 출력 필드를 설명합니다.

산출	유형	예시
`response`	물체	`{"events": [{"timestamp": 123, "message": "string", "ingestionTime": 123}], "nextForwardToken": "string", "nextBackwardToken": "string"}`
`success`	부울	`true` 또는 `false`
`errorMessage`	문자열	`"An error occurred (ExpiredTokenException) when calling the GetLogEvents operation: The security token included in the request is expired"`

산출

유형

예시

response

물체

{"events": [{"timestamp": 123, "message": "string", "ingestionTime": 123}], "nextForwardToken": "string", "nextBackwardToken": "string"}

success

부울

true

또는

false

errorMessage

문자열

"An error occurred (ExpiredTokenException) when calling the GetLogEvents operation: The security token included in the request is expired"

다음 예제 워크플로우는 이 작업을 사용하는 방법을 보여줍니다.

name: get-lambda-logs
description: 'Retrieve log events from an AWS Lambda function'
workflowInputs:
  region:
    type: String
    defaultValue: us-east-2
  logGroupName:
    type: String
    defaultValue: /aws/lambda/my-function
  logStreamName:
    type: String
    defaultValue: 2023/10/27/[$LATEST]abcdef123456
steps:
  - name: get_events_step
    type: action
    action: aws.cloudwatch.getLogEvents
    version: '1'
    inputs:
      region: ${{ .workflowInputs.region }}
      logGroupName: ${{ .workflowInputs.logGroupName }}
      logStreamName: ${{ .workflowInputs.logStreamName }}
      limit: 100
    next: end

업로드 로그 이벤트

작업 식별자는 aws.cloudwatch.putLogEvents입니다.

AWS CloudWatch 로그의 지정된 로그 스트림에 로그 이벤트 배치를 업로드합니다.