Definición de reglas de enrutamiento

Para definir una regla de enrutamiento, debe especificar 1 o más objetivos como destinos de los registros de la plataforma. También puede definir 1 o más filtros de inclusión que definen las condiciones de cómo se enrutan esos registros de plataforma a esos destinos.

Para cada ruta que defina en la cuenta, puede configurar hasta 10 reglas. Las reglas especifican qué registros de plataforma se enrutan en una región y hacia dónde enrutarlos. Para obtener más información, consulte Comprender cómo funcionan las rutas en su cuenta.

Una regla consta de 1 acción, 1 o más objetivos y 0 o más filtros de inclusión.

Destinos

Los objetivos definen la lista de ID de objetivos a los que se dirigen los registros de la plataforma.

Puede especificar hasta tres ID de destino por regla.
Puede definir ID de destino para recursos que estén disponibles en la misma región en la que está configurando la ruta, en una región diferente y en una cuenta diferente.

Por ejemplo, puede definir una lista de objetivos de la siguiente manera:

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

Los objetivos deben ser instancias de IBM Cloud Logs.

Acción

La acción define si IBM Cloud Logs Routing incluye o excluye los registros de la plataforma en la ruta. Se admiten dos acciones: send y drop. Si no se especifica, la acción por defecto es enviar los logs de la plataforma.

send: Los registros de la plataforma se envían, en función de la regla de enrutamiento, por la ruta definida.
drop: Los registros de plataforma se excluyen, en función de la regla de enrutamiento, cuando los registros de plataforma se envían en la ruta definida.

Filtros de inclusión

Los filtros de inclusión definen las condiciones que se utilizan para determinar qué registros de plataforma se enrutan a los destinos especificados en la regla.

Para enrutar todos los registros de la plataforma, excluya la definición inclusion_filters cuando configure una ruta.

Los filtros de inclusión se componen de operand, operator y value:

operand

Operando es el nombre de la propiedad en el objetivo que se utiliza para filtrar los datos. Se admiten los siguientes operandos: location. El valor se extrae del CRN de destino.

operator

Se admiten dos operadores: in y is.

in

El valor de la propiedad del operando se compara con una lista de valores.

Puede definir hasta 20 valores.

is

El valor de la propiedad del operando se compara con un único valor.

Cuando se utiliza is, sólo se puede especificar 1 valor.

value

Una cadena, o una matriz de cadenas, que se comparará con la propiedad operand para determinar si el registro está enrutado o no. Cuando se utiliza is operator, value debe incluir una única cadena. Cuando se utiliza in operator, value puede incluir varias cadenas en una matriz.

Los valores válidos dependen de operand.

location: Cualquier lugar en el que se disponga de IBM Cloud Logs Routing.

Tenga en cuenta estas limitaciones al configurar los filtros de inclusión.

Puede configurar hasta 7 filtros de inclusión para cada regla.
Puede configurar hasta 20 valores para inclusion_filter.values.
Cada valor configurado para inclusion_filter.values puede tener un máximo de 100 caracteres.

Acceso de IAM

Los usuarios deben tener los roles IAM apropiados para trabajar con reglas de enrutamiento. Para obtener información sobre las funciones de IAM, consulte Gestión del acceso de IAM.

Definición de reglas de enrutamiento mediante la interfaz de usuario

Puede configurar las reglas de enrutamiento de los filtros de acción e inclusión en la interfaz de usuario. Para más información, consulte Gestión de rutas.

Definición de reglas de enrutamiento mediante la CLI

Las reglas para las rutas y los filtros de inclusión se definen en formato JSON. Las reglas se definen de las siguientes maneras:

Utilizando la opción --rules, la información se pasa como JSON directamente en el comando.
Utilizando la opción --files, la información se pasa como un archivo JSON.

Ejemplo que utiliza la opción --rules

El siguiente ejemplo especifica reglas directamente en la opción --rules. En este ejemplo, todos los registros de plataforma de us-east se enrutan a 0b4e6aa9-257c-4a3a-ae42-9a36a5b3adc7. Todos los registros de plataforma de eu-de y eu-es se envían 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"]}]}]'

'[{"acción": "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"] }]}]'

La salida del comando tiene el siguiente aspecto:

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

Ejemplo que utiliza la opción --file

El siguiente ejemplo especifica reglas pasando un archivo JSON que se llama rules_def.json en la opción --file:

--file rules_def.json

El archivo 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"
          ]
        }
    ]
  }
]

Definir reglas de enrutamiento mediante la API

Los objetivos y los filtros de inclusión se definen en las llamadas a la API mediante rules. La dirección rules se define en una estructura JSON.

Por ejemplo, el siguiente ejemplo crea una ruta que se denomina my-route y envía los registros de la plataforma desde la región us-east a los objetivos 0b4e6aa9-257c-4a3a-ae42-9a36a5b3adc7 y 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"]
          }
        ]
      }
    ]
  }'

Para más información, consulte la referencia de la API.