IBM Cloud Docs
Informationen zu Routen

Informationen zu Routen

Sie können Routen in Ihrem Konto verwalten, indem Sie die IBM Cloud Metrics Routing UI, die IBM Cloud Metrics Routing CLI, die IBM Cloud Metrics Routing REST API, und der IBM Cloud Metrics Routing Terraform Anbieter. Eine Route definiert die Regeln, die angeben, welche Metriken in einer Region weitergeleitet werden und wohin sie geleitet werden sollen.

Verstehen, wie Routen auf Ihrem Konto funktionieren

Beachten Sie die folgenden Informationen zu den Routen:

  • Routen sind unter einem Konto global und werden in allen Regionen ausgewertet, in denen IBM Cloud® Metrics Routing eingesetzt wird.

  • Sie können eine Route von einem beliebigen unterstützten Standort aus definieren, an dem IBM Cloud Metrics Routing verfügbar ist. Weitere Informationen finden Sie in Standorte.

  • Auf die Routen kann von jedem regionalen IBM Cloud Metrics Routing API-Endpunkt aus zugegriffen werden.

  • Für ein Konto können Sie bis zu 30 Routen definieren.

  • Das Konto hat standardmäßig 0 Routen konfiguriert.

  • Pro Route können Sie bis zu 10 Regeln konfigurieren.

  • Sie können bis zu acht Standorte für jede Regel konfigurieren.

  • Sie können für jede Regel bis zu drei Ziele ({"targets":[{"id":ID1},{"id":ID2},{"id":ID3}]) konfigurieren.

  • Routen werden unabhängig voneinander verarbeitet. Wenn Sie mehrere Routen mit Regeln haben, die mit denselben metrischen Daten übereinstimmen, werden diese Daten an mehrere Ziele gesendet.

  • Regeln in 1 Routendefinition werden in der Reihenfolge verarbeitet. Die erste übereinstimmende Regel (z. B. location), die mit Metrikdaten übereinstimmt, wird verwendet, um diese Daten zu verarbeiten. Wenn Metriken verarbeitet werden, werden sie nicht von einer nachfolgenden Regel in der Definition dieser Route verarbeitet. Wenn Sie eine Standardregel für alle Metriken angeben möchten, die nicht von anderen Regeln verarbeitet werden, würden Sie die Regel ("locations" : ["*"]) als letzte Regel in Ihrer rules Definition für die route angeben.

  • Wenn die Metrikdaten keiner Regel entsprechen und kein Standardziel konfiguriert ist, werden die Metriken verworfen und nicht an ein Ziel weitergeleitet.

  • Bei jeder Aktualisierung von mindestens einer Regel in einer Routendefinition wird der vorhandene Regelsatz gelöscht und durch die angegebene Konfiguration ersetzt. Wenn Sie eine Route aktualisieren, müssen Sie alle vorhandenen Regeln im Regelsatz definieren, die sich nicht ändern, und die Änderungen den Regeln hinzufügen, die aktualisiert werden müssen.

  • Informationen zu Routen werden als Metadaten an der primären Position gespeichert, die Sie für das Konto IBM Cloud festgelegt haben.

    Wenn Sie keine primäre Metadatenposition konfigurieren, wird die Position auf die Position gesetzt, an der Sie Ihr erstes Ziel im Account definieren. Weitere Informationen finden Sie unter Kontoeinstellungen konfigurieren.

  • 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 verwalten, indem Sie einen API-Endpunkt mit dem folgenden Format verwenden: https://private.REGION.metrics-router.cloud.ibm.com

    • Sie können Routen aus dem öffentlichen Netz verwalten, indem Sie einen API-Endpunkt mit dem folgenden Format verwenden: https://REGION.metrics-router.cloud.ibm.com

    • Sie können die öffentlichen Endpunkte inaktivieren, indem Sie die Kontoeinstellungen aktualisieren. Weitere Informationen finden Sie unter Private Endpunkte erzwingen.

  • Der Routenname darf höchstens 1000 Zeichen lang sein und darf keine anderen Sonderzeichen als Leerzeichen, Bindestrich -, Punkt ., Unterstrich _ und Doppelpunkt : enthalten.

    Der Name darf keine personenbezogenen Daten enthalten.

Nach der Konfiguration einer Route kann es bis zu eine Stunde dauern, bis die Konfiguration aktiviert wird.

IAM-Zugriff

Stellen Sie sicher, dass Sie über die richtigen IAM-Berechtigungen verfügen, um IBM Cloud Metrics Routingzu konfigurieren.

IAM-Berechtigungen

In der folgenden Tabelle sind die IAM-Aktionen mit ihrem Geltungsbereich und den Rollen aufgelistet, die für die Verwaltung von Routen erforderlich sind.

IAM-Aktionsbereiche und Rollen für die Verwaltung von Routen
Task IAM-Aktion Geltungsbereich der IAM-Richtlinie IAM-Rollen
Route erstellen metrics-router.route.create Konto Administrator
Editor
Alle Routen auflisten metrics-router.route.list Konto Administrator
Editor
Operator
Viewer
Details zu einer Route abrufen metrics-router.route.read Konto Administrator
Editor
Operator
Viewer
Route ändern metrics-router.route.update Konto Administrator
Editor
Route löschen metrics-router.route.delete Konto Administrator
Editor

Ereignisse prüfen

In der folgenden Tabelle sind die IAM-Aktionen mit ihrem Geltungsbereich und den Rollen aufgelistet, die für die Verwaltung von Routen erforderlich sind.

Aktivitätsnachverfolgung Auditing von Ereignissen
Task Aktivitätsverfolgung Auditing Ereignis Aktion
Route erstellen metrics-router.route.create
Alle Routen auflisten metrics-router.route.list
Details zu einer Route abrufen metrics-router.route.read
Route ändern metrics-router.route.update
Route löschen metrics-router.route.delete

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.

Verwaltung von Routen über die Benutzeroberfläche

Sie können Ihre Routendefinition mit der IBM Cloud Metrics Routing Benutzeroberfläche verwalten. Weitere Informationen finden Sie unter Verwaltung von Routen.

Befehle der Befehlszeilenschnittstelle

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

Routen-Aktionen
Aktion Befehl
Route erstellen ibmcloud metrics-router route create
Route aktualisieren ibmcloud metrics-router route update
Route löschen ibmcloud metrics-router route rm
Route lesen ibmcloud metrics-router route get
Alle Routen auflisten ibmcloud metrics-router route ls

Weitere Informationen finden Sie unter IBM Cloud Metrics Routing v3 CLI.

API-Voraussetzungen

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

  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.

API-Methoden

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

Routen Sie Aktionen mit Hilfe der IBM Cloud Metrics Routing REST-API
Aktion REST-API-Methode API_URL
Create a route POST <ENDPOINT>/api/v3/routes
Update a route PATCH <ENDPOINT>/api/v3/routes/<ROUTE_ID>
Delete a route DELETE <ENDPOINT>/api/v3/routes/<ROUTE_ID>
Get information about a route GET <ENDPOINT>/api/v3/routes/<ROUTE_ID>
List all routes GET <ENDPOINT>/api/v3/routes

Weitere Informationen zur REST-API finden Sie unter Routen.

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-Antwort weist normalerweise auf einen internen Systemfehler hin.

In der folgenden Tabelle finden Sie einige HTTP-Antwortcodes:

Liste der Antwortcodes HTTP
Statuscode Status Beschreibung
200 OK Die Anforderung war erfolgreich.
201 OK Die Anforderung war erfolgreich. Eine Ressource wird erstellt.
204 OK Die Route wurde erfolgreich gelöscht.
400 Ungültige Anforderung Die Anforderung war nicht erfolgreich. Möglicherweise fehlt ein Parameter, der erforderlich ist.
401 Nicht berechtigt Das IAM-Token, das in der API-Anforderung verwendet wird, ist ungültig oder abgelaufen.
403 Nicht zulässig Die Operation ist aufgrund unzureichender Berechtigungen nicht zulässig.
404 Nicht gefunden Die angeforderte Ressource ist nicht vorhanden oder wurde bereits gelöscht.
429 Zu viele Anforderungen Zu viele Anfragen erreichen die API zu schnell.
500 Interner Serverfehler In der IBM Cloud Metrics Routing Verarbeitung ist etwas schief gelaufen.