本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

針對日誌的警示

您可以建立 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"
        }
    ]
}

下列範例顯示許可政策。將 範圍Resource限定為查詢目標的日誌群組 ARNs。

{
    "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許可才能擷取日誌行。將 範圍Resource限定為查詢目標的日誌群組 ARNs。

{
    "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 使用者指南》中的「使用篩選條件從日誌事件建立指標」。根據日誌群組指標篩選條件建立警示之前，必須先完成下列動作：