Definieren von Routing-Regeln

Um eine Weiterleitungsregel zu definieren, müssen Sie 1 oder mehrere Ziele für die Plattformprotokolle angeben. Sie können auch 1 oder mehrere Einschlussfilter definieren, die die Bedingungen festlegen, unter denen diese Plattformprotokolle an diese Ziele weitergeleitet werden.

Für jede Route, die Sie im Konto definieren, können Sie bis zu 10 Regeln konfigurieren. Die Regeln legen fest, welche Plattformprotokolle in einer Region weitergeleitet werden und wohin sie geleitet werden sollen. Weitere Informationen finden Sie unter Verstehen, wie Routen in Ihrem Konto funktionieren.

Eine Regel besteht aus 1 Aktion, 1 oder mehreren Zielen und 0 oder mehreren Einschlussfiltern.

Ziele

Ziele definieren die Liste der Ziel-IDs, an die die Plattformprotokolle weitergeleitet werden.

Sie können bis zu drei Ziel-IDs pro Regel angeben.
Sie können Ziel-IDs für Ressourcen definieren, die in derselben Region, in der Sie die Route konfigurieren, in einer anderen Region und in einem anderen Konto verfügbar sind.

Sie können zum Beispiel eine Liste von Zielen wie folgt definieren:

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

Ziele müssen IBM Cloud Logs Instanzen sein.

Aktion

Aktion legt fest, ob IBM Cloud Logs Routing Plattformprotokolle auf der Route einschließt oder ausschließt. Es werden zwei Aktionen unterstützt: send und drop. Wenn nichts angegeben wird, werden standardmäßig die Plattformprotokolle gesendet.

send: Plattformprotokolle werden auf der Grundlage der Routing-Regel auf der festgelegten Route gesendet.
drop: Plattformprotokolle werden auf der Grundlage der Routing-Regel ausgeschlossen, wenn Plattformprotokolle auf der festgelegten Route gesendet werden.

Einschlussfilter

Einschlussfilter definieren die Bedingungen, die verwendet werden, um zu bestimmen, welche Plattformprotokolle an die in der Regel angegebenen Ziele weitergeleitet werden.

Um alle Plattformprotokolle weiterzuleiten, schließen Sie die Definition inclusion_filters aus, wenn Sie eine Route konfigurieren.

Einschlussfilter bestehen aus einem operand, operator und value:

operand

Operand ist der Name der Eigenschaft im Ziel, die zum Filtern von Daten verwendet wird. Die folgenden Operanden werden unterstützt: location. Der Wert wird aus der Ziel-CRN extrahiert.

operator

Es werden zwei Operatoren unterstützt: in und is.

in

Der Wert der Operandeneigenschaft wird mit einer Liste von Werten verglichen.

Sie können bis zu 20 Werte definieren.

is

Der Wert der Operandeneigenschaft wird mit einem einzigen Wert verglichen.

Bei Verwendung von is kann nur 1 Wert angegeben werden.

value

Eine Zeichenfolge oder ein Array von Zeichenfolgen, die mit der Eigenschaft operand verglichen werden, um festzustellen, ob das Protokoll weitergeleitet wird oder nicht. Wenn is operator verwendet wird, muss value eine einzelne Zeichenfolge enthalten. Wenn in operator verwendet wird, kann value mehrere Zeichenketten in ein Array aufnehmen.

Gültige Werte hängen von der operand ab.

location: Jeder Ort, an dem IBM Cloud Logs Routing verfügbar ist.

Beachten Sie diese Einschränkungen bei der Konfiguration von Einschlussfiltern.

Sie können bis zu 7 Einschlussfilter für jede Regel konfigurieren.
Sie können bis zu 20 Werte für inclusion_filter.values konfigurieren.
Jeder für inclusion_filter.values konfigurierte Wert kann maximal 100 Zeichen lang sein.

IAM-Zugriff

Benutzer müssen über die entsprechenden IAM-Rollen verfügen, um mit Routing-Regeln arbeiten zu können. Informationen zu IAM-Rollen finden Sie unter Verwalten des IAM-Zugriffs.

Definition von Routing-Regeln mit Hilfe der Benutzeroberfläche

Sie können in der Benutzeroberfläche Routingregeln für Aktionen und Einschlussfilter konfigurieren. Weitere Informationen finden Sie unter Verwalten von Routen.

Definition von Routing-Regeln mit Hilfe der CLI

Regeln für Routen und Einschlussfilter werden im JSON-Format definiert. Regeln werden auf folgende Weise definiert:

Bei Verwendung der Option --rules werden die Informationen als JSON direkt an den Befehl übergeben.
Bei Verwendung der Option --files werden die Informationen als JSON-Datei übergeben.

Beispiel, das die Option --rules verwendet

Im folgenden Beispiel werden die Regeln direkt mit der Option --rules festgelegt. In diesem Beispiel werden alle Plattformprotokolle von us-east an 0b4e6aa9-257c-4a3a-ae42-9a36a5b3adc7 weitergeleitet. Alle Plattformprotokolle von eu-de und eu-es werden an 6f9137b3-2bb9-4724-851b-153e23c82d80 weitergeleitet.

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

Die Ausgabe des Befehls sieht wie folgt aus:

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

Beispiel, das die Option --file verwendet

Im folgenden Beispiel werden Regeln festgelegt, indem eine JSON-Datei mit dem Namen rules_def.json mit der Option --file übergeben wird:

--file rules_def.json

Die Datei rules_def.json enthält:

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

Definieren Sie Routing-Regeln mit Hilfe der API

Ziele und Einschlussfilter werden in API-Aufrufen unter Verwendung von rules definiert. Die rules sind in einer JSON-Struktur definiert.

Das folgende Beispiel erstellt eine Route mit dem Namen my-route und sendet Plattformprotokolle aus der Region us-east an die Ziele 0b4e6aa9-257c-4a3a-ae42-9a36a5b3adc7 und 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"]
          }
        ]
      }
    ]
  }'

Weitere Informationen finden Sie in der API-Referenz.