Configurer une intégration sortante pour connecter IBM Cloud Logs avec IBM Cloud Event Notifications

Pour envoyer des événements générés lorsqu'une alerte est déclenchée dans une instance IBM Cloud Logs, vous devez connecter votre instance IBM Cloud Logs à Event Notifications en configurant une intégration sortante.

Configuration requise

  • Pour en savoir plus sur les alertes, consultez IBM Cloud Logs Pour plus d'informations, voir Alerting.
  • En savoir plus sur IBM Cloud Event Notifications. Pour plus d'informations, voir Qu'est-ce que IBM Cloud Event Notifications?
  • Avant d'activer les notifications pour IBM Cloud Logs, assurez-vous que vous disposez d'une instance Event Notifications et des autorisations nécessaires pour configurer les ressources dans l'instance Event Notifications.

Étape 1. Définir une autorisation de service à service

Une autorisation de service à service est utilisée dans le compte IBM Cloud pour autoriser le service IBM Cloud Logs à envoyer des événements au service Event Notifications

Vous devez configurer une autorisation de service à service entre l'instance IBM Cloud Logs et l'instance Event Notifications Pour plus d'informations, voir Création d'une autorisation S2S pour travailler avec le service IBM Cloud Event Notifications.

Étape 2. Configuration d'une intégration sortante à l'aide de l'API

Vous pouvez créer une intégration sortante en utilisant l'API. Pour plus d'informations sur la méthode API, voir Créer une intégration sortante.

Vous ne pouvez configurer via l'API que l'intégration entre une instance IBM Cloud Logs et une instance Event Notifications qui se trouvent dans des comptes différents.

Par exemple, vous pouvez utiliser la commande suivante cURL pour créer une intégration via l'API :

curl -X POST "https://API-ENDPOINT/v1/outgoing_webhooks" \
 -H "Authorization: ${IAM_TOKEN}" \
 -H "Accept: application/json" \
 -H "Content-Type: application/json" \
 -d '{
  "type": "ibm_event_notifications",
  "name": "<NAME>",
  "ibm_event_notifications": {
   "event_notifications_instance_id": "<EventNotificationsInstanceID>",
   "region_id": "<Region-of-EventNotifications-Instance>",
   "endpoint_type": "default_or_public"
  }
 }'

  • API-ENDPOINT: Définir le point de terminaison de l'API pour l'instance IBM Cloud Logs.

  • type: Définit le type d'intégration. Réglé sur ibm_event_notifications.

  • name: Entrez un nom pour cette définition de ressource.

  • IAM_TOKEN: Saisissez le IAM_TOKEN. Vous pouvez exécuter la commande suivante pour obtenir le jeton IAM :

    export IAM_TOKEN=`ibmcloud iam oauth-tokens --output json | jq -r '.iam_token'`
    
  • event_notifications_instance_id: Indique l'ID de l'instance Event Notifications.

  • region_id: Indique la région où l'instance Event Notifications est disponible.

  • endpoint_type: Définir si l'intégration passe par le réseau public ou privé. Les valeurs valides sont : default_or_public ou private

Étape 2. Configurer une intégration sortante dans l'interface utilisateur

Effectuez les étapes suivantes pour configurer une intégration sortante :

  1. Dans la console, cliquez sur l'icône Menu de navigation Icône Menu de navigation > Liste des ressources.
  2. Sélectionnez votre instance IBM Cloud Logs.
  3. Dans la navigation IBM Cloud Logs, cliquez sur l'icône Intégrations Intégrations > Intégrations sortantes.
  4. Dans la section des intégrations sortantes, trouvez Event Notifications et cliquez sur Ajouter.
  5. Sur la page Intégrations, cliquez sur Ajouter nouveau.
  6. Si une autorisation IAM entre IBM Cloud Logs et Event Notifications n'existe pas dans votre compte, vous devez en configurer une en cliquant sur Autorisations IAM. Suivez les invites pour accorder l'accès entre les services. Pour plus d'informations, voir Création d'une autorisation S2S pour travailler avec le service IBM Cloud Event Notifications.
  7. Entrez un nom pour l'intégration.
  8. Sélectionnez l'instance de service Event Notifications que vous souhaitez connecter à votre instance IBM Cloud Logs.
  9. Sélectionnez le type de point de terminaison (public ou privé). Pour plus d'informations, voir Points de terminaison de service pour les Event Notifications
  10. Pour confirmer la connexion, cliquez sur Enregistrer.

Une source IBM Cloud Event Notifications est créée avec le nom suivant :

IBM Cloud Logs - <CLOUD_LOGS_INSTANCE_ID>

Par exemple, le nom de la source dans IBM Cloud Event Notifications se présente comme suit :

IBM Cloud Logs - rfdt3147-484f-4dee-b3c7-ab0c85a8e5c7

Le nom de l'intégration sortante n'est pas utilisé pour nommer la source dans l'instance IBM Cloud Event Notifications.

Testez votre connexion

Après avoir activé les notifications pour IBM Cloud Logs, testez votre connexion pour vous assurer que les événements générés par IBM Cloud Logs sont transmis à Event Notifications.

Tout d'abord, effectuez les étapes suivantes dans l'instance Event Notifications

  1. Vérifiez que la source portant le nom IBM Cloud Logs - <CLOUD_LOGS_INSTANCE_ID>, qui correspond au nom de votre intégration, est créée dans l'instance IBM Cloud Event Notifications

    1. Sélectionner les sources.
    2. Recherchez la source avec le nom IBM Cloud Logs - <CLOUD_LOGS_INSTANCE_ID>.
  2. Créez un sujet qui spécifie cette instance Cloud Logs comme source et "Event type" délimité à "Test Event".

    1. Sélectionnez Sujets. Cliquez ensuite sur Créer.
    2. Saisissez un nom de sujet, par exemple CloudLogsInstance-test.
    3. Sélectionnez la source IBM Cloud Logs - <CLOUD_LOGS_INSTANCE_ID> pour l'instance dont vous voulez tester l'intégration.
    4. Sélectionnez le type d'événement Événement de test.
    5. Sélectionnez Ajouter une condition > Enregistrer la source.
    6. Cliquez sur Créer.
  3. Créez une destination et vérifiez qu'elle est configurée. Par exemple, vous pouvez configurer une destination Slack ou un courriel.

  4. Créer un abonnement associant le sujet et la destination.

    1. Saisissez un nom, par exemple Test integration.
    2. Sélectionnez le sujet CloudLogsInstance-test.
    3. Sélectionnez une destination.
    4. Cliquez sur Créer.

Ensuite, dans l'interface IBM Cloud Logs Complétez les étapes suivantes :

  1. Modifiez l'intégration sortante.
  2. Cliquez sur Test.
  3. Vérifiez la destination choisie et l'envoi de l'événement test.