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 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 à Dépannage des alarmes. Reportez-vous également à Création d'une alarme de base.

    1. Sur la page de liste Définitions d'alarme, sélectionnez l'alarme à utiliser. Si vous avez besoin d'aide pour rechercher 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 de votre choix sont sélectionnés.
    4. Pour définir une règle de déclencheur (pricate) en mode de base (mode 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 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 de la plage.
      • Dans Nombre de minutes de délai de déclenchement, entrez le nombre de minutes pendant lesquelles la condition doit être conservée avant que l'alarme ne 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 pour 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. Insérez éventuellement 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 de déclencheur (prédicate) 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 :
        • Dans Nombre de minutes de délai de déclenchement, entrez le nombre de minutes pendant lesquelles la condition doit être conservée avant que l'alarme ne 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 pour cette condition (règle de déclencheur).
        • 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é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), 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 à 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é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",
    }

    Afin d'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.