Création d'une alarme à l'aide d'une requête ProMQL - Amazon CloudWatch
Création d'une alarme ProMQL à l'aide du AWS Management ConsoleCréation d'une alarme ProMQL ()AWS CLICréation d'une alarme ProMQL depuis Query Studio

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éation d'une alarme à l'aide d'une requête ProMQL

Vous pouvez créer une CloudWatch alarme qui utilise une requête instantanée ProMQL pour surveiller les métriques ingérées via le CloudWatch point de terminaison OTLP. Toutes les séries chronologiques correspondantes renvoyées par la requête sont considérées comme des violations, et l'alarme suit chaque série chronologique de violation en tant que contributrice. Pour plus d'informations sur le fonctionnement des alarmes ProMQL, consultez. Alarmes ProMQL

Création d'une alarme ProMQL à l'aide du AWS Management Console

Cet exemple montre comment créer une alarme qui surveille une métrique de jauge et vous avertit lorsque sa valeur tombe en dessous de 20.

Pour créer une alarme ProMQL

  1. Ouvrez la CloudWatch console à l'adresse https://console.aws.amazon.com/cloudwatch/.

  2. Dans le panneau de navigation, choisissez Alarms (alertes), All Alarms (Toutes les alertes).

  3. Choisissez Create alarm (Créer une alerte).

  4. Choisissez ProMQL pour le type de métrique.

  5. En mode éditeur, entrez la requête ProMQL :

    my_gauge_metric < 20

  6. Sous Conditions, spécifiez les éléments suivants :

    • Pour Intervalle d'évaluation, choisissez1 minute, pour définir la fréquence à laquelle la requête ProMQL est évaluée.

    • Pour Période d'attente120, entrez la durée en secondes qu'un contributeur doit franchir avant de passer à l'état ALARM.

    • Pour la période de récupération300, entrez la durée en secondes qu'un contributeur ne doit pas franchir avant de passer à l'état OK.

  7. Configurez les notifications et les actions selon les besoins.

  8. Ajoutez un nom et une description pour votre alarme.

  9. Choisissez Suivant.

  10. Sélectionnez Créer une alerte.

Création d'une alarme ProMQL ()AWS CLI

Utilisez l'action PutMetricAlarmAPI pour créer une alarme ProMQL.

Exemple Créez une alarme ProMQL qui se déclenche lorsqu'une métrique de jauge tombe en dessous de 20
aws cloudwatch put-metric-alarm \
  --alarm-name MyPromQLAlarm \
  --evaluation-criteria '{"PromQLCriteria":{"Query":"my_gauge_metric < 20"}}' \
  --evaluation-interval 60
Exemple Création d'une alarme ProMQL avec une période d'attente

Cette alarme attend 300 secondes (5 minutes) avant de passer à ALARM l'état, et attend 600 secondes (10 minutes) avant de se rétablir.

aws cloudwatch put-metric-alarm \
  --alarm-name HighLatencyAlarm \
  --evaluation-criteria '{"PromQLCriteria":{"Query":"histogram_quantile(0.99, rate(http_request_duration_seconds_bucket[5m])) > 0.5","PendingPeriod":300,"RecoveryPeriod":600}}' \
  --evaluation-interval 60
Exemple Création d'une alarme ProMQL avec une action de notification SNS
aws cloudwatch put-metric-alarm \
  --alarm-name MyPromQLAlarmWithAction \
  --evaluation-criteria '{"PromQLCriteria":{"Query":"my_gauge_metric < 20","PendingPeriod":0,"RecoveryPeriod":0}}' \
  --evaluation-interval 60 \
  --alarm-actions arn:aws:sns:us-east-1:123456789012:MyTopic

Création d'une alarme ProMQL depuis Query Studio

Cet exemple montre comment créer une alarme ProMQL à partir de Query Studio qui vous alerte lorsque la durée moyenne des requêtes HTTP pour un service dépasse 500 millisecondes.

Contrairement aux CloudWatch alarmes standard où le seuil est configuré comme une étape séparée, les alarmes ProMQL définissent la condition d'alarme (seuil) dans le cadre de la requête elle-même. Par exemple, l'opérateur de comparaison (>) et la valeur de seuil (0.5) sont intégrés directement dans l'expression ProMQL.

Pour créer une alarme ProMQL à partir de Query Studio

  1. Ouvrez la CloudWatch console à l'adresse https://console.aws.amazon.com/cloudwatch/.

  2. Dans le volet de navigation situé sous Metrics, choisissez Query Studio (Preview).

  3. Sélectionnez ProMQL dans le menu déroulant du langage de requête.

  4. Créez votre requête en utilisant l'un des modes suivants :

    • En mode Générateur, sélectionnez un nom de métrique dans le champ Métrique (par exemple,http.server.request.duration). Ajoutez des filtres d'étiquette selon vos besoins (par exemple, @resource.service.name =my-api). Pour définir le seuil d'alarme, sélectionnez une opération de base (par exemple>) et entrez un numéro (par exemple,0.5).

    • En mode Code, entrez directement l'expression ProMQL, par exemple :

      histogram_avg({"http.server.request.duration", "@resource.service.name"="my-api"}) > 0.5

  5. Choisissez Exécuter pour exécuter la requête et vérifier qu'elle renvoie les résultats attendus.

  6. Choisissez Créer une alarme dans le menu Actions.

  7. Vous êtes redirigé vers la page de création CloudWatch d'alarme avec votre requête ProMQL préremplie.

  8. Sous Conditions, spécifiez les éléments suivants :

    • Pour Intervalle d'évaluation, choisissez1 minute, pour définir la fréquence à laquelle la requête ProMQL est évaluée.

    • Pour Période d'attente60, entrez la durée en secondes que la requête doit enfreindre avant de passer à l'état ALARM. Cela signifie que la latence doit dépasser le seuil pendant au moins 60 secondes avant que l'alarme ne se déclenche.

    • Pour la période de restauration120, entrez la durée en secondes que la requête ne doit pas enfreindre avant de passer à l'état OK. Cela signifie que la latence doit rester inférieure au seuil pendant au moins 120 secondes avant que l'alarme ne se rétablisse.

  9. Configurez les notifications et les actions selon les besoins.

  10. Ajoutez un nom et une description pour votre alarme.

  11. Choisissez Suivant.

  12. Sélectionnez Créer une alerte.

Note

La requête ProMQL doit renvoyer une seule série chronologique pour créer une alarme. Si votre requête renvoie plusieurs séries chronologiques, utilisez des fonctions d'agrégation telles que sumavg, ou topk pour réduire le résultat à une seule série avant de créer l'alarme.