Utilisation de variables dynamiques dans les messages d'alarme

Mode d'affichage des variables dynamiques

La valeur d'un paramètre de message d'alarme est affichée dans un message d'alarme lorsque vous insérez la variable dynamique associée dans les champs pris en charge. Par exemple, entrez le corps d'alarme suivant :

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

Dans l'image suivante d'un message d'alarme, le corps de l'alarme (Corps) est affiché comme suit : Alarme critique déclenchée en raison d'un dépassement du seuil en raison de [CpuUtilization[1m].mean() :92] à l'adresse 2023-08-15T19 :51:00Z

Les variables dynamiques apparaissent dans les notifications contenant des éléments de corps.

• Si des données sont disponibles pour une variable dynamique, celle-ci est résolue et les données apparaissent à sa place. L'exemple de message d'alarme précédent affiche [CpuUtilization[1m].mean():92] à la place de la variable dynamique {{metricValues}}.
• Si aucune donnée n'est disponible pour une variable dynamique, celle-ci n'est pas résolue et apparaît comme codée. Par exemple, si aucune valeur de mesure n'est disponible pour la variable dynamique {{metricValues}}, par exemple lorsque l'alarme est à l'état OK, la variable dynamique {{metricValues}} apparaît dans le message d'alarme.
• Les messages SMS n'ont pas d'éléments de corps, de sorte que les variables dynamiques ne sont pas résolues.

• 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 le nom de l'alarme de votre choix.
  3. Sur la page de détails de l'alarme, cliquez sur Actions, puis sélectionnez Modifier une alarme.
  4. Sur la page Modifier une alarme, recherchez le champ auquel ajouter des variables dynamiques.
     • Corps de l'alarme (paramètre de message d'alarme body) : affiché en tant que champ dans le corps du message d'alarme.
     • Récapitulatif des alarmes (paramètre de message d'alarme alarmSummary) : affiché en tant que champ dans le corps du message d'alarme.
     • Objet de notification (paramètre de message d'alarme title) : le rendu dépend du type de message. Pour un courriel formaté, s'affiche en tant que ligne d'objet. Pour un message Slack, affiche le titre. Pour un message SMS, s'affiche dans le cadre du message.

     Pour plus d'informations sur l'apparence par défaut de ces paramètres de message d'alarme dans les messages formatés, reportez-vous à Format de message d'alarme.

  5. Insérez des variables dynamiques pour les paramètres de message d'alarme de votre choix.

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

  6. Cliquez sur Enregistrer l'alarme.

• Utilisez la commande oci monitoring alarm update et les paramètres requis pour mettre à jour une alarme afin d'utiliser des variables dynamiques dans le champ de votre choix :

  oci monitoring alarm update --alarm-summary <text-including-dynamic-variables> --body <text-including-dynamic-variables> --notification-title <text-including-dynamic-variables> [...]

  Avec des sauts de ligne :

  oci monitoring alarm update 
  --alarm-summary <text-including-dynamic-variables> 
  --body <text-including-dynamic-variables> 
  --notification-title <text-including-dynamic-variables> [...]

  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 afin d'utiliser l'option de format de message de votre choix.

  Lors de la définition des détails de UpdateAlarmDetails, définissez le champ de votre choix (alarmSummary, body ou notificationTitle) sur le texte de votre choix, y compris les variables dynamiques.