Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Creazione di allarmi sui log

È possibile creare CloudWatch allarmi che monitorano i dati di registro in due modi:

Crea un avviso di registro

Crea un Log Alarm

È possibile creare un CloudWatch allarme che utilizza una query di CloudWatch Logs Insights per monitorare direttamente i dati di registro. La query viene eseguita in base a una pianificazione utilizzando una query pianificata e l'allarme valuta i risultati aggregati rispetto a una soglia. Per ulteriori informazioni sul funzionamento di Log Alarms, vedere. Registra allarmi

Prerequisiti

Prima di creare un Log Alarm, devi creare un ruolo IAM che conceda a CloudWatch Logs l'autorizzazione a eseguire la query pianificata. Se desideri includere anche le righe di registro nelle notifiche di Amazon SNS, devi creare un secondo ruolo.

Ruolo di esecuzione pianificata delle query

Il ruolo di esecuzione pianificata delle query consente a CloudWatch Logs di eseguire la query per conto dell'utente. Questo ruolo è necessario affinché tutti gli allarmi di registro eseguano la query pianificata. Il ruolo deve considerare attendibile il responsabile del logs.amazonaws.com servizio.

L'esempio seguente mostra la politica di attendibilità per il ruolo pianificato di esecuzione delle query.

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

L'esempio seguente mostra la politica delle autorizzazioni. Limita l'ambito Resource agli ARN del gruppo di log a cui è indirizzata la query.

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

Ruolo delle righe di registro (opzionale)

Il ruolo log lines consente di CloudWatch recuperare le righe di registro per le notifiche e-mail di Amazon SNS. Questo ruolo è obbligatorio solo se è impostato su ActionLogLineCount un valore maggiore di 0. Il ruolo deve affidarsi al responsabile del cloudwatch.amazonaws.com servizio.

L'esempio seguente mostra la politica di attendibilità per il ruolo log lines.

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

L'esempio seguente mostra la politica di autorizzazione per il ruolo log lines. L'logs:GetQueryResultsautorizzazione è necessaria per recuperare le righe di registro. Limita l'ambito Resource agli ARN del gruppo di log a cui è indirizzata la query.

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

Creazione di un Log Alarm utilizzando la console

I passaggi di questa sezione spiegano come utilizzare la CloudWatch console per creare un Log Alarm. È inoltre possibile utilizzare il AWS CLI per creare un Log Alarm. Per ulteriori informazioni, consulta Creazione di un allarme di registro utilizzando il AWS CLI.

Creazione di un allarme di registro utilizzando il AWS CLI

È possibile utilizzare il AWS CLI put-log-alarm comando per creare un Log Alarm.

L'esempio seguente crea un Log Alarm che monitora il conteggio degli errori in un gruppo di log e passa a ALARM indicare quando il conteggio supera 100 in 3 esecuzioni di query su 5.

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"

La tabella seguente descrive i parametri chiave del comando. put-log-alarm

Creazione di un allarme di registro utilizzando AWS CloudFormation

È possibile utilizzare il tipo di AWS::CloudWatch::LogAlarm risorsa per creare un Log Alarm in un AWS CloudFormation modello.

Il modello di esempio seguente crea un Log Alarm che monitora il conteggio degli errori.

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

Crea un CloudWatch allarme basato su un filtro metrico di gruppo di log

La procedura in questa sezione illustra come creare un allarme basato su un filtro parametri del gruppo di log. Con i filtri metrici, puoi cercare termini e modelli nei dati di registro man mano che i dati vengono inviati. CloudWatch Per ulteriori informazioni, consulta Creare metriche dagli eventi di log utilizzando i filtri nella Amazon CloudWatch Logs User Guide. Prima di creare un allarme basato su un filtro parametri del gruppo di log, devi completare le azioni seguenti: