Documentation sur Oracle Cloud Infrastructure

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

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

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

Note

Pour comprendre comment les avis sont envoyés lorsqu'une alarme comporte plusieurs règles de déclenchement, voir Regroupement d'avis pour une alarme et Fractionnement d'avis 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 les opérateurs de prédicat valides dans les expressions MQL, voir Opérateurs de prédicat.

Pour le résolution des problèmes d'alarme, voir Troubleshooting Alarms. Voir aussi Création d'une alarme de base.

    1. Dans la page de liste Définitions d'alarme, sélectionnez l'alarme avec laquelle vous voulez travailler. Si vous avez besoin d'aide pour trouver la page de liste ou l'alarme, voir Liste des alarmes.
    2. Allez à Actions, puis sélectionnez Modifier l'alarme.
    3. Dans la zone Description de la 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éclenchement (prédicat) à l'aide du mode de base (par défaut), allez à la zone Règle de déclenchement et fournissez les valeurs suivantes :
      • Pour Opérateur, sélectionnez l'opérateur à utiliser dans le seuil de la condition. Voir Opérateurs de prédicat.
      • Pour Valeur, entrez la valeur à utiliser pour le seuil de la condition. Pour les opérateurs entre et à l'extérieur, entrez les deux valeurs pour l'intervalle.
      • Pour Délai de déclenchement en minutes, entrez le nombre de minutes pendant lequel la condition doit être maintenue avant que l'alarme soit à l'état de déclenchement.
      • Pour Gravité de l'alarme, sélectionnez le type perçu de réponse requis lorsque l'alarme est en état de déclenchement pour cette condition (règle de déclenchement).
      • Pour Corps de l'alarme, entrez le contenu lisible de l'avis pour cette condition (règle de déclenchement).

        Nous recommandons de fournir des conseils aux opérateurs pour résoudre la condition d'alarme. Envisagez d'ajouter des liens aux pratiques du dossier d'exploitation standard. Exemple : "Alerte concernant l'utilisation élevée de l'unité centrale. Suivez les instructions du dossier d'exploitation pour la résolution." Facultativement, insérez des variables dynamiques pour rendre la valeur des paramètres de message d'alarme associés dans les messages d'alarme. Par exemple, insérez {{query}} pour rendre la valeur de query.

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

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

          CpuUtilization[5m].Mean() > 90

          Pour des informations de référence, voir Interrogation des données de mesure et Informations de référence sur MQL (Monitoring Query Language).

        • Pour Corps de l'alarme, entrez le contenu lisible de l'avis pour cette condition (règle de déclenchement).
        • Pour ajouter une autre règle de déclenchement (condition), sélectionnez Règle de déclenchement supplémentaire.
    6. Mettez à jour toutes les autres valeurs de l'alarme, si nécessaire.
      Pour plus d'informations sur les champs, voir 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 dans une alarme. Une règle de déclenchement fait partie de l'expression MQL ou de l'interrogation.

    Pour une alarme avec une règle, utilisez le paramètre --query-text. Exemple de mise à jour d'une règle de déclenchement à plus de 90 % (>90) :

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

    Pour une alarme comportant 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",
}

    Pour la liste complète des paramètres et des valeurs pour les commandes de l'interface de ligne de commande, voir Informations de référence sur la ligne de commande pour le service de surveillance.

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

    Fournissez les règles de déclenchement à 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.