Documentation Oracle Cloud Infrastructure

Création d'une alarme d'absence

Créez une alarme d'absence dans Monitoring pour envoyer des notifications lorsqu'une mesure n'émet pas de données pour un intervalle spécifié.

La statistique absent() dans une alarme d'absence renvoie 1 (true) lorsque la mesure est absente pour l'ensemble de l'intervalle. Après des valeurs 1 continues pour la durée de la période de détection d'absence, la statistique arrête de renvoyer des valeurs. Lorsque la mesure est présente au cours de l'intervalle, la statistique renvoie 0 (false).

La période de détection des absences par défaut est de deux heures. Pour plus d'informations sur la période de détection des absences, voir Exemple d'alarme d'absence.

Exemple
La requête de mesure suivante comporte une alarme d'absence pour une instance de calcul définie sur un intervalle de 1 minute (avec la période de détection d'absence par défaut) :
CpuUtilization[1m]{resourceId = "<resource_identifier>"}.groupBy(resourceId).absent()
La requête de mesure suivante définit la période de détection des absences sur 20 heures :
CpuUtilization[1m]{resourceId = "<resource_identifier>"}.groupBy(resourceId).absent(20h)
Remarque

Nous vous recommandons d'inclure groupBy dans la requête de l'alarme d'absence. L'utilisation de groupBy empêche les déclencheurs d'alarme non pertinents lorsque OCI introduit de nouvelles dimensions. Une nouvelle dimension crée un flux de mesure initialement vide.

Avec groupBy, l'alarme surveille uniquement les flux de données de mesure groupés. L'exemple de requête précédent déclenche l'alarme lorsqu'il n'existe aucun flux de données de mesure pour l'instance. Si OCI Compute ajoute une dimension à CpuUtilization et que d'autres flux de données de mesure (d'autres dimensions) ne sont pas absents, l'alarme n'est pas déclenchée.

Sans groupBy, l'alarme surveille tous les flux de données de mesure. Par exemple, prenons la requête CpuUtilization[1m].absent(). Si OCI Compute ajoute une dimension à CpuUtilization, l'alarme est déclenchée, quelle que soit la présence d'autres flux de données de mesure.

Dans le graphique de mesures sur la page Créer une alarme, une ligne rouge en tiret indique le seuil d'absence. L'exemple suivant montre une valeur 1 pour un flux de données de mesure, ce qui indique que l'instance de calcul correspondante n'a pas émis de données de mesure CpuUtilization avant 1:30.
Données de mesure absentes dans un graphique, page Créer une alarme.

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 Créer une alerte.
    3. Dans la section Règle de déclencheur de la page Créer une alarme, configurez le déclencheur d'absence :
      • Operator : sélectionnez absent.
      • 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.

      Vous pouvez également cliquer sur Passer en mode Avancé pour utiliser MQL.

    4. Pour personnaliser la période de détection des absences :
      La période de détection des absences par défaut est de deux heures. Pour plus d'informations sur la période de détection des absences, voir Exemple d'alarme d'absence.
      1. En haut de la page, cliquez sur Passer en mode Avancé.
        La requête apparaît dans le langage MQL (Monitoring Query Language), dans la zone éditeur de code de requête. Exemple :
        CpuUtilization[1m]{resourceId = "<resource_identifier>"}.absent()
      2. Remplacez absent() par absent(<number-and-unit).
        Les valeurs valides sont comprises entre une minute (1m) et trois jours (3d ou 72h). Indiquez la durée de la période de détection des absences à l'aide d'un nombre et d'une unité (m, h ou d pour les minutes, les heures ou le jour).
        Exemple (période de détection des absences de 20 heures) :
        CpuUtilization[1m]{resourceId = "<resource_identifier>"}.absent(20h)
    5. (Facultatif) Pour empêcher les déclencheurs d'alarme non pertinents lorsque OCI introduit de nouvelles dimensions (recommandé) :
      1. Accédez à la zone Dimensions de mesure et fournissez les valeurs suivantes :
        • Nom de la dimension : sélectionnez un qualificatif indiqué dans la définition de mesure. Par exemple, la dimension resourceId est spécifiée dans la définition de mesure pour CpuUtilization.
        • Valeur de dimension : sélectionnez la valeur à utiliser pour la dimension spécifiée. Par exemple, si vous avez sélectionné resourceId comme dimension, sélectionnez l'identificateur de ressource de l'instance que vous surveillez.
      2. En haut de la page, cliquez sur Passer en mode Avancé.
        La requête apparaît dans le langage MQL (Monitoring Query Language), dans la zone éditeur de code de requête. Exemple :
        CpuUtilization[1m]{resourceId = "<resource_identifier>"}.absent()
      3. Dans la zone Editeur de code de requête, avant .absent(), insérez .groupBy(<dimension_name>).
        Exemple :
        CpuUtilization[1m]{resourceId = "<resource_identifier>"}.groupBy(resourceId).absent()
    6. Renseignez les autres champs.
      Pour référence, reportez-vous à Creating a Basic Alarm.
    7. Cliquez sur Enregistrer l'alarme.

  • Utilisez la commande oci monitoring alarm create et les paramètres requis pour créer une alarme de seuil. Pour le paramètre requis --query-text, utilisez une expression MQL qui indique une règle de déclencheur d'absence :

    oci monitoring alarm create --query-text <mql_expression_specifying_absence_trigger_rule> [...]

    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 CreateAlarm pour créer une alarme d'absence.

    Lors de la définition des détails pour CreateAlarmDetails, définissez query sur une expression MQL qui indique une règle de déclencheur d'absence.