Création d'une route à l'aide de l'interface utilisateur

Effectuez les étapes suivantes pour créer un itinéraire à l'aide de l'interface utilisateur.

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.

Mise à jour d'un itinéraire à l'aide de l'interface utilisateur

Effectuez les étapes suivantes pour mettre à jour un itinéraire à l'aide de l'interface utilisateur.

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, déterminez la route à mettre à jour et cliquez sur l'

5. Cliquez sur Renommer pour renommer l'itinéraire.

6. Cliquez sur Modifier pour mettre à jour les règles d'acheminement.

   Dans Règles de routage, modifiez l'action de la règle :

   • Sélectionnez Send pour que la règle achemine les journaux de la plate-forme vers les cibles associées.

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

   Ajoutez ou modifiez 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 le filtre et la condition souhaités et indiquez la valeur à laquelle le filtre d'inclusion doit correspondre.

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

7. Modifiez la cible à 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.

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

9. Cliquez sur Mettre à jour pour apporter des modifications à votre itinéraire.

Visualisation d'un itinéraire à l'aide de l'interface utilisateur

Effectuez les étapes suivantes pour visualiser un itinéraire à l'aide de l'interface utilisateur.

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, vous pouvez voir la liste des routes configurées.

   L'ordre des itinéraires n'affecte pas le comportement de routage puisqu'ils sont traités indépendamment.

   Chaque route affiche le nom de la route et les règles.

   La page des itinéraires affiche également le guide de routage qui contient des informations supplémentaires sur la configuration du routage.

Suppression d'une route à l'aide de l'interface utilisateur

Effectuez les étapes suivantes pour supprimer un itinéraire à l'aide de l'interface utilisateur.

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, déterminez la route à supprimer et cliquez sur l'

5. Cliquez sur Supprimer pour supprimer l'intégralité de l'itinéraire. Vous devez saisir le nom de l'itinéraire avant qu'il ne soit supprimé.

Prérequis pour l'interface de ligne de commande (CLI)

Avant d'utiliser la CLI pour gérer les itinéraires, effectuez les étapes suivantes :

1. Installez l'interface de ligne de commande IBM Cloud.

2. Installez l'interface de ligne de commande IBM Cloud Logs Routing.

3. Connectez-vous à IBM Cloud. Exécutez la commande suivante : ibmcloud login

Création d'une route à l'aide de l'interface de ligne de commande

Cette commande permet de créer un itinéraire.

Les noms des itinéraires sont uniques dans le compte.

ibmcloud logs-router route create --name NAME --rules RULES | @RULES-FILE [--output FORMAT] [--force]

ibmcloud logs-router route create --name route3 --rules '[{"action": "send", "targets":[{"id":"0b4e6aa9-257c-4a3a-ae42-9a36a5b3adc7"},{"id":"6f9137b3-2bb9-4724-851b-153e23c82d80"}],"inclusion_filters": [{"operand": "location", "operator": "in", "values": ["us-south","eu-de"]}]}]'

Id           cfa2be32-979d-4e99-a2a2-e68e65e9b8cc
Name         route3
Rules
             action              send
             inclusion_filters
                                 operand    location
                                 operator   in
                                 values     [us-south, eu-de]

             targets
                                 id            0b4e6aa9-257c-4a3a-ae42-9a36a5b3adc7
                                 name          cl-target2
                                 target_type   cloud-logs

                                 id            6f9137b3-2bb9-4724-851b-153e23c82d80
                                 name          cl-platform-logs-sydney-113
                                 target_type   cloud-logs


Created At   2026-04-29T12:59:25.764Z
Updated At   2026-04-29T12:59:25.764Z
Managed By   account

ibmcloud logs-router route create --name route4 --rules '[{"action": "send", "targets":[{"id":"0b4e6aa9-257c-4a3a-ae42-9a36a5b3adc7"},{"id":"6f9137b3-2bb9-4724-851b-153e23c82d80"}],"inclusion_filters": [{"operand": "location", "operator": "in", "values": ["us-south","eu-de"]}]},{"action": "send", "targets":[{"id":"0b4e6aa9-257c-4a3a-ae42-9a36a5b3adc7"},{"id":"6f9137b3-2bb9-4724-851b-153e23c82d80"}],"inclusion_filters": [{"operand": "location", "operator": "is", "values": ["us-east"]}]}]'

Id           6bb85c44-7187-4e45-b850-c912ddd2d0bf
Name         route4
Rules
             action              send
             inclusion_filters
                                 operand    location
                                 operator   in
                                 values     [us-south, eu-de]

             targets
                                 id            0b4e6aa9-257c-4a3a-ae42-9a36a5b3adc7
                                 name          cl-target2
                                 target_type   cloud-logs

                                 id            6f9137b3-2bb9-4724-851b-153e23c82d80
                                 name          cl-platform-logs-sydney-113
                                 target_type   cloud-logs


             action              send
             inclusion_filters
                                 operand    location
                                 operator   is
                                 values     [us-east]

             targets
                                 id            0b4e6aa9-257c-4a3a-ae42-9a36a5b3adc7
                                 name          cl-target2
                                 target_type   cloud-logs

                                 id            6f9137b3-2bb9-4724-851b-153e23c82d80
                                 name          cl-platform-logs-sydney-113
                                 target_type   cloud-logs


Created At   2026-04-29T13:01:11.685Z
Updated At   2026-04-29T13:01:11.685Z
Managed By   account

Mise à jour d'une route à l'aide de l'interface de ligne de commande

Cette commande permet de mettre à jour un itinéraire. Toute valeur spécifiée différente de la date de création initiale de la route est mise à jour à la valeur spécifiée dans la commande.

ibmcloud logs-router route update --id ROUTE [--name NAME] [--rules RULES | @RULES-FILE] [--output FORMAT] [--force]

Id           6bb85c44-7187-4e45-b850-c912ddd2d0bf
Name         my-new-route-name
Rules
             action              send
             inclusion_filters
                                 operand    location
                                 operator   in
                                 values     [us-south, eu-de]

             targets
                                 id            0b4e6aa9-257c-4a3a-ae42-9a36a5b3adc7
                                 name          cl-target2
                                 target_type   cloud-logs

                                 id            6f9137b3-2bb9-4724-851b-153e23c82d80
                                 name          cl-platform-logs-sydney-113
                                 target_type   cloud-logs


             action              send
             inclusion_filters
                                 operand    location
                                 operator   is
                                 values     [us-east]

             targets
                                 id            0b4e6aa9-257c-4a3a-ae42-9a36a5b3adc7
                                 name          cl-target2
                                 target_type   cloud-logs

                                 id            6f9137b3-2bb9-4724-851b-153e23c82d80
                                 name          cl-platform-logs-sydney-113
                                 target_type   cloud-logs


Created At   2026-04-29T13:01:11.685Z
Updated At   2026-04-29T13:07:32.677Z
Managed By   account

Suppression d'une route à l'aide de l'interface de ligne de commande

Cette commande permet de supprimer un itinéraire.

ibmcloud logs-router route delete --id route [--force]

Are you sure you want to delete? [y/n]> y
OK

Obtenir des informations sur un itinéraire à l'aide de la CLI

Cette commande permet d'obtenir des informations à propos d'une route pour une région IBM Cloud Logs Routing.

ibmcloud logs-router route get --id route [--output FORMAT]

Id           2a4739ee-7cd6-4e05-b60d-9b2e7b0b7981
Name         route2
Rules
             action    send
             targets
                       id            0b4e6aa9-257c-4a3a-ae42-9a36a5b3adc7
                       name          cl-target2
                       target_type   cloud-logs

                       id            6f9137b3-2bb9-4724-851b-153e23c82d80
                       name          cl-platform-logs-sydney-113
                       target_type   cloud-logs


Created At   2026-04-29T12:55:23.106Z
Updated At   2026-04-29T12:55:23.106Z
Managed By   account

Affichage de toutes les routes d'une région

Cette commande permet de dresser la liste des itinéraires configurés pour une région IBM Cloud Logs Routing.

ibmcloud logs-router route list [--output FORMAT]

Routes et actions d'API

Le tableau suivant répertorie les actions que vous pouvez exécuter pour gérer les routes :

Vous pouvez utiliser des noeuds finaux privés et publics pour gérer les routes. Pour plus d'informations sur la liste des ENDPOINTS disponibles, voir Noeuds finaux.

• Vous pouvez gérer les itinéraires du réseau privé à l'aide d'un point de terminaison API au format suivant : https://api.private.REGION.logs-router.cloud.ibm.com
• Vous pouvez gérer les itinéraires du réseau public à l'aide d'un point de terminaison API au format suivant : https://api.REGION.logs-router.cloud.ibm.com

Vous pouvez désactiver les noeuds finaux publics en mettant à jour les paramètres du compte. Pour plus d'informations, voir Configuration des paramètres d'itinéraire et de région.

Pour plus d'informations sur l'API REST, voir les itinéraires.

Prérequis d'API

Pour effectuer des appels d'API pour gérer des routes, procédez comme suit :

1. Obtenez un jeton d'accès IAM. Pour plus d'informations, voir Extraction des jetons d'accès IAM.
2. Identifiez le noeud final de l'API dans la région où vous prévoyez de configurer ou de gérer une route. Pour plus d'informations, voir Nœuds finaux.

Création d'une route à l'aide de l'API

Vous pouvez utiliser la commande cURL suivante pour créer une route :

Les noms des itinéraires sont uniques dans le compte. Vous ne pouvez pas réutiliser un nom d'itinéraire pour configurer plusieurs destinations.

curl -X POST <ENDPOINT>/v3/routes -H "Authorization: $ACCESS_TOKEN" -H "content-type: application/json" -d '{
    "name": "ROUTE_NAME",
    "rules": [
      {
        "action": "send",
        "targets": [
          {
            "id": "50375218-7cff-4234-bbb4-171bebab8408"
          },
          {
            "id": "c7519d8a-5f97-498b-a229-8542f60955cd"
          }
        ],
        "inclusion_filters": [
          {
            "operand": "location",
            "operator": "is",
            "values": ["us-east"]
          }
        ]
      }
    ]
  }'

Où

<ENDPOINT>

Dans la région où vous prévoyez de configurer ou de gérer un itinéraire. Pour plus d'informations, voir Nœuds finaux.

ROUTE_NAME

Nom à attribuer à la route.

Nom à attribuer à la route.

La longueur maximale est de 1000 caractères.

La longueur minimale est de 1 caractère.

Le nom ne peut pas contenir de caractères spéciaux autres que des espaces vides, -, ., _, :.

N'incluez aucune information d'identification personnelle (PII) dans les noms de ressources.

RULES

Chaîne JSON ou chemin d'accès à un préfixe de fichier JSON avec @ qui définit la manière dont les journaux de la plate-forme sont acheminés.

Les règles sont évaluées dans l'ordre dans lequel elles sont configurées.

La longueur maximale est de 10 règles.

Pour plus d'informations, voir Définition des règles de routage.

Par exemple, vous pouvez utiliser la requête cURL suivante pour créer un itinéraire :

curl -X POST https://api.us-south.logs-router.cloud.ibm.com/v3/routes -H "Authorization: $ACCESS_TOKEN" -H "content-type: application/json" -d '{
    "name": "My-route",
    "rules": [
      {
        "action": "send",
        "targets": [
          {
            "id": "0b4e6aa9-257c-4a3a-ae42-9a36a5b3adc7"
          },
          {
            "id": "6f9137b3-2bb9-4724-851b-153e23c82d80"
          }
        ],
        "inclusion_filters": [
          {
            "operand": "location",
            "operator": "is",
            "values": ["us-east"]
          },
          {
            "operand": "service_name",
            "operator": "in",
            "values": ["codeengine","container-registry"]
          }
        ]
      }
    ]
  }'

La sortie est similaire à la suivante :

{"id":"c7673f63-1260-4f86-bc1a-aaedb89391d8","name":"route5","crn":"crn:v1:bluemix:public:logs-router:global:a/xxxxxxx::route:c7673f63-1260-4f86-bc1a-aaedb89391d8","rules":[{"action":"send","targets":[{"id":"0b4e6aa9-257c-4a3a-ae42-9a36a5b3adc7","name":"cl-target2","crn":"crn:v1:bluemix:public:logs-router:eu-gb:a/xxxxxxx::target:0b4e6aa9-257c-4a3a-ae42-9a36a5b3adc7","target_type":"cloud-logs"},{"id":"6f9137b3-2bb9-4724-851b-153e23c82d80","name":"cl-platform-logs-sydney-113","crn":"crn:v1:bluemix:public:logs-router:eu-gb:a/xxxxxxx::target:6f9137b3-2bb9-4724-851b-153e23c82d80","target_type":"cloud-logs"}],"inclusion_filters":[{"operand":"location","operator":"is","values":["us-east"]}]}],"managed_by":"account","created_at":"2026-04-29T13:26:34.237Z","updated_at":"2026-04-29T13:26:34.237Z"}

Mise à jour d'une route à l'aide de l'API

Vous pouvez modifier le nom d'une route et des règles. Toute valeur spécifiée qui diffère de la valeur initiale de l'itinéraire sera mise à jour en fonction de la valeur spécifiée dans la demande.

Lorsque vous mettez à jour une route, vous devez inclure les informations de route dans la section de données de la demande.

• Vous devez passer toutes les zones.
• Mettez à jour les zones qui doivent être modifiées.

Les noms des itinéraires sont uniques dans le compte. Vous ne pouvez pas réutiliser un nom d'itinéraire pour configurer plusieurs destinations.

Vous pouvez utiliser la commande cURL suivante pour mettre à jour une route :

curl -X PATCH <ENDPOINT>/v3/routes/ROUTE_ID -H "Authorization: $ACCESS_TOKEN" -H "content-type: application/json" -d '{
    "name": "ROUTE_NAME",
    "rules": [
      {
        "action": "send",
        "targets": [
          {
            "id": "d3ebcda8-953d-45ea-a4a7-b47f8c4a9742"
          }
        ],
        "inclusion_filters": [
          {
            "operand": "location",
            "operator": "is",
            "values": ["eu-de"]
          }
        ]
      }
    ]
  }'

Où

<ENDPOINT>

Dans la région où vous prévoyez de configurer ou de gérer un itinéraire. Pour plus d'informations, voir Nœuds finaux.

ROUTE_ID

ID de la route.

ROUTE_NAME

Nom à attribuer à la route.

Nom à attribuer à la route.

La longueur maximale est de 1000 caractères.

La longueur minimale est de 1 caractère.

Le nom ne peut pas contenir de caractères spéciaux autres que des espaces vides, -, ., _, :.

N'incluez aucune information d'identification personnelle (PII) dans les noms de ressources.

RULES

Chaîne JSON ou chemin d'accès à un préfixe de fichier JSON avec @ qui définit la manière dont les journaux de la plate-forme sont acheminés.

Les règles sont évaluées dans l'ordre dans lequel elles sont configurées.

La longueur maximale est de 10 règles.

Pour plus d'informations, voir Définition des règles de routage.

Par exemple, vous pouvez utiliser la demande suivante cURL pour créer un itinéraire à Dallas :

curl -X PATCH https://api.us-south.logs-router.cloud.ibm.com/v3/routes/c7673f63-1260-4f86-bc1a-aaedb89391d8 -H "Authorization: $ACCESS_TOKEN" -H "content-type: application/json" -d '{
    "name": "My new route name",
    "rules": [
      {
        "action": "send",
        "targets": [
          {
            "id": "0b4e6aa9-257c-4a3a-ae42-9a36a5b3adc7"
          },
          {
            "id": "6f9137b3-2bb9-4724-851b-153e23c82d80"
          }
        ],
        "inclusion_filters": [
          {
            "operand": "location",
            "operator": "is",
            "values": ["us-east"]
          }
        ]
      }
    ]
    }
  }'

Suppression d'une route à l'aide de l'API

Vous pouvez utiliser la commande cURL suivante pour supprimer une route :

curl -X DELETE <ENDPOINT>/v3/routes/<route_ID> -H "Authorization: $ACCESS_TOKEN" -H "content-type: application/json"

Où

<ENDPOINT>

Dans la région où vous prévoyez de configurer ou de gérer un itinéraire. Pour plus d'informations, voir Nœuds finaux.

<route_ID>

ID de la route.

Par exemple, vous pouvez utiliser la demande suivante cURL pour supprimer un itinéraire avec l'ID c7673f63-1260-4f86-bc1a-aaedb89391d8:

curl -X DELETE https://api.us-south.logs-router.cloud.ibm.com/v3/routes/c7673f63-1260-4f86-bc1a-aaedb89391d8 -H "Authorization: $ACCESS_TOKEN" -H "content-type: application/json"

Affichage d'une route à l'aide de l'API

Vous pouvez utiliser la commande cURL suivante pour afficher les détails de la configuration de 1 route :

curl -X GET <ENDPOINT>/v3/routes/<route_ID> -H "Authorization: $ACCESS_TOKEN" -H "content-type: application/json"

Où

<ENDPOINT>

Dans la région où vous prévoyez de configurer ou de gérer un itinéraire. Pour plus d'informations, voir Nœuds finaux.

<route_ID>

ID de la route.

Par exemple, vous pouvez exécuter la demande cURL suivante pour obtenir des informations sur une route avec l'ID 00000000-0000-0000-0000-000000000000 :

curl -X GET https://api.us-south.logs-router.cloud.ibm.com/v3/routes/c7673f63-1260-4f86-bc1a-aaedb89391d8 -H "Authorization: $ACCESS_TOKEN" -H "content-type: application/json"

Liste de tous les itinéraires utilisant l'API

Vous pouvez utiliser la commande cURL suivante pour afficher toutes les routes :

curl -X GET <ENDPOINT>/v3/routes -H "Authorization: $ACCESS_TOKEN" -H "content-type: application/json"

Où

• <ENDPOINT>est le nœud final de l'interface de programmation de la région où vous prévoyez de configurer ou de gérer une route. Pour plus d'informations, voir Nœuds finaux.

Par exemple, vous pouvez exécuter la requête cURL suivante pour obtenir des informations sur les itinéraires définis dans Dallas :

curl -X GET https://api.us-south.logs-router.cloud.ibm.com/v3/routes -H "Authorization: $ACCESS_TOKEN" -H "content-type: application/json"

Codes de réponse HTTP

Lorsque vous utilisez l'API REST IBM Cloud Logs Routing, vous pouvez obtenir des codes de réponse HTTP normaux indiquant si une méthode a abouti.

• Une réponse 200 indique toujours le succès.
• Une réponse 4xx indique un incident.
• Une réponse 5xx indique une erreur interne du système.

Voir le tableau suivant pour certains codes de réponse HTTP :