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 donné.

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 des absences, la statistique cesse de renvoyer des valeurs. Si la mesure est présente au cours de l'intervalle, la statistique renvoie 0 (faux).

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, reportez-vous à 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 lorsqu'OCI introduit de nouvelles dimensions. Une nouvelle dimension crée un flux de données 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'aucun flux de données de mesure n'existe 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. Prenons par exemple l'interrogation 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.

Sur le graphique de mesures de la page Créer une alarme, une ligne rouge en pointillés indique le seuil d'absence. L'exemple suivant montre une valeur 1 pour un flux de données d'indicateur, ce qui indique que l'instance de calcul correspondant à ce flux de données d'indicateur 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 à la section Dépannage des alarmes.

    1. Sur la page de liste Définitions d'alarme, sélectionnez Créer une alarme. Si vous avez besoin d'aide pour trouver la page de liste, reportez-vous à Liste des alarmes.
    2. Dans la section Règle de déclencheur de la page Créer une alarme, configurez le déclencheur d'absence :
      • Opérateur : sélectionnez absent.
      • Délai en minutes de déclenchement : entrez le nombre de minutes pendant lequel la condition doit être conservée avant que l'alarme ne se passe à l'état de déclenchement.

      Vous pouvez également sélectionner Passer en mode Avancé pour utiliser MQL.

    3. 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, reportez-vous à Exemple d'alarme d'absence.
      1. En haut de la page, sélectionnez Passer en mode avancé.
        La requête apparaît dans Monitoring Query Language (MQL), dans la zone Editeur de code de requête. Exemple :
        CpuUtilization[1m]{resourceId = "<resource_identifier>"}.absent()
      2. Remplacez absent() par absent(<number-and-unit).
        Les valeurs valides vont d'une minute (1m) à 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 la minute, l'heure ou le jour).
        Exemple (période de détection d'absence de 20 heures) :
        CpuUtilization[1m]{resourceId = "<resource_identifier>"}.absent(20h)
    4. (Facultatif) Pour éviter les déclencheurs d'alarme non pertinents lorsqu'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 indiqué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, sélectionnez Passer en mode avancé.
        La requête apparaît dans Monitoring Query Language (MQL), dans la zone Editeur 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()
    5. Indiquez des valeurs pour les champs restants.
      Pour référence, reportez-vous à Création d'une alarme de base.
    6. Sélectionnez 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> [...]

    Afin d'obtenir la liste complète des paramètres et des valeurs pour les commandes de l'interface de ligne de commandes, reportez-vous à Référence de ligne de commandes pour la surveillance.

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