로그에 대한 경보

다음 두 가지 방법으로 로그 데이터를 모니터링하는 CloudWatch 경보를 생성할 수 있습니다.

로그 경보 생성

로그 경보 생성

CloudWatch Logs Insights 쿼리를 사용하여 로그 데이터를 직접 모니터링하는 CloudWatch 경보를 생성할 수 있습니다. 쿼리는 예약된 쿼리를 사용하여 일정에 따라 실행되며 경보는 집계된 결과를 임곗값을 기준으로 평가합니다. 로그 경보의 작동 방식에 대한 자세한 내용은 로그 경보 섹션을 참조하세요.

사전 조건

로그 경보를 생성하기 전에 CloudWatch Logs에 예약된 쿼리를 실행할 수 있는 권한을 부여하는 IAM 역할을 생성해야 합니다. Amazon SNS 알림에 로그 라인도 포함하려면 두 번째 역할을 생성해야 합니다.

예약된 쿼리 실행 역할

예약된 쿼리 실행 역할을 사용하면 CloudWatch Logs가 사용자를 대신하여 쿼리를 실행할 수 있습니다. 이 역할은 모든 로그 경보가 예약된 쿼리를 실행하는 데 필요합니다. 역할은 logs.amazonaws.com 서비스 위탁자를 신뢰해야 합니다.

다음 예제에서는 예약된 쿼리 실행 역할에 대한 신뢰 정책을 보여줍니다.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Principal": {
                "Service": "logs.amazonaws.com"
            },
            "Action": "sts:AssumeRole"
        }
    ]
}

다음 예는 권한 정책을 보여줍니다. 쿼리가 대상으로 하는 로그 그룹 ARN으로 Resource의 범위를 지정합니다.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "logs:StartQuery",
                "logs:StopQuery",
                "logs:GetQueryResults",
                "logs:DescribeLogGroups"
            ],
            "Resource": "arn:aws:logs:region:account-id:log-group:your-log-group:*"
        }
    ]
}

로그 라인 역할(선택 사항)

로그 라인 역할을 통해 CloudWatch는 Amazon SNS 이메일 알림에 대한 로그 라인을 가져올 수 있습니다. 이 역할은 ActionLogLineCount를 0보다 큰 값으로 설정한 경우에만 필요합니다. 역할은 cloudwatch.amazonaws.com 서비스 위탁자를 신뢰해야 합니다.

다음 예제에서는 로그 라인 역할에 대한 신뢰 정책을 보여줍니다.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Principal": {
                "Service": "cloudwatch.amazonaws.com"
            },
            "Action": "sts:AssumeRole"
        }
    ]
}

다음 예제에서는 로그 라인 역할에 대한 권한 정책을 보여줍니다. 로그 라인을 가져오려면 logs:GetQueryResults 권한이 필요합니다. 쿼리가 대상으로 하는 로그 그룹 ARN으로 Resource의 범위를 지정합니다.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "logs:GetQueryResults"
            ],
            "Resource": "arn:aws:logs:region:account-id:log-group:your-log-group:*"
        }
    ]
}

콘솔을 사용하여 로그 경보 생성

이 섹션의 단계에서는 CloudWatch 콘솔을 사용하여 로그 경보를 생성하는 방법을 설명합니다. AWS CLI를 사용하여 로그 경보를 생성할 수도 있습니다. 자세한 내용은 AWS CLI를 사용하여 로그 경보 생성 섹션을 참조하세요.

AWS CLI를 사용하여 로그 경보 생성

로그 경보를 생성하려면 AWS CLI put-log-alarm 명령을 사용합니다.

다음 예제에서는 로그 그룹의 오류 수를 모니터링하는 로그 경보를 생성하고 5개의 쿼리 실행 중 3개에서 수가 100을 초과할 때 ALARM 상태로 전환합니다.

aws cloudwatch put-log-alarm \
    --alarm-name "HighErrorCount" \
    --alarm-description "Alarm when error count exceeds 100" \
    --comparison-operator GreaterThanThreshold \
    --threshold 100 \
    --query-results-to-evaluate 5 \
    --query-results-to-alarm 3 \
    --treat-missing-data missing \
    --alarm-actions "arn:aws:sns:region:account-id:topic-name" \
    --scheduled-query-configuration '{
        "QueryString": "fields @timestamp, @message | filter @message like /ERROR/",
        "LogGroupIdentifiers": ["/aws/lambda/my-function"],
        "ScheduledQueryRoleARN": "arn:aws:iam::account-id:role/ScheduledQueryRole",
        "AggregationExpression": "count(*)",
        "ScheduleConfiguration": {
            "ScheduleExpression": "rate(10 minutes)",
            "StartTimeOffset": 600
        }
    }' \
    --action-log-line-count 5 \
    --action-log-line-role-arn "arn:aws:iam::account-id:role/LogLineRole"

다음 표에서는 put-log-alarm 명령의 주요 파라미터를 설명합니다.

AWS CloudFormation을 사용하여 로그 경보 생성

AWS::CloudWatch::LogAlarm 리소스 유형을 사용하여 AWS CloudFormation 템플릿에서 로그 경보를 생성할 수 있습니다.

다음 예제 템플릿은 오류 수를 모니터링하는 로그 경보를 생성합니다.

AWSTemplateFormatVersion: '2010-09-09'
Resources:
  HighErrorCountAlarm:
    Type: AWS::CloudWatch::LogAlarm
    Properties:
      AlarmName: HighErrorCount
      AlarmDescription: Alarm when error count exceeds 100
      ComparisonOperator: GreaterThanThreshold
      Threshold: 100
      QueryResultsToEvaluate: 5
      QueryResultsToAlarm: 3
      TreatMissingData: missing
      ActionLogLineCount: 5
      ActionLogLineRoleArn: !GetAtt LogLineRole.Arn
      ScheduledQueryConfiguration:
        QueryString: "fields @timestamp, @message | filter @message like /ERROR/"
        LogGroupIdentifiers:
          - /aws/lambda/my-function
        ScheduledQueryRoleARN: !GetAtt ScheduledQueryRole.Arn
        AggregationExpression: "count(*)"
        ScheduleConfiguration:
          ScheduleExpression: "rate(10 minutes)"
          StartTimeOffset: 600
      AlarmActions:
        - !Ref AlarmSNSTopic

로그 그룹-지표 필터를 기반으로 CloudWatch 경보 생성

이 섹션의 절차는 로그 그룹 지표 필터를 기반으로 경보를 생성하는 방법을 설명합니다. 지표 필터를 사용하면 데이터가 CloudWatch로 전송될 때 로그 데이터에서 용어와 패턴을 찾을 수 있습니다. 자세한 내용을 알아보려면 Amazon CloudWatch Logs 사용 설명서의 필터를 사용하여 로그 이벤트에서 지표 생성을 참조하세요. 로그 그룹 지표 필터를 기반으로 경보를 생성하려면 먼저 다음 작업을 완료해야 합니다.