Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Alarmieren in Protokollen

Sie können CloudWatch Alarme erstellen, die Ihre Protokolldaten auf zwei Arten überwachen:

Erstellen Sie einen Log-Alarm

Erstellen Sie einen Log-Alarm

Sie können einen CloudWatch Alarm erstellen, der eine CloudWatch Logs Insights-Abfrage verwendet, um Protokolldaten direkt zu überwachen. Die Abfrage wird nach einem Zeitplan mit einer geplanten Abfrage ausgeführt, und der Alarm wertet die aggregierten Ergebnisse anhand eines Schwellenwerts aus. Weitere Informationen zur Funktionsweise von Protokollalarmen finden Sie unter. Alarme protokollieren

Voraussetzungen

Bevor Sie einen Log Alarm erstellen, müssen Sie eine IAM-Rolle erstellen, die CloudWatch Logs die Berechtigung erteilt, die geplante Abfrage auszuführen. Wenn Sie möchten, dass auch Protokollzeilen in Amazon SNS SNS-Benachrichtigungen enthalten sind, müssen Sie eine zweite Rolle erstellen.

Rolle „Geplante Abfrageausführung“

Mit der Rolle „Geplante Abfrageausführung“ kann CloudWatch Logs die Abfrage in Ihrem Namen ausführen. Diese Rolle ist für alle Protokollalarme erforderlich, um die geplante Abfrage auszuführen. Die Rolle muss dem logs.amazonaws.com Dienstprinzipal vertrauen.

Das folgende Beispiel zeigt die Vertrauensrichtlinie für die Rolle zur geplanten Abfrageausführung.

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

Das folgende Beispiel zeigt die Berechtigungsrichtlinie. Ordnen Sie Resource die ARNs der Protokollgruppe zu, auf die die Abfrage abzielt.

{
    "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:*"
        }
    ]
}

Rolle „Protokollzeilen“ (optional)

Die Rolle „Protokollzeilen“ ermöglicht CloudWatch das Abrufen von Protokollzeilen für Amazon SNS SNS-E-Mail-Benachrichtigungen. Diese Rolle ist nur erforderlich, wenn Sie einen Wert größer als 0 angeben. ActionLogLineCount Die Rolle muss dem cloudwatch.amazonaws.com Dienstprinzipal vertrauen.

Das folgende Beispiel zeigt die Vertrauensrichtlinie für die Rolle „Loglines“.

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

Das folgende Beispiel zeigt die Berechtigungsrichtlinie für die Rolle „Log Lines“. Die logs:GetQueryResults Berechtigung ist erforderlich, um Protokollzeilen abzurufen. Ordnen Sie die ARNs der Protokollgruppe Resource zu, auf die die Abfrage abzielt.

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

Einen Log-Alarm mithilfe der Konsole erstellen

In den Schritten in diesem Abschnitt wird erklärt, wie Sie mit der CloudWatch Konsole einen Log Alarm erstellen. Sie können den auch verwenden AWS CLI , um einen Protokollalarm zu erstellen. Weitere Informationen finden Sie unter Erstellen eines Log-Alarms mit dem AWS CLI.

Erstellen eines Log-Alarms mit dem AWS CLI

Sie können den AWS CLI put-log-alarm Befehl verwenden, um einen Protokollalarm zu erstellen.

Im folgenden Beispiel wird ein Protokollalarm erstellt, der die Anzahl der Fehler in einer Protokollgruppe überwacht und in den ALARM Status übergeht, wenn die Anzahl bei 3 von 5 Abfrageausführungen 100 überschreitet.

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"

In der folgenden Tabelle werden die wichtigsten Parameter für den put-log-alarm Befehl beschrieben.

Einen Log-Alarm erstellen mit AWS CloudFormation

Sie können den AWS::CloudWatch::LogAlarm Ressourcentyp verwenden, um einen Log Alarm in einer AWS CloudFormation Vorlage zu erstellen.

Die folgende Beispielvorlage erstellt einen Log Alarm, der die Anzahl der Fehler überwacht.

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

Erstellen Sie einen CloudWatch Alarm auf der Grundlage eines Metrikfilters für Protokollgruppen

Das Verfahren in diesem Abschnitt beschreibt, wie ein Alarm basierend auf einem Protokollgruppen-Metrikfilter erstellt wird. Mit metrischen Filtern können Sie in Protokolldaten, an die die Daten gesendet werden, nach Begriffen und Mustern suchen. CloudWatch Weitere Informationen finden Sie unter Metriken aus Protokollereignissen mithilfe von Filtern erstellen im Amazon CloudWatch Logs-Benutzerhandbuch. Bevor Sie einen Alarm auf der Grundlage eines Protokollgruppen-Metrikfilters erstellen, müssen Sie die folgenden Aktionen ausführen: