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

Définissez des règles de déclencheur ou des prédicats pour une alarme. Une règle de déclencheur 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. Une condition dans une règle de déclencheur peut spécifier un seuil, tel que 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éclencheur critique pour 95 % et une règle de déclencheur d'avertissement pour 90 %.

Remarque

Pour comprendre comment les notifications sont envoyées lorsqu'une alarme comporte plusieurs règles de déclencheur, reportez-vous à Regroupement des notifications pour une alarme et à Fractionnement des 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 à Dépannage des alarmes.

    1. Ouvrez le menu de navigation et cliquez sur Observation & gestion. Sous Surveillance, cliquez sur Définitions d'alarme.
    2. Cliquez sur le nom de l'alarme à mettre à jour.
    3. Sur la page de détails d'une alarme, cliquez sur Actions, puis sélectionnez Modifier une alarme.
    4. Dans la zone Description de mesure, vérifiez que l'espace de noms de mesure et le nom de mesure de votre choix sont sélectionnés.
    5. Pour définir une règle de déclencheur (prédicat) en mode de base (mode par défaut), accédez à la zone Règle de déclencheur et fournissez les valeurs suivantes :
      • Dans Opérateur, sélectionnez l'opérateur à utiliser dans le seuil de la condition. Reportez-vous à Opérateurs de prédicat.
      • Dans Valeur, entrez la valeur à utiliser pour le seuil de la condition. Pour les opérateurs between et outside, entrez les deux valeurs de la plage.
      • Pour Minutes de délai de déclenchement, entrez le nombre de minutes pendant lesquelles la condition doit être remplie avant que l'alarme ne passe à l'état de déclenchement.
      • Dans 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éclencheur).
      • Dans 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 concernant 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), cliquez sur Règle de déclencheur supplémentaire.
    6. Pour définir une règle de déclencheur (predicate), en mettant à jour l'expression MQL, procédez comme suit :
      1. En haut de la page Modifier une alarme, cliquez sur Passer en mode avancé.
      2. Indiquez les informations suivantes :
        • Pour Minutes de délai de déclenchement, entrez le nombre de minutes pendant lesquelles la condition doit être remplie avant que l'alarme ne passe à l'état de déclenchement.
        • Dans 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éclencheur).
        • Pour Editeur de code de requête, modifiez la requête MQL pour indiquer la règle de déclencheur de votre choix.

          La règle de déclenchement 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 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).

        • Dans 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), cliquez sur Règle de déclencheur supplémentaire.
    7. Mettez à jour les autres valeurs de l'alarme, si nécessaire.
      Pour plus d'informations sur les champs, voir Création d'une alarme de base.
    8. Cliquez sur Enregistrer l'alarme.
  • Utilisez la commande oci monitoring alarm update et les paramètres requis pour mettre à jour les règles de déclencheur dans une alarme. Une règle de déclencheur fait partie de l'expression ou de la requête MQL.

    Pour une alarme avec une règle, utilisez le paramètre --query-text. Exemple de mise à jour de la règle de déclencheur avec 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éclencheur)
    {
      "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 obtenir la liste complète des paramètres et des valeurs des commandes d'interface de ligne de commande, reportez-vous à Référence de ligne de commande pour Monitoring.

  • 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.