Création d'une alarme de base

• Console
• Interface de ligne de commande
• API

• 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.
     La page Créer une alarme s'ouvre en mode de base (vue par défaut). Les étapes suivantes expliquent comment créer une alarme en mode de base.
  3. Entrez un nom convivial pour l'alarme. Evitez de saisir des informations confidentielles.

     Ce nom est envoyé en tant que titre pour les notifications liées à cette alarme, sauf si vous indiquez un titre de notification (Objet de la notification dans la console).

     Le type d'abonnement détermine l'affichage du nom de l'alarme ou du titre de la notification.

     • Pour les notifications par e-mail, le nom ou le titre de la notification fait partie de la ligne d'objet.
     • Pour les notifications HTTPS, le nom ou le titre de la notification est le champ de titre du message publié.
     • Pour les notifications PagerDuty, le nom ou le titre de la notification est utilisé dans le champ de titre du message publié.
     • Pour les messages Slack, le nom ou le titre de la notification fait partie du titre.
     • Pour les messages SMS, le nom ou le titre de la notification fait partie du message.
  4. (Facultatif) Dans Récapitulatif des alarmes, entrez un récapitulatif personnalisé des alarmes, à l'aide de variables dynamiques si vous le souhaitez.

     Le champ Récapitulatif des alarmes correspond au paramètre de message d'alarme alarmSummary. Pour plus d'informations sur l'apparence par défaut du paramètre dans les messages formatés, reportez-vous à Format de message d'alarme.

     Exemple avec des variables dynamiques :

     {{severity}} alarm triggered because threshold got breached due to {{metricValues}} at {{timestamp}}

     Pour rechercher des variables dynamiques pour un paramètre, reportez-vous à Variables dynamiques.

     Vous pouvez désactiver l'échappement HTML en utilisant la variable dynamique plus longue pour un paramètre d'alarme. Par exemple, pour afficher la valeur du paramètre query dans le message d'alarme avec l'échappement HTML désactivé, entrez la variable dynamique {{{query}}}.

  5. Dans la zone Description de mesure, entrez des valeurs pour indiquer la mesure à évaluer pour l'alarme.
     • Compartiment : Sélectionnez le compartiment contenant les ressources qui émettent les mesures évaluées par l'alarme. Le compartiment sélectionné est également l'emplacement de stockage de l'alarme. Par défaut, le premier compartiment accessible est sélectionné.
     • espace de noms de mesure : sélectionnez le service ou l'application qui émet les mesures pour les ressources à surveiller. La liste Espace de noms de mesure affiche les espaces de noms de mesure du compartiment sélectionné. Par exemple, si le compartiment en cours contient des équilibreurs de charge, la liste inclut oci_lbaas.
     • Groupe de ressources : Sélectionnez le groupe auquel la mesure appartient. Un groupe de ressources est une chaîne personnalisée fournie avec une mesure personnalisée qui ne s'applique pas aux mesures de service.
     • Nom de mesure : Sélectionnez le nom de la mesure à évaluer pour l'alarme. Vous pouvez sélectionner n'importe quelle mesure OCI ou mesure personnalisée si les données existent dans le compartiment et l'espace de noms de mesure sélectionnés.
     • Intervalle : Sélectionnez la fenêtre d'agrégation ou la fréquence à laquelle les points de données sont agrégés. Si vous le souhaitez, vous pouvez créer un intervalle personnalisé. Reportez-vous également à Intervalle.
     • Statistique : sélectionnez la fonction à utiliser pour agréger les points de données.
       • Mean : valeur de Sum divisée par Count pendant la période indiquée.
       • Rate : taux moyen de modification par intervalle.
       • Sum : somme de toutes les valeurs.
       • Max : valeur la plus élevée observée au cours de la période indiquée.
       • Min : valeur la plus faible observée au cours de la période indiquée.
       • Count : nombre d'observations reçues au cours de la période indiquée.
       • P50 : valeur du 50e centile.
       • P90 : valeur du 90e centile.
       • P95 : valeur du 95e centile.
       • P99 : valeur du 99e centile.
  6. Dans la zone Dimension de mesure, indiquez des filtres facultatifs pour restreindre les données de mesure évaluées.
     • 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.
     • Dimension supplémentaire : ajoutez une autre paire nom-valeur pour une dimension, si nécessaire.
     • Agréger les flux de données de mesure : cochez cette case pour renvoyer la valeur combinée de tous les flux de données de mesure pour la statistique sélectionnée.
  7. Dans la zone Règle de déclencheur, indiquez les conditions à remplir pour que l'alarme soit à l'état de déclenchement. Une condition peut spécifier un seuil, tel que 90 % pour l'utilisation de l'UC, ou une absence.
     • 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.

     Remarque
     
     Le graphique situé sous la section Règle de déclencheur affiche de façon dynamique les six dernières heures de mesures émises en fonction des champs sélectionnés pour la requête. Les valeurs très faibles ou très élevées sont indiquées conformément au système international d'unités (SI), par exemple M pour méga (10 puissance six). Pour changer de vue des données du graphique, reportez-vous à la section Basculement entre la vue tabulaire et la vue graphique pour un graphique de mesures d'alarme.
  8. Dans la zone Destination, sous Définir les notifications d'alarme, sélectionnez le fournisseur de la destination à utiliser pour les notifications d'alarme.
     • Destination service: Select one of the following values:
       • Notifications : envoyez des notifications d'alarme à un sujet. Chaque abonnement du sujet reçoit un message d'alarme.
       • Streaming : envoyez des messages d'alarme à un flux de données.
       Remarque
       
       Si vous attendez plus de 60 messages par minute, sélectionnez Streaming. Pour plus d'informations, reportez-vous à Limites de message d'alarme.
     • Compartiment : Sélectionnez le compartiment contenant les ressources qui émettent les mesures évaluées par l'alarme. Le compartiment sélectionné est également l'emplacement de stockage de l'alarme. Par défaut, le premier compartiment accessible est sélectionné.
     • Flux de données (pour Streaming uniquement) : flux de données à utiliser pour les notifications d'alarme.
     • Sujet (pour Notifications uniquement) : sujet à utiliser pour les notifications. Chaque sujet prend en charge des protocoles d'abonnement, tels que PagerDuty.
     • (Facultatif) Objet de la notification (pour Notifications uniquement) : titre de notification personnalisé, à l'aide de variables dynamiques si vous le souhaitez.

       Exemple avec des variables dynamiques :

       {{severity}} alarm triggered because threshold got breached due to {{metricValues}} at {{timestamp}}

       Pour rechercher des variables dynamiques pour un paramètre, reportez-vous à Variables dynamiques.

       Vous pouvez désactiver l'échappement HTML en utilisant la variable dynamique plus longue pour un paramètre d'alarme. Par exemple, pour afficher la valeur du paramètre query dans le message d'alarme avec l'échappement HTML désactivé, entrez la variable dynamique {{{query}}}.

       Le type d'abonnement détermine l'affichage du titre de la notification (ou du nom de l'alarme, si le titre de la notification n'est pas spécifié).

       • Pour les notifications par e-mail, le nom ou le titre de la notification fait partie de la ligne d'objet.
       • Pour les notifications HTTPS, le nom ou le titre de la notification est le champ de titre du message publié.
       • Pour les notifications PagerDuty, le nom ou le titre de la notification est utilisé dans le champ de titre du message publié.
       • Pour les messages Slack, le nom ou le titre de la notification fait partie du titre.
       • Pour les messages SMS, le nom ou le titre de la notification fait partie du message.
     • Pour créer un sujet (et un abonnement) dans le compartiment sélectionné, cliquez sur Créer un sujet, puis saisissez les valeurs suivantes :
       • Nom du sujet : nom convivial du sujet. Par exemple, entrez "Equipe des opérations" pour un sujet utilisé afin d'informer le personnel chargé des opérations du déclenchement d'alarmes. Evitez de saisir des informations confidentielles.
       • Description du sujet : description du nouveau sujet.
       • Protocole d'abonnement : moyen de communication à utiliser pour le nouveau sujet. Sélectionnez le type d'abonnement à créer, puis entrez des valeurs dans les champs associés. Pour plus de détails sur chaque type d'abonnement, cliquez sur les liens.
         • Adresse électronique : entrez une adresse électronique.
         • Fonction : sélectionnez le compartiment et l'application contenant la fonction voulues, puis la fonction.
         • HTTPS (URL personnalisée) : entrez l'URL à utiliser comme adresse.
         • PagerDuty : entrez la partie clé d'intégration de l'URL de l'abonnement PagerDuty. (Les autres parties de l'URL sont codées en dur.)
         • Slack : entrez l'adresse Slack, jeton de webhook inclus.
         • SMS : sélectionnez le pays du numéro de téléphone, puis entrez-le au format E.164. Exemple : +14255550100
  9. Dans Regroupement de messages, sélectionnez l'une des options suivantes.
     • Regrouper les notifications des flux de données de mesure : permet de suivre collectivement le statut de mesure sur tous les flux de données de mesure. Envoyez un message lorsque le statut de mesure change sur tous les flux de données de mesure.
     • Séparer les notifications par flux de données de mesure : permet de suivre individuellement le statut de mesure par flux de données de mesure. Envoyez un message lorsque le statut de mesure de chaque flux de données de mesure change. Pour obtenir un exemple, reportez-vous à Scénario : séparation des messages par flux de données de mesure.
  10. Dans Format de message, sélectionnez une option pour l'apparence des messages que vous recevez à partir de cette alarme (pour Notifications uniquement).
      • Envoyer les messages formatés : présentation simplifiée et conviviale. Afin d'afficher les protocoles d'abonnement et les types de message pris en charge pour les messages formatés (options autres que Données brutes), reportez-vous à Formatage convivial.
      • Envoyer des messages JSON lisibles (texte brut avec des sauts de ligne) : message JSON avec de nouvelles lignes et des retraits.
      • Envoyer les messages bruts : objet BLOB JSON brut.
  11. (Facultatif) Pour recevoir des notifications à intervalles réguliers lors du déclenchement de l'alarme, sélectionnez Répéter la notification ?, puis indiquez la période d'attente avant de renvoyer la notification. Reportez-vous à Meilleures pratiques pour les alarmes.
  12. (Facultatif) Pour supprimer les évaluations et les notifications pendant une durée spécifiée, sélectionnez Supprimer les notifications. Cette option est utile pour éviter les notifications d'alarme pendant les périodes de maintenance système. Indiquez une heure de début, de fin et éventuellement une description. Reportez-vous à Meilleures pratiques pour les alarmes et à Ajout d'une suppression à l'échelle de l'alarme.
  13. (Facultatif) Pour enregistrer l'alarme sans commencer à évaluer les données de mesure, désélectionnez la case Activer cette alarme ?.
  14. (Facultatif) Pour ajouter des balises pour l'alarme, cliquez sur Afficher les options avancées et saisissez des balises.
      Si vous êtes autorisé à créer une ressource, vous disposez également des droits d'accès nécessaires pour lui appliquer des balises à format libre. Pour appliquer une balise définie, vous devez disposer de droits d'accès permettant d'utiliser l'espace de noms de balise. Pour plus d'informations sur le balisage, reportez-vous à Balises de ressource. Si vous n'êtes pas sûr d'appliquer des balises, ignorez cette option ou demandez à un administrateur. Vous pouvez appliquer des balises ultérieurement.
  15. Cliquez sur Créer une alerte.

  La page Définitions d'alarme répertorie la nouvelle alarme. Si l'alarme est activée, Monitoring commence à évaluer la mesure configurée et envoie des messages d'alarme lorsque les données de mesure correspondent à une règle de déclencheur.

• Utilisez la commande oci monitoring alarm create et les paramètres requis pour créer une alarme :

  oci monitoring alarm create --compartment-id <compartment_OCID> --destinations <file_or_text> --display-name <name> --is-enabled <true_or_false> --metric-compartment-id <compartment_OCID> --namespace <metric_namespace> --query-text <mql_expression> --severity <level>

  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.