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 Logs Routing eingesetzt wird.

• Auf die Routen kann von jedem regionalen IBM Cloud Logs 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 Plattformprotokolldaten übereinstimmen, werden diese Daten an mehrere Ziele gesendet.

• Regeln in einer einzelnen Routendefinition werden der Reihe nach abgearbeitet. Die erste übereinstimmende Regel (z. B. location), die mit Plattformprotokolldaten übereinstimmt, wird zur Verarbeitung dieser Daten verwendet. Wenn Plattformprotokolle verarbeitet werden, werden sie nicht von einer nachfolgenden Regel innerhalb der Definition dieser Route verarbeitet.

• Regeln werden mit einem Plattformprotokoll übereinstimmen, wenn der Speicherort des Plattformprotokolls innerhalb eines Regelspeichers liegt. Zum Beispiel passt die Regel eu-de zu Plattformprotokollpositionen: eu-de, eu-de-1, eu-de-2, und eu-de-3. Oder die Regel Standort jp passt zu allen Plattformprotokollen in Japan. Führen Sie ibmcloud catalog locations aus, um die Hierarchien der Cloud-Standorte zu sehen.

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

• Jede Aktualisierung einer oder mehrerer Regeln in einer Routendefinition verwirft den bestehenden Regelsatz und ersetzt ihn durch die angegebene Konfiguration. Wenn Sie eine Route aktualisieren, müssen Sie alle bestehenden Regeln im Regelsatz definieren, die sich nicht ändern, und die Änderungen zu den Regeln hinzufügen, die aktualisiert werden müssen.

• Informationen über Routen werden als Metadaten an dem primären Speicherort gespeichert, den Sie für das Konto IBM Cloud festgelegt haben.

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

  • Sie können Routen aus dem öffentlichen Netz verwalten, indem Sie einen API-Endpunkt mit dem folgenden Format verwenden: 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 Erzwingen von privaten Endpunkten.

• 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 persönlichen Informationen zur Identifizierung (PII) 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 die die richtigen IAM-Berechtigungen zur Konfiguration von IBM Cloud Logs Routing.

IAM-Berechtigungen

In der folgenden Tabelle sind die IAM-Aktionen, ihr Umfang und die für die Verwaltung von Routen erforderlichen Rollen aufgeführt.

Ereignisse prüfen

In der folgenden Tabelle sind die IAM-Aktionen, ihr Umfang und die für die Verwaltung von Routen erforderlichen Rollen aufgeführt.