Documentation sur Oracle Cloud Infrastructure

Création d'une alarme d'absence

Créez une alarme d'absence dans le service de surveillance pour envoyer des avis lorsqu'une mesure n'émet pas de données pendant un intervalle spécifié.

La statistique absent() dans une alarme d'absence retourne 1 (Vrai) lorsque la mesure est absente pendant tout 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 retourner des valeurs. Lorsque la mesure est présente pendant l'intervalle, la statistique retourne 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, voir Exemple d'alarme d'absence.

Exemple
L'interrogation de mesure suivante comporte une alarme d'absence pour une instance de calcul qui est 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()
L'interrogation de mesure suivante règle la période de détection des absences à 20 heures :
CpuUtilization[1m]{resourceId = "<resource_identifier>"}.groupBy(resourceId).absent(20h)
Note

Il est recommandé d'inclure groupBy dans l'interrogation 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 mesure initialement vide.

Avec groupBy, l'alarme surveille uniquement les flux de mesure regroupés. L'exemple d'interrogation précédent déclenche l'alarme lorsqu'il n'existe aucun flux de mesure pour l'instance. Si le service de calcul pour OCI ajoute une dimension à CpuUtilization et que d'autres flux de mesure (à partir d'autres dimensions) ne sont pas absents, l'alarme n'est pas déclenchée.

Sans groupBy, l'alarme surveille tous les flux de mesure. Par exemple, considérons l'interrogation CpuUtilization[1m].absent(). Si le service de calcul pour OCI ajoute une dimension à CpuUtilization, l'alarme est déclenchée, quelle que soit la présence d'autres flux de mesure.

Dans le graphique de mesure 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 mesure, qui indique que l'instance de calcul correspondant à ce flux de mesure 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 résolution des problèmes d'alarme, voir Troubleshooting Alarms.

    1. Dans 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, voir Liste des alarmes.
    2. Dans la section Règle de déclenchement de la section Créer une alarme, configurez le déclencheur d'absence :
      • Opérateur : Sélectionnez absent.
      • Délai de déclenchement en minutes : Entrez le nombre de minutes pendant lequel la condition doit être maintenue avant que l'alarme soit à l'état de déclenchement.

      Sinon, sélectionnez 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, voir Exemple d'alarme d'absence.
      1. En haut de la page, sélectionnez Passer en mode avancé.
        L'interrogation s'affiche dans le langage MQL (Monitoring Query Language), dans la zone Éditeur de code d'interrogation. 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). Spécifiez 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 une minute, une heure ou un 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. Allez à la zone Dimensions Mesure et fournissez les valeurs suivantes :
        • Nom de dimension : Sélectionnez un qualificatif spécifié dans la définition de mesure. Par exemple, la dimension resourceId est indiquée dans la définition de la 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 pour l'instance que vous surveillez.
      2. En haut de la page, sélectionnez Passer en mode avancé.
        L'interrogation s'affiche dans le langage MQL (Monitoring Query Language), dans la zone Éditeur de code d'interrogation. Exemple :
        CpuUtilization[1m]{resourceId = "<resource_identifier>"}.absent()
      3. Dans la zone Éditeur de code d'interrogation, avant .absent(), insérez .groupBy(<dimension_name>).
        Exemple :
        CpuUtilization[1m]{resourceId = "<resource_identifier>"}.groupBy(resourceId).absent()
    5. Entrez des valeurs pour les autres champs.
      Pour plus d'informations, voir 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 spécifie une règle de déclenchement d'absence :

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

    Pour la liste complète des paramètres et des valeurs pour les commandes de l'interface de ligne de commande, voir Informations de référence sur la ligne de commande pour le service de surveillance.

  • Exécutez l'opération CreateAlarm pour créer une alarme d'absence.

    Lors de la définition des détails pour CreateAlarmDetails, réglez query à une expression MQL qui spécifie une règle de déclenchement d'absence.