Configuration du routage des événements vers des destinations dans IBM Cloud Event Notifications

Après avoir activé les notifications vers IBM Cloud Event Notifications depuis IBM Cloud Logs et configuré les alertes dans IBM Cloud Logs, vous pouvez créer des sujets et des abonnements dans Event Notifications afin que les alertes puissent être transmises à des destinations basées sur les abonnements que vous avez configurés.

L'image suivante montre la relation entre les composants nécessaires à l'alerte :

Relation entre les composants nécessaires à l'
entre les composants nécessaires à l'

Pour configurer l'instance IBM Cloud Event Notifications afin d'acheminer les notifications d'événements lorsqu'une alerte est déclenchée dans IBM Cloud Logs vers vos destinations cibles, vous devez effectuer les étapes suivantes :

Configuration requise

Définir un ou plusieurs thèmes

Les rubriques sont basées sur un modèle de publication et d'abonnement. La rubrique s'abonne aux données d'événements en fonction des conditions que vous configurez. Le service Event Notifications gère l'acheminement et la livraison des alertes de manière fiable vers les destinations correctes en fonction des abonnements que vous configurez.

  • Chaque rubrique est créée sous une source enregistrée.
  • Chaque rubrique peut avoir son propre ensemble de règles, qui achemine la charge entrante vers la rubrique concernée.

Lorsque vous configurez un thème, vous définissez les conditions que le thème surveille pour déterminer si l'événement répond à ses critères d'abonnement. Par exemple, si vous avez plusieurs définitions d'alertes dans votre instance IBM Cloud Logs qui notifient via le même canal Slack, vous pouvez configurer ces alertes dans le même sujet.

Ou, si vous avez plusieurs IBM Cloud Logs définitions d'alertes qui notifient à différents canaux Slack, vous devez configurer un sujet pour chaque canal Slack. Ensuite, vous devez inclure dans chaque configuration de sujet les alertes à notifier au canal Slack associé.

Suivez les étapes suivantes pour créer une rubrique :

  1. Dans la console, cliquez sur l'icône Menu de navigation Icône du menu de navigation > Liste des ressources > Developer Tools.

  2. Sélectionnez votre instance IBM Cloud Event Notifications.

  3. Dans la navigation IBM Cloud Event Notifications, sélectionnez Topics.

  4. Cliquez sur Créer.

  5. Saisissez un nom et une description pour le sujet.

  6. Sélectionnez une source.

    Une source est une ressource configurée automatiquement dans l'instance Event Notifications lorsque vous configurez une intégration sortante dans votre instance IBM Cloud Logs.

  7. Ajouter des règles à la rubrique pour définir les événements générés par les alertes qui entrent dans le champ d'application de la rubrique.

    Choisissez l'une des options suivantes pour configurer des règles qui filtrent les données d'événement auxquelles la rubrique s'abonne :

    • Option 1 : Configurer le type d'événement, le sous-type d'événement ou la gravité de l'événement.

      Vous pouvez choisir un type d'événement. Pour consulter la liste des types pris en charge, voir [Types d'événements/docs/cloud-logs]?topic=cloud-logs-cl-events-for-en#cl-events-for-en-types).

      Vous pouvez choisir un sous-type d'événement. Pour consulter la liste des sous-types pris en charge, voir Sous-types d'événements.

      Vous pouvez choisir une valeur de sévérité. Pour consulter la liste des sévérités prises en charge, voir Sévérités des événements.

    • Option 2 : Vous pouvez définir des conditions avancées qui doivent respecter les spécifications JSONpath. La règle correctement écrite extraira les données appropriées de la charge utile de la requête entrante. Event Notifications supporte l'opérateur == pour l'évaluation de JSONPath.

    • Option 3 : Configurer le type d'événement, le sous-type d'événement ou la gravité de l'événement, ainsi que les conditions avancées.

    Si vous ne sélectionnez aucune règle, une règle par défaut n'est ajoutée, ce qui signifie que toutes les notifications sont envoyées par défaut à la rubrique. Une règle doit être configurée pour qu'un sujet ne s'abonne pas à toutes les données d'événement. Si vous n'avez pas cette règle, les abonnés peuvent recevoir des alertes et les données associées pour chaque alerte générée par l'instance.

  8. Cliquez sur Créer.

Définir 1 ou plusieurs destinations

Une destination définit un canal de notification que vous pouvez utiliser pour notifier le déclenchement d'une alerte.

Les destinations sont des protocoles personnalisés, qui sont des services ou des entités accessibles aux utilisateurs. Pour plus d'informations sur les destinations prises en charge, voir Destinations prises en charge.

Pour plus d'informations sur la création d'une destination, voir Créer une destination IBM Cloud Event Notifications

Définir 1 ou plusieurs abonnements

Un abonnement relie 1 sujet à 1 destination.

Vous devez ajouter des abonnements pour définir quels événements, configurés dans une rubrique, sont acheminés vers une destination.

Pour plus d'informations sur la création d'un abonnement, voir Créer un IBM Cloud Event Notifications abonnement.