Was muss ich über die Einstellungen für IBM Cloud Logs Routing in IBM Cloud wissen?

Sie können IBM Cloud Logs Routing Kontoeinstellungen konfigurieren, um festzulegen, wo und wie Plattformprotokolle in Ihrem Konto gesammelt, weitergeleitet und verwaltet werden. Sie können dies über die Benutzeroberfläche oder über die CLI, die REST-API V3 oder Terraform-Skripte tun.

Beachten Sie bei der Konfiguration oder Änderung der Einstellungen Ihres IBM Cloud Logs Routing-Kontos die folgenden Informationen:

Jedes Mal, wenn Sie die Einstellungen Ihres IBM Cloud Logs Routing-Kontos ändern, ersetzen die in der neuen Anfrage übermittelten Daten alle vorhandenen Konfigurationsdaten. Sie müssen sicherstellen, dass vorhandene Daten nicht gelöscht werden, wenn Sie eine Aktualisierung der Kontoeinstellungen ausführen, indem Sie sie in die neue Anforderung einschließen.

Bevor Sie öffentliche Endpunkte durch Festlegen von --private-api-endpoint-only TRUE inaktivieren, stellen Sie sicher, dass Ihr Konto Zugriff auf den privaten Endpunkt hat. Sie können dies tun, indem Sie den Befehl ibmcloud account showausführen. Wenn VRF Enabled auf true gesetzt ist und Service Endpoint Enabled auf true gesetzt ist, haben Sie Zugriff auf den privaten Endpunkt. Wenn Sie keinen Zugriff auf den privaten Endpunkt haben, können Sie den öffentlichen Endpunkt nicht erneut aktivieren, da der private Endpoint-Zugriff erforderlich ist, um den öffentlichen Endpunkt erneut zu aktivieren.

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

  • Über das private Netzwerk müssen Sie einen API-Endpunkt mit folgendem Format verwenden: https://api.private.<region>.logs-router.cloud.ibm.com

  • Über das öffentliche Netz müssen Sie einen API-Endpunkt mit folgendem Format verwenden: https://api.<region>.logs-router.cloud.ibm.com

Welche Daten lassen sich über die Einstellungen in einem IBM Cloud Logs Routing-Konto konfigurieren?

Sie können die folgende Informationen definieren:

  • Der Speicherort in Ihrem IBM Cloud-Konto, an dem die Metadaten zur Konfiguration des IBM Cloud Logs Routing-Kontos gespeichert sind.

    Mit Metadaten sind die Daten für Ziele/Routen/Einstellungen gemeint, die im gesamten Konto in jeder beliebigen Region verfügbar sind.

    Sie können einen beliebigen der unterstützten Standorte wählen, an denen IBM Cloud Logs Routing verfügbar ist. Weitere Informationen finden Sie in Standorte.

    Sie können einen Ort wählen, an dem die Metadaten gespeichert werden. Sie können auch einen Sicherungsort konfigurieren, an dem die Metadaten für Wiederherstellungszwecke gespeichert werden.

    Berücksichtigen Sie alle Compliance-Anforderungen des Unternehmens oder der Branche, wie z. B. Standorte mit der Kennzeichnung "Financial Services Validated" oder von der EU verwaltete Regionen.

    Sie müssen die primäre Metadatenregion konfigurieren, bevor Sie Ziele und Routen erstellen, um sicherzustellen, dass die Konfiguration Ihren Compliance-Anforderungen entspricht.

  • Die Art von Endpunkten, die die Konfiguration des IBM Cloud Logs Routing-Kontos innerhalb des Kontos verwalten dürfen.

    Standardmäßig sind öffentliche und private Endpunkte aktiviert.

    Sie können Ihr Konto so konfigurieren, dass die Verwaltung nur über private Endpunkte möglich ist.

  • Die Orte, an denen ein Kontoadministrator Ziele für die Erfassung von Protokollen festlegen kann.

    Sie können einen beliebigen der unterstützten Standorte wählen, an denen IBM Cloud Logs Routing verfügbar ist. Weitere Informationen finden Sie in Standorte.

    Berücksichtigen Sie alle Compliance-Anforderungen des Unternehmens oder der Branche, wie z. B. Standorte mit der Kennzeichnung "Financial Services Validated" oder von der EU verwaltete Regionen.

  • Voreingestellte Zielorte, d. h. 1 oder mehrere Ziele im Konto, die Protokolle von unterstützten IBM Cloud Logs Routing Standorten sammeln, für die Sie nicht konfiguriert haben, wie Sie Protokolle sammeln möchten.

    Wenn Sie mehr als ein Ziel definieren, erhalten alle Standardziele eine Kopie der Protokolle, für die keine Routing-Regel vorliegt, die angibt, wohin sie innerhalb des Kontos übermittelt werden sollen. Sie können bis zu zwei Standardziele pro Konto definieren.

  • Die API-Version, die im Konto für IBM Cloud Logs Routing aktiviert ist. Gültige Werte sind: oder 1 3.

Welche IAM-Berechtigungen benötige ich, um die IBM Cloud Logs Routing-Einstellungen in einem IBM Cloud-Konto zu verwalten?

Stellen Sie sicher, dass Sie die die korrekten IAM-Berechtigungen für die Konfiguration der IBM Cloud Logs Routing Einstellungen.

Wie kann ich die Einstellungen für IBM Cloud Logs Routing über die Benutzeroberfläche von IBM Cloud verwalten?

Sie können Ihre Einstellungsdefinition über die Benutzeroberfläche IBM Cloud Logs Routing verwalten. Weitere Informationen finden Sie unter Konfigurieren von Kontoeinstellungen.

Welche CLI-Befehle kann ich verwenden, um die Einstellungen von IBM Cloud Logs Routing zu verwalten?

In der folgenden Tabelle sind die Aktionen aufgeführt, die zur Verwaltung von Einstellungen ausgeführt werden können:

Einstellungsaktionen mit Hilfe der IBM Cloud Logs Routing CLI
Aktion Befehl
Einstellungsinformationen abrufen ibmcloud logs-router setting get
Einstellungen aktualisieren ibmcloud logs-router setting update

Weitere Informationen finden Sie unter IBM Cloud Logs Routing-Befehlszeilenschnittstelle.

Welche API-Methoden kann ich verwenden, um die Einstellungen von IBM Cloud Logs Routing zu verwalten?

In der folgenden Tabelle sind die Aktionen aufgeführt, die zur Verwaltung von Einstellungen ausgeführt werden können:

Einstellungsaktionen mit Hilfe der IBM Cloud Logs Routing REST API
Aktion REST-API-Methode API_URL
Einstellungsinformationen abrufen GET <ENDPOINT>/v3/settings
Einstellungen aktualisieren PATCH <ENDPOINT>/v3/settings

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

  • Sie können Ziele aus dem privaten Netz mithilfe eines API-Endpunkts im folgenden Format verwalten: https://api.private.REGION.logs-router.cloud.ibm.com
  • Sie können Ziele über das öffentliche Netz mithilfe eines API-Endpunkts im folgenden Format verwalten: https://api.REGION.logs-router.cloud.ibm.com

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

Welche Antwortcodes von HTTP können bei der Verwendung der API-Einstellungsmethoden von IBM Cloud Logs Routing auftreten?

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.
  • 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.
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.
409 Konflikt Es besteht ein Konflikt mit den Anfragedaten und dem Zustand der Ressourcen im System.
429 Zu viele Anforderungen Zu viele Anforderungen haben die API zu schnell getroffen.
500 Interner Serverfehler Ein Fehler ist aufgetreten. Ihre Anforderung konnte nicht verarbeitet werden. Versuchen Sie es zu einem späteren Zeitpunkt erneut. Sollte das Problem weiterhin bestehen, notieren Sie sich die Transaktions-ID im Antwort-Header und wenden Sie sich an den IBM Cloud-Support.