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 qui inclut également la gravité, le délai de déclenchement (pendingDuration) et le corps de l'alarme à inclure dans les avis. Une condition dans 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 de 95 % et une règle de déclenchement d'avertissement de 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.
Exemples 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 dépannage des alarmes, voir Dépannage des alarmes. 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 certificat.
      • Pour Valeur, entrez la valeur à utiliser pour le seuil de la condition. Pour les opérateurs entre et extérieur, entrez les deux valeurs pour l'intervalle.
      • Pour Minutes de délai de déclenchement, 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 obligatoire 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 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é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. Entrez les valeurs suivantes :
        • Pour Minutes de délai de déclenchement, 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 obligatoire 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 les autres valeurs de l'alarme, au besoin.
      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 surveille la mise à jour d'alarme 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 interrogation.

    Pour une alarme avec une règle, utilisez le paramètre --query-text. Exemple de mise à jour de la règle de déclenchement à une valeur supérieure à 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 valeurs des commandes de l'interface de ligne de commande, voir Référence de 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 comportant plusieurs règles, utilisez l'attribut overrides.