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 zur Überwachung Ihrer Protokolldaten auf zwei Arten erstellen:

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 mithilfe einer geplanten Abfrage ausgeführt, und der Alarm bewertet die aggregierten Ergebnisse anhand eines Schwellenwerts. Weitere Informationen zur Funktionsweise von Log-Alarmen finden Sie unter. Alarme protokollieren

Voraussetzungen

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

Rolle zur geplanten Ausführung von Abfragen

Die Rolle „Geplante Abfrageausführung“ ermöglicht es CloudWatch Logs, die Abfrage in Ihrem Namen auszuführen. Diese Rolle ist für alle Log-Alarme 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 „Geplante Abfrageausführung“.

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

Das folgende Beispiel zeigt die Berechtigungsrichtlinie. Beschränken Sie Resource die ARNs auf die Protokollgruppe, 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 „Loglines“ ermöglicht CloudWatch das Abrufen von Protokollzeilen für Amazon SNS-E-Mail-Benachrichtigungen. Diese Rolle ist nur erforderlich, wenn Sie einen Wert größer als 0 festlegenActionLogLineCount. Die Rolle muss dem cloudwatch.amazonaws.com Dienstprinzipal vertrauen.

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

{
    "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 „Loglines“. Die logs:GetQueryResults Berechtigung ist erforderlich, um Protokollzeilen abzurufen. Beschränken Sie Resource die ARNs auf die Protokollgruppe, 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:*"
        }
    ]
}

Erstellen eines Log-Alarms mithilfe der Konsole

Die Schritte in diesem Abschnitt erläutern, wie Sie die CloudWatch Konsole verwenden, um einen Log-Alarm zu erstellen. Sie können das auch verwenden AWS CLI , um einen Log-Alarm zu erstellen. Weitere Informationen finden Sie unter Erstellen Sie einen Log-Alarm mit dem AWS CLI.

Erstellen Sie einen Log-Alarm mit dem AWS CLI

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

Im folgenden Beispiel wird ein Log-Alarm 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.

Erstellen eines Log-Alarms 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. Mithilfe von Metrikfiltern können Sie in den Protokolldaten, an die die Daten gesendet werden, nach Begriffen und Mustern suchen. CloudWatch Weitere Informationen finden Sie unter Erstellen von Metriken aus Protokollereignissen mithilfe von Filtern im Amazon CloudWatch Logs-Benutzerhandbuch. Bevor Sie einen Alarm auf der Grundlage eines Protokollgruppen-Metrikfilters erstellen, müssen Sie die folgenden Aktionen ausführen: