Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Créer des alertes sur les journaux

Vous pouvez créer des CloudWatch alarmes qui surveillent les données de votre journal de deux manières :

Créer une alarme de journal

Créer une alarme de journal

Vous pouvez créer une CloudWatch alarme qui utilise une requête CloudWatch Logs Insights pour surveiller directement les données du journal. La requête est exécutée selon un calendrier à l'aide d'une requête planifiée, et l'alarme évalue les résultats agrégés par rapport à un seuil. Pour plus d'informations sur le fonctionnement des Log Alarms, consultezEnregistrer les alarmes.

Conditions préalables

Avant de créer une alarme de journal, vous devez créer un rôle IAM qui accorde à CloudWatch Logs l'autorisation d'exécuter la requête planifiée. Si vous souhaitez également inclure des lignes de journal dans les notifications Amazon SNS, vous devez créer un deuxième rôle.

Rôle d'exécution des requêtes planifiées

Le rôle d'exécution planifiée des requêtes permet à CloudWatch Logs d'exécuter la requête en votre nom. Ce rôle est obligatoire pour que toutes les alarmes de journal puissent exécuter la requête planifiée. Le rôle doit faire confiance au logs.amazonaws.com responsable du service.

L'exemple suivant montre la politique de confiance pour le rôle d'exécution de requêtes planifiée.

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

L'exemple suivant montre la politique d'autorisations. ResourceÉtendez les ARN du groupe de journaux que la requête cible.

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

Rôle des lignes de journal (facultatif)

Le rôle de lignes de journal permet CloudWatch de récupérer les lignes de journal pour les notifications par e-mail d'Amazon SNS. Ce rôle n'est requis que si vous définissez une valeur supérieure ActionLogLineCount à 0. Le rôle doit faire confiance au cloudwatch.amazonaws.com responsable du service.

L'exemple suivant montre la politique de confiance pour le rôle des lignes de journal.

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

L'exemple suivant montre la politique d'autorisations pour le rôle des lignes de journal. L'logs:GetQueryResultsautorisation est requise pour récupérer les lignes de journal. ResourceÉtendez les ARN du groupe de journaux que la requête cible.

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

Création d'une alarme de journal à l'aide de la console

Les étapes de cette section expliquent comment utiliser la CloudWatch console pour créer une alarme de journal. Vous pouvez également utiliser le AWS CLI pour créer une alarme de journal. Pour de plus amples informations, veuillez consulter Création d'une alarme de journal à l'aide du AWS CLI.

Création d'une alarme de journal à l'aide du AWS CLI

Vous pouvez utiliser la AWS CLI put-log-alarm commande pour créer une alarme de journal.

L'exemple suivant crée une alarme de journal qui surveille le nombre d'erreurs dans un groupe de journaux et passe à ALARM l'état lorsque ce nombre dépasse 100 dans 3 exécutions de requêtes sur 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"

Le tableau suivant décrit les principaux paramètres de la put-log-alarm commande.

Création d'une alarme de journal à l'aide de AWS CloudFormation

Vous pouvez utiliser le type de AWS::CloudWatch::LogAlarm ressource pour créer une alarme de journal dans un AWS CloudFormation modèle.

L'exemple de modèle suivant crée une alarme de journal qui surveille le nombre d'erreurs.

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

Création d'une CloudWatch alarme basée sur un filtre métrique de groupe de journaux

Cette section décrit comment créer une alarme basée sur un filtre de métrique d'un groupe de journaux. Les filtres métriques vous permettent de rechercher des termes et des modèles dans les données du journal au fur et à mesure de leur envoi CloudWatch. Pour plus d'informations, voir Créer des métriques à partir des événements du journal à l'aide de filtres dans le guide de l'utilisateur Amazon CloudWatch Logs. Avant de créer une alarme basée sur un filtre de métrique d'un groupe de journaux, vous devez effectuer les actions suivantes :