Documentation Oracle Cloud Infrastructure

Ajout de règles de déclencheur à une alarme

Définissez des règles de déclenchement ou des prédicats pour une alarme. Une règle de déclenchement est une condition (définie par la requête) qui doit être satisfaite pour que l'alarme soit à l'état de déclenchement. Elle inclut également la gravité, le délai de déclenchement (pendingDuration) et le corps de l'alarme à inclure dans les notifications. La condition d'une règle de déclencheur peut spécifier un seuil, tel que 90 % pour l'utilisation de l'unité centrale, ou une absence.

Ajoutez jusqu'à deux règles de déclenchement, ou prédicats, à une alarme. Par exemple, ajoutez une règle de déclencheur critique de 95 % et une règle de déclencheur d'avertissement de 90 %.

Remarque

Pour comprendre comment les notifications sont envoyées lorsqu'une alarme comporte plusieurs règles de déclenchement, reportez-vous à Regroupement de notifications pour une alarme et à Fractionnement de notifications pour une alarme.
Exemple de règles de déclenchement dans une alarme
{
  "body": "95% CPU utilization",
  "pendingDuration": "PT5M"
  "query": "CPUUtilization[1m].mean()>95",
  "ruleName": "95",
  "severity": "CRITICAL",
},
{
  "body": "90% CPU utilization",
  "pendingDuration": "PT5M"
  "query": "CPUUtilization[1m].mean()>90",
  "ruleName": "90",
  "severity": "WARNING",
}

Pour connaître les opérateurs de prédicat valides dans les expressions MQL, reportez-vous à Opérateurs de prédicat.

Pour le dépannage des alarmes, reportez-vous à la section Dépannage des alarmes. Reportez-vous également à la section Creating a Basic Alarm.

    1. Sur la page de liste Définitions d'alarme, sélectionnez l'alarme à utiliser. Si vous avez besoin d'aide pour trouver la page de liste ou l'alarme, reportez-vous à Liste des alarmes.
    2. Accédez à Actions, puis sélectionnez Modifier une alarme.
    3. Dans la zone Description de mesure, vérifiez que l'espace de noms de mesure et le nom de mesure que vous voulez sont sélectionnés.
    4. Pour définir une règle de déclencheur (prédicat) à l'aide du mode de base (valeur par défaut), accédez à la zone Règle de déclencheur et fournissez les valeurs suivantes :
      • Pour Opérateur, sélectionnez l'opérateur à utiliser dans le seuil de condition. Reportez-vous à Opérateurs de prédicat.
      • Pour Valeur, entrez la valeur à utiliser pour le seuil de condition. Pour les opérateurs entre et extérieur, entrez les deux valeurs de la plage.
      • Pour Délai en minutes de déclenchement, entrez le nombre de minutes pendant lequel la condition doit être conservée avant que l'alarme ne soit à l'état de déclenchement.
      • Pour Gravité de l'alarme, sélectionnez le type de réponse perçu requis lorsque l'alarme est à l'état de déclenchement de cette condition (règle de déclenchement).
      • Pour Corps de l'alarme, entrez le contenu lisible par l'utilisateur de la notification pour cette condition (règle de déclencheur).

        Nous vous recommandons de fournir des directives aux opérateurs pour la résolution de la condition d'alarme. Envisagez d'ajouter des liens vers les pratiques du guide d'exploitation standard. Exemple : alerte d'utilisation élevée de l'UC. Suivez les instructions du guide d'exploitation pour en savoir plus sur la résolution. Vous pouvez éventuellement insérer des variables dynamiques pour afficher la valeur des paramètres de message d'alarme associés dans les messages d'alarme. Par exemple, insérez {{query}} pour afficher la valeur de query.

      • Pour ajouter une autre règle de déclencheur (condition), sélectionnez Règle de déclencheur supplémentaire.
    5. Pour définir une règle (prédicat) de déclencheur en mettant à jour l'expression MQL, procédez comme suit :
      1. En haut de la page Modifier une alarme, sélectionnez Passer en mode avancé.
      2. Indiquez les informations suivantes :
        • Pour Délai en minutes de déclenchement, entrez le nombre de minutes pendant lequel la condition doit être conservée avant que l'alarme ne se passe à l'état de déclenchement.
        • Pour Gravité de l'alarme, sélectionnez le type de réponse perçu requis lorsque l'alarme est à l'état de déclenchement de cette condition (règle de déclenchement).
        • Pour l'éditeur de code de requête, modifiez la requête MQL pour indiquer la règle de déclencheur souhaitée.

          La règle de déclencheur est l'opérateur et le fragment de valeur dans la requête MQL. Par exemple, le fragment > 90 représente l'opérateur supérieur à et une valeur de 90. Exemple de requête MQL :

          CpuUtilization[5m].Mean() > 90

          Pour référence, reportez-vous à Interrogation des données de mesure et à Référence de Monitoring Query Language (MQL).

        • Pour Corps de l'alarme, entrez le contenu lisible par l'utilisateur de la notification pour cette condition (règle de déclencheur).
        • Pour ajouter une autre règle de déclencheur (condition), sélectionnez Règle de déclencheur supplémentaire.
    6. Mettez à jour les autres valeurs de l'alarme, si nécessaire.
      Pour plus d'informations sur les champs, reportez-vous à la rubrique Création d'une alarme de base.
    7. Sélectionnez Enregistrer l'alarme.

  • Utilisez la commande oci monitoring alarm update et les paramètres requis pour mettre à jour les règles de déclenchement d'une alarme. Une règle de déclencheur fait partie de l'expression MQL ou de la requête.

    Pour une alarme avec une règle, utilisez le paramètre --query-text. Exemple de mise à jour de la règle de déclencheur sur une valeur supérieure à 90 % (>90) :

    oci monitoring alarm update --query-text "CPUUtilization[1m].mean()>90" [...]

    Pour une alarme avec plusieurs règles, utilisez le paramètre --overrides. Exemple :

    oci monitoring alarm update --overrides <json_file_path> [...]
    Exemple de fichier JSON pour la demande (alarme avec plusieurs règles de déclenchement)
    {
  "body": "95% CPU utilization",
  "pendingDuration": "PT5M"
  "query": "CPUUtilization[1m].mean()>95",
  "ruleName": "95",
  "severity": "CRITICAL",
},
{
  "body": "90% CPU utilization",
  "pendingDuration": "PT5M"
  "query": "CPUUtilization[1m].mean()>90",
  "ruleName": "90",
  "severity": "WARNING",
}

    Afin d'obtenir la liste complète des paramètres et des valeurs pour les commandes de l'interface de ligne de commandes, reportez-vous à Référence de ligne de commandes pour la surveillance.

  • Exécutez l'opération UpdateAlarm pour mettre à jour une alarme. Une règle de déclencheur fait partie de l'expression MQL dans un attribut query.

    Fournissez les règles de déclencheur à l'aide de UpdateAlarmDetails. Pour une alarme avec une règle (aucune valeur overrides), utilisez l'attribut query. Pour une alarme avec plusieurs règles, utilisez l'attribut overrides.