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 Ihrerrules
Definition für dieroute
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.
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.
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:
-
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:
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:
- Rufen Sie ein IAM-Zugriffstoken ab. Weitere Informationen finden Sie unter Abrufen von IAM-Zugriffstokens.
- 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:
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:
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. |