Definizione delle regole di routing

Per definire una regola di routing, è necessario specificare 1 o più destinazioni per i log della piattaforma. È inoltre possibile definire 1 o più filtri di inclusione che definiscono le condizioni di instradamento dei registri della piattaforma verso tali destinazioni.

Per ogni percorso definito nell'account, è possibile configurare fino a 10 regole. Le regole specificano quali log della piattaforma sono instradati in una regione e dove instradarli. Per ulteriori informazioni, vedere Comprendere il funzionamento dei percorsi nel proprio account.

Una regola è composta da 1 azione, 1 o più target e 0 o più filtri di inclusione.

Destinazioni

I target definiscono l'elenco degli ID dei target verso i quali vengono indirizzati i log della piattaforma.

È possibile specificare fino a tre ID di destinazione per regola.
È possibile definire ID di destinazione per risorse disponibili nella stessa regione in cui si configura il percorso, in una regione diversa e in un account diverso.

Ad esempio, è possibile definire un elenco di target come segue:

"targets": [{"id":"11111111-1111-1111-1111-111111111111"},{"id":"22222222-2222-2222-2222-222222222222"}]

I target devono essere istanze di IBM Cloud Logs.

Azione

L'azione definisce se IBM Cloud Logs Routing include o esclude i registri della piattaforma sul percorso. Sono supportate due azioni: send e drop. Se non viene specificato, l'azione predefinita è l'invio dei log della piattaforma.

send: I log della piattaforma vengono inviati, in base alla regola di routing, sul percorso definito.
drop: I log della piattaforma vengono esclusi, in base alla regola di instradamento, quando i log della piattaforma vengono inviati sul percorso definito.

Filtri di inclusione

I filtri di inclusione definiscono le condizioni utilizzate per determinare quali registri della piattaforma vengono indirizzati alle destinazioni specificate nella regola.

Per instradare tutti i registri della piattaforma, escludere la definizione inclusion_filters quando si configura un percorso.

I filtri di inclusione sono composti da operand, operator e value:

operand

Operando è il nome della proprietà della destinazione utilizzata per filtrare i dati. Sono supportati i seguenti operandi: location. Il valore viene estratto dal CRN di destinazione.

operator

Sono supportati due operatori: in e is.

in

Il valore della proprietà dell'operando viene confrontato con un elenco di valori.

È possibile definire fino a 20 valori.

is

Il valore della proprietà dell'operando viene confrontato con un singolo valore.

Quando si utilizza is, è possibile specificare solo 1 valore.

value

Una stringa, o un array di stringhe, da confrontare con la proprietà operand per determinare se il log è instradato o meno. Quando si utilizza is operator, value deve includere una singola stringa. Quando si utilizza in operator, value può includere più stringhe in un array.

I valori validi dipendono dal sito operand.

location: Qualsiasi luogo in cui sia disponibile IBM Cloud Logs Routing.

Tenere presente queste limitazioni quando si configurano i filtri di inclusione.

È possibile configurare fino a 7 filtri di inclusione per ciascuna regola.
È possibile configurare fino a 20 valori per inclusion_filter.values.
Ogni valore configurato per inclusion_filter.values può essere composto da un massimo di 100 caratteri.

Accesso IAM

Gli utenti devono avere i ruoli IAM appropriati per lavorare con le regole di routing. Per informazioni sui ruoli IAM, vedere Gestione dell'accesso IAM.

Definizione delle regole di instradamento tramite l'interfaccia utente

È possibile configurare le regole di instradamento dei filtri di azione e di inclusione nell'interfaccia utente. Per ulteriori informazioni, vedere Gestione delle rotte.

Definizione delle regole di routing tramite la CLI

Le regole per le rotte e i filtri di inclusione sono definite in formato JSON. Le regole sono definite nei seguenti modi:

Utilizzando l'opzione --rules, le informazioni vengono passate come JSON direttamente al comando.
Utilizzando l'opzione --files, le informazioni vengono passate come file JSON.

Esempio che utilizza l'opzione --rules

L'esempio seguente specifica le regole direttamente sull'opzione --rules. In questo esempio, tutti i registri della piattaforma da us-east sono indirizzati a 0b4e6aa9-257c-4a3a-ae42-9a36a5b3adc7. Tutti i log della piattaforma da eu-de e eu-es sono indirizzati a 6f9137b3-2bb9-4724-851b-153e23c82d80.

'[{"action": "send", "targets":[{"id":"0b4e6aa9-257c-4a3a-ae42-9a36a5b3adc7"}], "inclusion_filters":[{"operand": "location","operator": "is","values": ["us-east"]}]},{"targets":[{"id":"22222222-2222-2222-2222-222222222222"},{"id":"33333333-3333-3333-3333-3333333333333"}], "inclusion_filters":[{"operand": "location","operator": "in","values": ["eu-de","eu-es"]}]}]'

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

L'output del comando è il seguente:

Id           92f4cdb3-212c-4811-bf16-03b5449e0fb8
Name         route1
Rules
             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


             action              send
             inclusion_filters
                                 operand    location
                                 operator   in
                                 values     [eu-de, eu-es]

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


Created At   2026-04-28T22:26:38.022Z
Updated At   2026-04-28T22:26:38.022Z
Managed By   account

Esempio che utilizza l'opzione --file

L'esempio seguente specifica le regole passando un file JSON denominato rules_def.json all'opzione --file:

--file rules_def.json

Il file rules_def.json contiene:

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

Definire le regole di instradamento utilizzando l'API

Gli obiettivi e i filtri di inclusione vengono definiti nelle chiamate API utilizzando rules. Il sito rules è definito in una struttura JSON.

Ad esempio, l'esempio seguente crea una rotta denominata my-route e invia i log della piattaforma dalla regione us-east alle destinazioni 0b4e6aa9-257c-4a3a-ae42-9a36a5b3adc7 e 6f9137b3-2bb9-4724-851b-153e23c82d80.

curl -X POST https://api.private.<REGION>.logs-router.cloud.ibm.com/v3/routes -H "Authorization: Bearer <IAM_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"]
          }
        ]
      }
    ]
  }'

Per ulteriori informazioni, consultare il riferimento API.