Route über die Benutzerschnittstelle erstellen

Führen Sie die folgenden Schritte aus, um eine Route über die Benutzeroberfläche zu erstellen.

1. Melden Sie sich bei Ihrem IBM Cloud Konto an.

2. Klicken Sie auf das Menüsymbol > Beobachtbarkeit.

3. Klicken Sie auf Protokollierung > Routing.

4. Klicken Sie auf der Registerkarte " Routen" auf Erstellen.

5. Ändern Sie im Abschnitt Routingregeln die Aktion für Regel 1:

   Wählen Sie eine Aktion für Regel 1:

   • Wählen Sie Protokolle senden von für die Regel, um Plattformprotokolle an die zugehörigen Ziele weiterzuleiten.

   • Wählen Sie Protokolle verwerfen von für die Regel, um Plattformprotokolle zu verwerfen, die dieser Regel entsprechen.

   Fügen Sie die Einschlussfilter hinzu, um die Plattformprotokolle zu bestimmen, die an die in der Regel angegebenen Ziele weitergeleitet werden.

   • Wählen Sie eine Bedingung aus, und geben Sie die Ortswerte an, auf die der Einschlussfilter zutreffen soll.

   • Um mehrere Einschlussfilter hinzuzufügen, klicken Sie auf Filter hinzufügen, um weitere Filter hinzuzufügen.

   Fügen Sie die Ziele hinzu, die mit der Regel verknüpft werden sollen, indem Sie ein Ziel aus der Liste auswählen. Wenn Sie noch kein Ziel definiert haben, klicken Sie auf Ziel hinzufügen, um ein neues Ziel zu erstellen.

6. Klicken Sie auf Regel hinzufügen, um der Route weitere Regeln hinzuzufügen.

   Die Reihenfolge der Routenregeln beeinflusst das Routingverhalten. Die Regeln werden der Reihe nach abgearbeitet. Sobald eine Regel erfüllt ist, werden die nachfolgenden Regeln nicht mehr abgearbeitet.

   Die Reihenfolge der Routing-Regeln kann durch Klicken auf die Auf- und Abwärtspfeile rechts neben jeder Regeldefinition geändert werden.

   Wenn Sie eine Regel oder einen Filter entfernen möchten, klicken Sie auf das Symbol Entfernen, das mit der Regel oder dem Filter verbunden ist.

   Sie können bis zu 10 Regeln pro Route konfigurieren.

7. Klicken Sie auf Weiter.

8. Geben Sie einen Namen für die Route ein.

9. Überprüfen Sie die Streckendefinition, um sicherzustellen, dass die Reihenfolge der Regeln wie vorgesehen ist.

   Weitere Informationen finden Sie unter Routing-Priorität verstehen.

10. Klicken Sie auf Erstellen.

Aktualisieren einer Route über die Benutzeroberfläche

Führen Sie die folgenden Schritte aus, um eine Route über die Benutzeroberfläche zu aktualisieren.

1. Melden Sie sich bei Ihrem IBM Cloud Konto an.

2. Klicken Sie auf das Menüsymbol > Beobachtbarkeit.

3. Klicken Sie auf Protokollierung > Routing.

4. Bestimmen Sie auf der Registerkarte Routen, welche Route aktualisiert werden soll, und klicken Sie auf das Aktionen.

5. Klicken Sie auf Umbenennen, um die Route umzubenennen.

6. Klicken Sie auf Bearbeiten, um die Routenregeln zu aktualisieren.

   Ändern Sie unter Routing-Regeln die Aktion für die Regel:

   • Wählen Sie Send für die Regel, um Plattformprotokolle an die zugehörigen Ziele weiterzuleiten.

   • Wählen Sie Drop für die Regel, um Plattformprotokolle zu löschen, die dieser Regel entsprechen.

   Fügen Sie die Einschlussfilter hinzu oder ändern Sie sie, um zu bestimmen, welche Plattformprotokolle an die in der Regel angegebenen Ziele weitergeleitet werden.

   Wählen Sie den gewünschten Filter und die Bedingung aus und geben Sie den Wert an, auf den der Einschlussfilter zutreffen soll.

   Um mehrere Einschlussfilter hinzuzufügen, klicken Sie auf Filter hinzufügen, um weitere Filter hinzuzufügen.

7. Ändern Sie das Ziel, das mit der Regel verknüpft werden soll, indem Sie ein Ziel aus der Liste auswählen. Wenn Sie noch kein Ziel definiert haben, klicken Sie auf Ziel hinzufügen, um ein neues Ziel zu erstellen.

8. Klicken Sie auf Regel hinzufügen, um der Route weitere Regeln hinzuzufügen.

   Die Reihenfolge der Routenregeln beeinflusst das Routingverhalten. Die Regeln werden der Reihe nach abgearbeitet. Sobald eine Regel erfüllt ist, werden die nachfolgenden Regeln nicht mehr abgearbeitet.

   Die Reihenfolge der Routing-Regeln kann durch Klicken auf die Auf- und Abwärtspfeile rechts neben jeder Regeldefinition geändert werden.

   Wenn Sie eine Regel oder einen Filter entfernen möchten, klicken Sie auf das Symbol Entfernen, das mit der Regel oder dem Filter verbunden ist.

   Sie können bis zu 10 Regeln pro Route konfigurieren.

9. Klicken Sie auf Aktualisieren, um Änderungen an Ihrer Route vorzunehmen.

Anzeigen einer Route über die Benutzeroberfläche

Führen Sie die folgenden Schritte aus, um eine Route über die Benutzeroberfläche anzuzeigen.

1. Melden Sie sich bei Ihrem IBM Cloud Konto an.

2. Klicken Sie auf das Menüsymbol > Beobachtbarkeit.

3. Klicken Sie auf Protokollierung > Routing.

4. Auf der Registerkarte Routen sehen Sie die Liste der konfigurierten Routen.

   Die Reihenfolge der Routen hat keinen Einfluss auf das Routingverhalten, da sie unabhängig voneinander verarbeitet werden.

   Für jede Route werden der Routenname und die Regeln angezeigt.

   Auf der Seite "Routen" wird auch eine Routing-Anleitung mit zusätzlichen Informationen zur Konfiguration des Routings angezeigt.

Route über die Benutzerschnittstelle löschen

Führen Sie die folgenden Schritte aus, um eine Route über die Benutzeroberfläche zu löschen.

1. Melden Sie sich bei Ihrem IBM Cloud Konto an.

2. Klicken Sie auf das Menüsymbol > Beobachtbarkeit.

3. Klicken Sie auf Protokollierung > Routing.

4. Bestimmen Sie auf der Registerkarte Routen die zu löschende Route und klicken Sie auf das Aktionen.

5. Klicken Sie auf Löschen, um die gesamte Route zu löschen. Sie müssen den Routennamen eingeben, bevor die Route gelöscht wird.

CLI-Voraussetzungen

Bevor Sie die CLI zur Verwaltung von Routen verwenden, führen Sie die folgenden Schritte aus:

1. Installieren Sie die IBM Cloud-Befehlszeilenschnittstelle.

2. Installieren Sie die IBM Cloud Logs Routing CLI.

3. Melden Sie sich bei IBM Cloud an. Führen Sie den folgenden Befehl aus: ibmcloud login

Route über die Befehlszeilenschnittstelle (CLI) erstellen

Verwenden Sie diesen Befehl, um eine Route zu erstellen.

Die Routennamen sind im Konto eindeutig.

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

Route über die Befehlszeilenschnittstelle aktualisieren

Verwenden Sie diesen Befehl, um eine Route zu aktualisieren. Jeder angegebene Wert, der sich von dem Zeitpunkt, zu dem die Route ursprünglich erstellt wurde, unterscheidet, wird auf den im Befehl angegebenen Wert aktualisiert.

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

Route wird über die Befehlszeilenschnittstelle gelöscht

Verwenden Sie diesen Befehl, um eine Route zu löschen.

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

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

Abrufen von Informationen über eine Route mit der CLI

Verwenden Sie diesen Befehl, um Informationen zu einer Route für eine IBM Cloud Logs Routing-Region abzurufen.

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

Alle Routen in einer Region auflisten

Verwenden Sie diesen Befehl, um die konfigurierten Routen für eine Region IBM Cloud Logs Routing aufzulisten.

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

API-Routen und -Aktionen

In der folgenden Tabelle werden die Aktionen aufgelistet, die zum Verwalten von Routen ausgeführt werden können:

Sie können private und öffentliche Endpunkte verwenden, um Routen zu verwalten. Weitere Informationen zu der Liste der verfügbaren ENDPOINTS finden Sie unter Endpunkte.

• Sie können Routen aus dem privaten Netz über einen API-Endpunkt mit folgendem Format verwalten: https://api.private.REGION.logs-router.cloud.ibm.com
• Sie können Routen aus dem öffentlichen Netz über einen API-Endpunkt mit folgendem Format verwalten: https://api.REGION.logs-router.cloud.ibm.com

Sie können die öffentlichen Endpunkte inaktivieren, indem Sie die Kontoeinstellungen aktualisieren. Weitere Informationen finden Sie unter Konfigurieren von Routen- und Regionseinstellungen.

Weitere Informationen über die REST-API finden Sie unter Routen.

API-Voraussetzungen

Führen Sie die folgenden Schritte aus, um API-Aufrufe zum Verwalten von Routen zu erstellen:

1. Rufen Sie ein IAM-Zugriffstoken ab. Weitere Informationen finden Sie unter Abrufen von IAM-Zugriffstokens.
2. Geben Sie den API-Endpunkt in der Region an, in der Sie eine Route konfigurieren oder verwalten wollen. Weitere Informationen finden Sie unter Endpunkte.

Route über die API erstellen

Sie können den folgenden cURL-Befehl verwenden, um eine Route zu erstellen:

Die Routennamen sind im Konto eindeutig. Sie können einen Routennamen nicht für die Konfiguration mehrerer Ziele wiederverwenden.

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

Wo

<ENDPOINT>

API-Endpunkt in der Region, in der Sie eine Route konfigurieren oder verwalten möchten. Weitere Informationen finden Sie unter Endpunkte.

ROUTE_NAME

Der Name, der für die Route angegeben werden soll.

Der Name, der für die Route angegeben werden soll.

Die maximale Länge beträgt 1000 Zeichen.

Die Mindestlänge beträgt 1 Zeichen.

Der Name darf keine anderen Sonderzeichen als Leerzeichen, -, ., _, : enthalten.

Schließen Sie keine personenbezogenen Daten in Ressourcennamen ein.

RULES

JSON-String oder ein Pfad zu einem JSON-Dateipräfix mit @, der definiert, wie Plattformprotokolle weitergeleitet werden.

Die Regeln werden in der Reihenfolge ausgewertet, in der sie konfiguriert sind.

Die maximale Länge beträgt 10 Regeln.

Weitere Informationen finden Sie unter Definieren von Routing-Regeln.

Sie können zum Beispiel die folgende cURL Anfrage verwenden, um eine Route zu erstellen:

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

Die Ausgabe sieht wie folgt aus:

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

Route über die API aktualisieren

Sie können den Namen einer Route und die Regeln ändern. Jeder angegebene Wert, der sich von dem unterscheidet, der bei der ursprünglichen Erstellung der Route angegeben wurde, wird auf den in der Anfrage angegebenen Wert aktualisiert.

Wenn Sie eine Route aktualisieren, müssen Sie die Routeninformationen in den Datenabschnitt der Anforderung einschließen.

• Sie müssen alle Felder übergeben.
• Aktualisieren Sie die Felder, die geändert werden müssen.

Die Routennamen sind im Konto eindeutig. Sie können einen Routennamen nicht für die Konfiguration mehrerer Ziele wiederverwenden.

Sie können den folgenden cURL-Befehl verwenden, um eine Route zu aktualisieren:

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

Wo

<ENDPOINT>

API-Endpunkt in der Region, in der Sie eine Route konfigurieren oder verwalten möchten. Weitere Informationen finden Sie unter Endpunkte.

ROUTE_ID

Die ID der Route.

ROUTE_NAME

Der Name, der für die Route angegeben werden soll.

Der Name, der für die Route angegeben werden soll.

Die maximale Länge beträgt 1000 Zeichen.

Die Mindestlänge beträgt 1 Zeichen.

Der Name darf keine anderen Sonderzeichen als Leerzeichen, -, ., _, : enthalten.

Schließen Sie keine personenbezogenen Daten in Ressourcennamen ein.

RULES

JSON-String oder ein Pfad zu einem JSON-Dateipräfix mit @, der definiert, wie Plattformprotokolle weitergeleitet werden.

Die Regeln werden in der Reihenfolge ausgewertet, in der sie konfiguriert sind.

Die maximale Länge beträgt 10 Regeln.

Weitere Informationen finden Sie unter Definieren von Routing-Regeln.

Sie können zum Beispiel die folgende cURL Anfrage verwenden, um eine Route in Dallas zu erstellen:

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

Route über die API löschen

Mit dem folgenden cURL-Befehl können Sie eine Route löschen:

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

Wo

<ENDPOINT>

API-Endpunkt in der Region, in der Sie eine Route konfigurieren oder verwalten möchten. Weitere Informationen finden Sie unter Endpunkte.

<route_ID>

Die ID der Route.

Sie können zum Beispiel die folgende cURL Anfrage verwenden, um eine Route mit der ID c7673f63-1260-4f86-bc1a-aaedb89391d8 zu löschen:

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"

Route über die API anzeigen

Sie können den folgenden cURL Befehl verwenden, um die Konfigurationsdetails von 1 Route anzuzeigen:

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

Wo

<ENDPOINT>

API-Endpunkt in der Region, in der Sie eine Route konfigurieren oder verwalten möchten. Weitere Informationen finden Sie unter Endpunkte.

<route_ID>

Die ID der Route.

Sie können beispielsweise die folgende cURL-Anforderung ausführen, um Informationen zu einer Route mit der ID 00000000-0000-0000-0000-000000000000 abzurufen:

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"

Auflistung aller Routen, die die API verwenden

Sie können den folgenden cURL-Befehl verwenden, um alle Routen anzuzeigen:

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

Wo

• <ENDPOINT> ist der API-Endpunkt in der Region, in der Sie eine Route konfigurieren oder verwalten wollen. Weitere Informationen finden Sie unter Endpunkte.

Sie können z. B. die folgende Anfrage cURL ausführen, um Informationen über die in Dallas definierten Routen zu erhalten:

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

HTTP-Antwortcodes

Wenn Sie die IBM Cloud Logs Routing REST-API verwenden, können Sie Standard-HTTP-Antwortcodes abrufen, um anzugeben, ob eine Methode erfolgreich abgeschlossen wurde.

• Eine Antwort von 200 zeigt immer Erfolg an.
• Eine 4xx-Antwort weist auf einen Fehler hin.
• Die Antwort 5xx weist auf einen internen Systemfehler hin.

In der folgenden Tabelle finden Sie einige HTTP-Antwortcodes: