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 vos journaux de deux manières :

Création d'une alarme de journal

Création d'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 s'exécute 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 alarmes de journal, 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 que les lignes de journal soient incluses dans les notifications Amazon SNS, vous devez créer un deuxième rôle.

Rôle d'exécution de requêtes planifiée

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 requis pour que toutes les alarmes de journal exécutent la requête planifiée. Le rôle doit faire confiance au directeur du logs.amazonaws.com service.

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

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

L'exemple suivant montre la politique d'autorisation. Étendue du champ d'application Resource aux 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 log (facultatif)

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

L'exemple suivant montre la politique de confiance pour le rôle Loglines.

{
    "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 Loglines. L'logs:GetQueryResultsautorisation est requise pour récupérer les lignes de journal. Étendue du champ d'application Resource aux 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 décrites dans 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 à un ALARM état lorsque le 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 groupes de logs

Cette section décrit comment créer une alarme basée sur un filtre de métrique d'un groupe de journaux. Grâce aux filtres métriques, vous pouvez 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, consultez la section Créer des métriques à partir d'événements de 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 :