Creare un percorso utilizzando l'interfaccia utente

Per creare un percorso utilizzando l'interfaccia utente, eseguire le seguenti operazioni.

1. Accedere al proprio account IBM Cloud.

2. Fare clic sull'icona Menu > Osservabilità.

3. Fare clic su Registrazione > Instradamento.

4. Nella scheda Percorsi, fare clic su Crea.

5. Nella sezione Regole di instradamento, modificare l' Azione per la Regola 1:

   Selezionare un' azione per la regola 1:

   • Selezionare Invia log da per la regola per instradare i log della piattaforma ai target associati.

   • Selezionare Elimina registri da per la regola per eliminare i registri della piattaforma che corrispondono a questa regola.

   Aggiungere i filtri di inclusione per determinare i log della piattaforma instradati verso le destinazioni specificate nella regola.

   • Selezionare una condizione e specificare i valori di posizione che il filtro di inclusione deve soddisfare.

   • Per aggiungere più filtri di inclusione, fare clic su Aggiungi filtro per aggiungere altri filtri.

   Aggiungere i target da associare alla regola selezionando un target dall'elenco. Se non è stato definito un target, fare clic su Aggiungi target per crearne uno nuovo.

6. Fare clic su Aggiungi regola per aggiungere ulteriori regole al percorso.

   L'ordine delle regole di percorso influisce sul comportamento del routing. Le regole vengono elaborate in ordine e una volta che una regola è stata soddisfatta, le regole successive non vengono elaborate.

   L'ordine delle regole di instradamento può essere modificato facendo clic sulle frecce in alto e in basso a destra di ciascuna definizione di regola.

   Per rimuovere una regola o un filtro, fare clic sull'icona Rimuovi associata alla regola o al filtro.

   È possibile configurare fino a 10 regole per ogni percorso.

7. Fai clic su Next.

8. Inserire un nome per il percorso.

9. Rivedere la definizione del percorso per verificare che l'ordine delle regole sia quello previsto.

   Per ulteriori informazioni, vedere Comprensione della precedenza di routing.

10. Fai clic su Crea.

Aggiornamento di un percorso tramite l'interfaccia utente

Completare i seguenti passaggi per aggiornare un percorso utilizzando l'interfaccia utente.

1. Accedere al proprio account IBM Cloud.

2. Fare clic sull'icona Menu > Osservabilità.

3. Fare clic su Registrazione > Instradamento.

4. Nella scheda Rotte, determinare la rotta da aggiornare e fare clic sull' Azioni.

5. Fare clic su Rinomina per rinominare il percorso.

6. Fare clic su Modifica per aggiornare le regole di percorso.

   In Regole di routing, modificare l'Azione della regola:

   • Selezionare Send per la regola che instrada i registri della piattaforma alle destinazioni associate.

   • Selezionare Drop per la regola per eliminare i registri della piattaforma che corrispondono a questa regola.

   Aggiungere o modificare i filtri di inclusione per determinare i log della piattaforma instradati verso le destinazioni specificate nella regola.

   Selezionare il filtro e la condizione desiderati e specificare il valore a cui il filtro di inclusione deve corrispondere.

   Per aggiungere più filtri di inclusione, fare clic su Aggiungi filtro per aggiungere altri filtri.

7. Modificare il target da associare alla regola selezionando un target dall'elenco. Se non è stato definito un target, fare clic su Aggiungi target per crearne uno nuovo.

8. Fare clic su Aggiungi regola per aggiungere ulteriori regole al percorso.

   L'ordine delle regole di percorso influisce sul comportamento del routing. Le regole vengono elaborate in ordine e una volta che una regola è stata soddisfatta, le regole successive non vengono elaborate.

   L'ordine delle regole di instradamento può essere modificato facendo clic sulle frecce in alto e in basso a destra di ciascuna definizione di regola.

   Per rimuovere una regola o un filtro, fare clic sull'icona Rimuovi associata alla regola o al filtro.

   È possibile configurare fino a 10 regole per ogni percorso.

9. Fare clic su Aggiorna per apportare le modifiche al percorso.

Visualizzazione di un percorso tramite l'interfaccia utente

Per visualizzare un percorso tramite l'interfaccia utente, procedere come segue.

1. Accedere al proprio account IBM Cloud.

2. Fare clic sull'icona Menu > Osservabilità.

3. Fare clic su Registrazione > Instradamento.

4. Nella scheda Rotte è possibile visualizzare l'elenco delle rotte configurate.

   L'ordine delle rotte non influisce sul comportamento di instradamento, poiché vengono elaborate in modo indipendente.

   Ogni percorso visualizza il nome del percorso e le regole.

   La pagina delle rotte visualizza anche la Guida alle rotte con ulteriori informazioni sulla configurazione delle rotte.

Eliminazione di un percorso tramite l'interfaccia utente

Per eliminare una rotta tramite l'interfaccia utente, procedere come segue.

1. Accedere al proprio account IBM Cloud.

2. Fare clic sull'icona Menu > Osservabilità.

3. Fare clic su Registrazione > Instradamento.

4. Nella scheda Percorsi, determinare il percorso da eliminare e fare clic sull' Azioni.

5. Fare clic su Elimina per eliminare l'intero percorso. È necessario inserire il nome della rotta prima di eliminarla.

Prerequisiti CLI

Prima di utilizzare la CLI per gestire le rotte, completare i seguenti passaggi:

1. Installa la CLI IBM Cloud.

2. Installa la CLI IBM Cloud Logs Routing.

3. Accedi a IBM Cloud. Esegui il seguente comando: ibmcloud login

Creazione di una rotta tramite la CLI

Utilizzare questo comando per creare una rotta.

I nomi dei percorsi sono unici nell'account.

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

Aggiornamento di una rotta tramite la CLI

Utilizzare questo comando per aggiornare una rotta. Qualsiasi valore specificato che sia diverso da quello della creazione originaria della rotta verrà aggiornato al valore specificato nel comando.

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

Eliminazione di una rotta tramite la CLI

Utilizzare questo comando per eliminare una rotta.

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

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

Ottenere informazioni su una rotta utilizzando la CLI

Utilizzare questo comando per ottenere informazioni su una rotta per una regione 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

Elenco di tutti i percorsi di una regione

Utilizzare questo comando per elencare le rotte configurate per una regione IBM Cloud Logs Routing.

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

Percorsi e azioni API

La tabella seguente elenca le azioni che si possono eseguire per gestire le rotte:

È possibile utilizzare endpoint pubblici e privati per gestire le rotte. Per ulteriori informazioni sull'elenco dei ENDPOINTS disponibili, vedere Endpoint.

• È possibile gestire le rotte dalla rete privata utilizzando un endpoint API con il seguente formato: https://api.private.REGION.logs-router.cloud.ibm.com
• È possibile gestire le rotte dalla rete pubblica utilizzando un endpoint API con il seguente formato: https://api.REGION.logs-router.cloud.ibm.com

È possibile disattivare gli endpoint pubblici aggiornando le impostazioni dell'account. Per ulteriori informazioni, vedere Configurazione delle impostazioni di percorso e regione.

Per ulteriori informazioni sull'API REST, vedere le rotte.

Prerequisiti API

Per effettuare le chiamate API per gestire le rotte, completare i seguenti passaggi:

1. Ottenere un token di accesso IAM. Per ulteriori informazioni, vedere Recupero dei token di accesso IAM.
2. Identificare l'endpoint API nella regione in cui si intende configurare o gestire una rotta. Per ulteriori informazioni, vedere Endpoint.

Creare una rotta utilizzando l'API

È possibile utilizzare il seguente comando cURL per creare una rotta:

I nomi dei percorsi sono unici nell'account. Non è possibile riutilizzare il nome di una rotta per configurare più destinazioni.

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"]
          }
        ]
      }
    ]
  }'

Dove

<ENDPOINT>

Endpoint API nella regione in cui si intende configurare o gestire una rotta. Per ulteriori informazioni, vedere Endpoint.

ROUTE_NAME

Il nome da assegnare al percorso.

Il nome da assegnare al percorso.

La lunghezza massima è di 1000 caratteri.

La lunghezza minima è di 1 carattere.

Il nome non può includere caratteri speciali diversi da spazio vuoto, -, ., _, :.

Non includere informazioni di identificazione personale (PII) nei nomi delle risorse.

RULES

Stringa JSON o percorso di un file JSON con prefisso @ che definisce l'instradamento dei log della piattaforma.

Le regole vengono valutate nell'ordine in cui sono configurate.

La lunghezza massima è di 10 regole.

Per ulteriori informazioni, vedere Definizione delle regole di routing.

Ad esempio, si può usare la seguente richiesta cURL per creare una rotta:

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"]
          }
        ]
      }
    ]
  }'

L'output sarà simile al seguente:

{"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"}

Aggiornamento di una rotta tramite API

È possibile modificare il nome di una rotta e delle regole. Qualsiasi valore specificato che sia diverso da quando la rotta è stata originariamente creata sarà aggiornato al valore specificato nella richiesta.

Quando si aggiorna un percorso, è necessario includere le informazioni sul percorso nella sezione dati della richiesta.

• È necessario superare tutti i campi.
• Aggiornare i campi da modificare.

I nomi dei percorsi sono unici nell'account. Non è possibile riutilizzare il nome di una rotta per configurare più destinazioni.

È possibile utilizzare il seguente comando cURL per aggiornare una rotta:

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"]
          }
        ]
      }
    ]
  }'

Dove

<ENDPOINT>

Endpoint API nella regione in cui si intende configurare o gestire una rotta. Per ulteriori informazioni, vedere Endpoint.

ROUTE_ID

ID dell'itinerario.

ROUTE_NAME

Il nome da assegnare al percorso.

Il nome da assegnare al percorso.

La lunghezza massima è di 1000 caratteri.

La lunghezza minima è di 1 carattere.

Il nome non può includere caratteri speciali diversi da spazio vuoto, -, ., _, :.

Non includere informazioni di identificazione personale (PII) nei nomi delle risorse.

RULES

Stringa JSON o percorso di un file JSON con prefisso @ che definisce l'instradamento dei log della piattaforma.

Le regole vengono valutate nell'ordine in cui sono configurate.

La lunghezza massima è di 10 regole.

Per ulteriori informazioni, vedere Definizione delle regole di routing.

Ad esempio, è possibile utilizzare la seguente richiesta cURL per creare un percorso a 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"]
          }
        ]
      }
    ]
    }
  }'

Eliminazione di una rotta tramite l'API

Per eliminare una rotta si può usare il seguente comando cURL:

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

Dove

<ENDPOINT>

Endpoint API nella regione in cui si intende configurare o gestire una rotta. Per ulteriori informazioni, vedere Endpoint.

<route_ID>

ID dell'itinerario.

Ad esempio, è possibile utilizzare la seguente richiesta cURL per eliminare una rotta con 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"

Visualizzazione di un percorso tramite l'API

È possibile utilizzare il seguente comando cURL per visualizzare i dettagli di configurazione di 1 rotta:

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

Dove

<ENDPOINT>

Endpoint API nella regione in cui si intende configurare o gestire una rotta. Per ulteriori informazioni, vedere Endpoint.

<route_ID>

ID dell'itinerario.

Ad esempio, è possibile eseguire la seguente richiesta cURL per ottenere informazioni su una rotta con 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"

Elenco di tutti i percorsi che utilizzano l'API

È possibile utilizzare il seguente comando cURL per visualizzare tutte le rotte:

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

Dove

• <ENDPOINT> è l'endpoint API dell'area in cui si intende configurare o gestire una rotta. Per ulteriori informazioni, vedere Endpoint.

Ad esempio, è possibile eseguire la seguente richiesta cURL per ottenere informazioni sulle rotte definite in Dallas:

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

Codici di risposta HTTP

Quando si utilizza l'API REST di IBM Cloud Logs Routing, è possibile ottenere i codici di risposta standard di HTTP per indicare se un metodo è stato completato con successo.

• Una risposta 200 indica sempre il successo.
• Una risposta 4xx indica un fallimento.
• La risposta 5xx indica un errore interno del sistema.

Vedere la tabella seguente per alcuni codici di risposta di HTTP: