Route über die Benutzerschnittstelle erstellen

Gehen Sie wie folgt vor, 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 Überwachung.

4. Klicken Sie auf Routing.

5. Klicken Sie auf die Registerkarte " Routen".

6. Klicken Sie auf Erstellen, um die Seite zum Erstellen einer Route zu öffnen.

7. Geben Sie einen aussagekräftigen Namen für die Route ein.

8. Klicken Sie auf Weiter.

9. In Routing rules ändern Sie die Action für Rule 1:

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

   • Wählen Sie Drop für die Regel, um Metriken, die dieser Regel entsprechen, fallen zu lassen.

10. Fügen Sie die Einschlussfilter hinzu, um die Metriken zu bestimmen, die 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.

11. Fügen Sie das Ziel hinzu, 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.

12. 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.

13. Nachdem Sie Ihre Route festgelegt haben, klicken Sie auf Weiter.

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

15. Klicken Sie auf Erstellen.

Aktualisieren einer Route über die Benutzeroberfläche

Gehen Sie wie folgt vor, 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 Überwachung.

4. Klicken Sie auf Routing.

5. Klicken Sie auf die Registerkarte " Routen".

6. Bestimmen Sie die zu aktualisierende Route und klicken Sie auf das Symbol .

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

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

9. Ändern Sie unter Routing rules die Action für die Regel:

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

   • Wählen Sie Drop für die Regel, um Metriken, die dieser Regel entsprechen, fallen zu lassen.

10. Fügen Sie die Einschlussfilter hinzu oder ändern Sie sie, um die Metriken zu bestimmen, die 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.

11. Ä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.

12. 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.

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

Anzeigen einer Route über die Benutzeroberfläche

Gehen Sie wie folgt vor, 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 Überwachung.

4. Klicken Sie auf Routing.

5. Klicken Sie auf die Registerkarte " Routen".

   Die konfigurierten Routen werden aufgelistet. 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.

   Die Seite Routen zeigt auch Routing-Anleitung mit zusätzlichen Informationen zur Konfiguration des Routings.

Route über die Benutzerschnittstelle löschen

Gehen Sie wie folgt vor, 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 Überwachung.

4. Klicken Sie auf Routing.

5. Klicken Sie auf die Registerkarte " Routen".

6. Bestimmen Sie die zu löschende Route und klicken Sie auf das Symbol .

7. 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 Befehlszeilenschnittstelle 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 Metrics 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.

Routennamen sind im Konto eindeutig.

ibmcloud metrics-router route create --name ROUTE_NAME ( --rules RULES |  --file RULES_DEFINITION_JSON_FILE ) [--output FORMAT] [--force]

ibmcloud mr route create --name target1 --rules '[{"action": "send", "targets":[{"id":"551957a7-c1e3-4160-84d8-4268709f6743"}]}]'
OK
Route
Name:         target1
ID:           06a29ca2-40f5-4371-ae3c-76a896577bd3
CRN:          crn:v1:bluemix:public:metrics-router:global:a/xxxx::route:06a29ca2-40f5-4371-ae3c-76a896577bd3
Rule 0:       [[551957a7-c1e3-4160-84d8-4268709f6743(mon-std)], []]
Created At:   2023-05-30T21:14:21.460Z
Updated At:   2023-05-30T21:14:21.460Z

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 metrics-router route update --route ROUTE [--name ROUTE_NAME] ( --rules RULES |  --file RULES_DEFINITION_JSON_FILE ) [--output FORMAT] [--force]

ibmcloud mr route update --route target1 --name target2
OK
Route
Name:         target2
ID:           06a29ca2-40f5-4371-ae3c-76a896577bd3
CRN:          crn:v1:bluemix:public:metrics-router:global:a/xxxx::route:06a29ca2-40f5-4371-ae3c-76a896577bd3
Rule 0:       [[551957a7-c1e3-4160-84d8-4268709f6743(mon-std)], []]
Created At:   2023-05-30T21:14:21.460Z
Updated At:   2023-05-30T21:19:40.953Z

Route wird über die Befehlszeilenschnittstelle gelöscht

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

ibmcloud metrics-router ROUTE rm --route route [--force]

Are you sure you want to remove the route with route ID xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx? [y/N]>y
OK
Route with name xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx was successfully removed.

Abrufen von Informationen über eine Route mit der CLI

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

ibmcloud metrics-router ROUTE get --route route [--output FORMAT]

ibmcloud mr route get --route route-all
OK
Route
Name:         route-all
ID:           f22e9cb6-2fcd-456d-9cf2-27813b1cc375
CRN:          crn:v1:bluemix:public:metrics-router:global:a/xxxx::route:f22e9cb6-2fcd-456d-9cf2-27813b1cc375
Rule 0:       [[551957a7-c1e3-4160-84d8-4268709f6743(mon-std)], []]
Created At:   2023-05-30T08:04:53.183Z
Updated At:   2023-05-30T08:53:22.824Z

Alle Routen in einer Region auflisten

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

ibmcloud metrics-router route ls [--output FORMAT]

ibmcloud mr route ls
OK
Routes
Name:         route-all
ID:           f22e9cb6-2fcd-456d-9cf2-27813b1cc375
CRN:          crn:v1:bluemix:public:metrics-router:global:a/xxxx::route:f22e9cb6-2fcd-456d-9cf2-27813b1cc375
Rule 0:       [[551957a7-c1e3-4160-84d8-4268709f6743(mon-std)], []]
Created At:   2023-05-30T08:04:53.183Z
Updated At:   2023-05-30T08:53:22.824Z

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://private.REGION.metrics-router.cloud.ibm.com

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

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

Weitere Informationen zur 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:

Routennamen sind im Konto eindeutig. Sie können einen Routennamen nicht wiederverwenden, um mehrere Ziele zu konfigurieren.

curl -X POST <ENDPOINT>/api/v3/routes -H "Authorization: $ACCESS_TOKEN" -H "content-type: application/json" -d '{
    -d '{
    "name": "ROUTE_NAME",
    "rules": [
      RULES
    ]
  }'

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.

Schließen Sie keine personenbezogenen Daten in Ressourcennamen ein.

RULES

Array-Definition für JSON-formatierte Regeln in einfachen Anführungszeichen, die definieren, wie Metriken weitergeleitet werden Weitere Informationen finden Sie unter Routing-Regeln definieren.

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

curl -X POST https://private.us-south.metrics-router.cloud.ibm.com/api/v3/routes -H "Authorization: $ACCESS_TOKEN" -H "content-type: application/json" -d '{
    "name": "My-route",
    "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"]
          },
          {
            "operand": "service_name",
            "operator": "in",
            "values": ["codeengine","container-registry"]
          }
        ]
      }
    ]
  }'

Route über die API aktualisieren

Sie können den Namen einer Route und 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.

Routennamen sind im Konto eindeutig. Sie können einen Routennamen nicht wiederverwenden, um mehrere Ziele zu konfigurieren.

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

curl -X PATCH <ENDPOINT>/api/v3/routes/ROUTE_ID -H "Authorization: $ACCESS_TOKEN" -H "content-type: application/json" -d '{
    "name": "ROUTE_NAME",
    "rules": [
      RULES
    ]
  }'

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

Name der Route. Der Name hat eine maximal zulässige Länge von 256 Zeichen.

Schließen Sie keine personenbezogenen Daten in Ressourcennamen ein.

RULES

Array-Definition für JSON-formatierte Regeln in einfachen Anführungszeichen, die definieren, wie Metriken weitergeleitet werden Weitere Informationen finden Sie unter Routing-Regeln definieren.

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

curl -X PATCH https://private.us-south.metrics-router.cloud.ibm.com/api/v3/routes -H "Authorization: $ACCESS_TOKEN" -H "content-type: application/json" -d '{
    "name": "My route",
    "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"]
          },
          {
            "operand": "service_name",
            "operator": "in",
            "values": ["codeengine","container-registry"]
          }
        ]
      }
    ]
    }
  }'

Route über die API löschen

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

curl -X DELETE <ENDPOINT>/api/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 verwenden, um eine Route mit der ID " 00000000-0000-0000-0000-000000000000 zu löschen:

curl -X DELETE https://private.us-south.metrics-router.cloud.ibm.com/api/v3/routes/00000000-0000-0000-0000-000000000000 -H "Authorization: $ACCESS_TOKEN" -H "content-type: application/json"

Route über die API anzeigen

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

curl -X GET <ENDPOINT>/api/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://private.us-south.metrics-router.cloud.ibm.com/api/v3/routes/00000000-0000-0000-0000-000000000000 -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>/api/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 zum Beispiel die folgende cURL ausführen, um Informationen über die in Dallas definierten Routen zu erhalten:

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

HTTP-Antwortcodes

Wenn Sie die IBM Cloud Metrics 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.
• Eine 5xx weist auf einen internen Systemfehler hin.

In der folgenden Tabelle finden Sie einige HTTP-Antwortcodes: