Avant de commencer

1. Si vous n'avez pas de compte IBM Cloud, créez un compte IBM Cloud. Vous avez besoin d'un IBMid pour utiliser IBM Cloud.

2. Vérifiez les régions où le service IBM Cloud Logs Routing est disponible.

3. Vérifiez que l'utilisateur qui configure IBM Cloud Logs Routing pour le compte IBM Cloud® dispose des permissions suffisantes pour gérer le service IBM Cloud Logs Routing. Pour plus d'informations, voir Gérer l'accès IAM pour IBM Cloud Logs Routing.

   Vous avez besoin du rôle de plateforme Adminsitrator pour gérer les ressources.

4. Installez les outils suivants :

   • Téléchargez et installez l'interface de ligne de commande IBM Cloud®.

   • Téléchargez et installez jq pour traiter les données de sortie et demander les résultats souhaités.

5. Fournir ou avoir accès à une instance IBM Cloud Logs. Pour plus d'informations, voir Mise à disposition d'une instance.

Création d'une autorisation de service à service

Vous devez utiliser IBM Cloud® Identity and Access Management (IAM) pour créer une autorisation qui accorde à IBM Cloud Logs Routing l'accès à IBM Cloud Logs afin que le service IBM Cloud Logs Routing puisse envoyer des journaux à la destination (cible) de votre instance IBM Cloud Logs.

Vous devez avoir le rôle d' expéditeur pour IBM Cloud Logs avant de configurer le service pour l'autorisation de service.

Procédez comme suit :

1. Dans la console IBM Cloud, cliquez sur Gérer > Accès (IAM), puis sélectionnez Autorisations.

2. Cliquez sur Créer.

3. Configurer le compte source. Sélectionnez Ce compte.

4. Sélectionnez Logs Routing comme service source. Ensuite, définissez l'étendue de l'accès à Toutes les ressources.

5. Sélectionnez Cloud Logs comme service cible. Ensuite, définissez l'étendue de l'accès à Toutes les ressources, ce qui permet d'accéder à toutes les instances IBM Cloud Logs, ou à une seule instance en configurant Ressources basées sur les attributs sélectionnés > Instance de service.

   D'autres attributs ne sont pas pris en charge pour ce type d'autorisation.

6. Dans la section Accès au service, sélectionnez Expéditeur pour attribuer un accès au service source qui accède au service cible.

7. Cliquez sur Autoriser.

Pour plus d'informations, voir Création d'une autorisation S2S pour accorder l'accès à l'envoi de journaux à IBM Cloud Logs.

Configurer l'emplacement des métadonnées primaires et la version de l'API

Procédez comme suit :

1. Connectez-vous à votre compte IBM Cloud.

2. Cliquez sur l'icône de Menu > Observabilité.

3. Cliquez sur Journalisation >Routage.

4. Cliquez sur l'onglet Settings.

5. Cliquez sur Modifier à côté du paramètre à modifier.

   Saisissez l'emplacement des métadonnées primaires.

   Définissez la version de l'API sur 3.

Création d'une cible

Effectuez les étapes suivantes pour créer une cible :

1. Connectez-vous à votre compte IBM Cloud.

2. Cliquez sur l'icône de Menu > Observabilité.

3. Sélectionnez Logging > Routing.

4. Dans la section Cibles, cliquez sur Créer pour ouvrir le panneau de création.

5. Dans la section Choose destination, sélectionnez Search by instance ou Specify CRN.

   Sélectionnez Rechercher par instance pour choisir une instance IBM Cloud Logs dans le tableau disponible dans le compte

   Sélectionnez Spécifier le CR N pour ajouter le CRN de l'instance IBM Cloud Logs d'une instance située dans un compte différent.

6. Dans la section Détails de la cible, effectuez les tâches suivantes :

   Saisissez le nom de la cible.

   Activez la bascule de Non défini pour définir automatiquement votre nouvelle cible comme cible par défaut dans vos paramètres IBM Cloud Logs Routing.

7. Cliquez sur Créer une cible.

Configurer un itinéraire

Effectuez les étapes suivantes pour créer une cible :

1. Connectez-vous à votre compte IBM Cloud.

2. Cliquez sur l'icône de Menu > Observabilité.

3. Cliquez sur Journalisation > Routage.

4. Dans l'onglet Routes, cliquez sur Créer.

5. Dans la section Règles de routage, modifiez l' action pour la règle 1 :

   Sélectionnez une action pour la règle 1 :

   • Sélectionnez Envoyer les journaux de pour la règle afin d'acheminer les journaux de la plate-forme vers les cibles associées.

   • Sélectionnez Drop logs from pour la règle afin de supprimer les journaux de la plate-forme correspondant à cette règle.

   Ajoutez les filtres d'inclusion pour déterminer les journaux de la plate-forme acheminés vers les cibles spécifiées dans la règle.

   • Sélectionnez une condition et indiquez les valeurs d'emplacement qui doivent être prises en compte par le filtre d'inclusion.

   • Pour ajouter plusieurs filtres d'inclusion, cliquez sur Ajouter un filtre pour ajouter des filtres supplémentaires.

   Ajoutez les cibles à associer à la règle en sélectionnant une cible dans la liste. Si aucune cible n'est définie, cliquez sur Ajouter une cible pour en créer une nouvelle.

6. Cliquez sur Ajouter une règle pour ajouter des règles supplémentaires à l'itinéraire.

   L'ordre des règles d'acheminement affecte le comportement du routage. Les règles sont traitées dans l'ordre et lorsqu'une règle est remplie, les règles suivantes ne sont pas traitées.

   L'ordre des règles de routage peut être modifié en cliquant sur les flèches vers le haut et vers le bas à droite de chaque définition de règle.

   Si vous devez supprimer une règle ou un filtre, cliquez sur l'icône Supprimer associée à la règle ou au filtre.

   Vous pouvez configurer jusqu'à 10 règles par route.

7. Cliquez sur Suivant.

8. Saisissez un nom pour l'itinéraire.

9. Revoir la définition de l'itinéraire en s'assurant que l'ordre des règles est conforme à ce qui était prévu.

   Pour plus d'informations, voir Comprendre la priorité de routage.

10. Cliquez sur Créer.

Vérification de l'envoi des journaux à la cible de destination

Vérifiez que les journaux sont acheminés vers votre instance IBM Cloud Logs.

Procédez comme suit :

1. Lancez l'interface web IBM Cloud Logs pour l'instance IBM Cloud Logs qui est configurée comme cible pour collecter les journaux de plate-forme dans une région. Il s'agit de l'instance que vous avez sélectionnée dans l'étape où vous avez configuré une cible.

2. Visualiser les journaux à l'aide de vues personnalisées. Pour plus d'informations, voir Affichage des journaux.

   Tous les journaux de la plateforme sont générés en JSON. Vous pouvez filtrer les journaux de plate-forme dans votre instance en sélectionnant la valeur de ibm-platform-logs comme applicationName ou en exécutant la requête Lucene : coralogix.metadata.applicationName:"ibm-platform-logs"