Lernen über IBM Cloud Logs Routing
Sie können den IBM Cloud Logs Routing-Dienst verwenden, um Plattformprotokolle, die von ausgewählten IBM Cloud-Dienstinstanzen erzeugt werden, an das von Ihnen gewählte Ziel weiterzuleiten (target).
Weitere Informationen finden Sie unter Über die Plattformprotokolle.
Um Plattformprotokolle zu konfigurieren, müssen Sie in Ihrem IBM Cloud-Konto Tenants und Ziele (Destinationen) konfigurieren.
Ein Tenant ist die kontospezifische Konfiguration von IBM Cloud Logs Routing innerhalb einer Region. Sie können bis zu 1 Zielort pro Mieter und Region definieren. Das Ziel definiert, wohin die Protokolle weitergeleitet werden.
Mieter
Beachten Sie bei der Verwaltung von Mietern die folgenden Informationen:
-
Sie müssen in Ihrem Konto in jeder Region, in der Sie IBM Cloud Logs Routing zum Sammeln und Weiterleiten von Plattformprotokollen verwenden möchten, einen Tenant erstellen.
Jede Region ist unabhängig.
Die Regionen tauschen keine Daten aus.
-
Wenn Sie einen Mieter anlegen, müssen Sie 1 Ziel definieren. Weitere Informationen finden Sie unter Erstellen eines Tenants.
-
Wenn Sie einen Mieter aktualisieren, können Sie nur den Namen des Mieters ändern.
-
Wenn Sie einen Mieter löschen, löschen Sie auch die Zieldefinitionen. Wenn Sie eine Zielinstanz löschen möchten, müssen Sie die Instanz separat löschen.
-
Sie können alle Mieter eines Kontos mit der API-Methode
GET /tenantsauflisten. -
Um Details zu einem Mieter zu erhalten, können Sie die API-Methode
GET /tenants/{tenant_id}verwenden und dabei die Mieter-ID angeben, die bei der Auflistung der Mieter in einem Konto zurückgegeben wird.
Sie können die konfigurierten Mieter und Zielorte auch über die Routing-Konfigurationsschnittstelle anzeigen.
Ziele
IBM Cloud Logs Routing unterstützt IBM Cloud Logs Instanzen Ziele.
Bei der Konfiguration eines Ziels für eine IBM Cloud Logs-Instanz werden nur öffentliche Ingress-Endpunkte unterstützt.
Weitere Informationen finden Sie unter Konfiguration des IBM Cloud Logs Routing Dienstes zur Weiterleitung von Plattformprotokollen an eine IBM Cloud Logs Instanz.
Die IBM Cloud Logs Routing Zielinstanz kann sich im selben Konto, einem anderen Konto und derselben oder einer anderen Region wie der IBM Cloud Logs Routing-Mieter befinden.
Beachten Sie bei der Verwaltung von Zielvorgaben die folgenden Informationen:
-
Sie können die Details der Zielkonfiguration aktualisieren, z. B. Zielhost, Zielport, Zielname, CRN der Zielinstanz und mehr.
-
Mit der API-Methode
GET /tenants/{tenant_id}/targetskönnen Sie alle Ziele in einem Mandanten auflisten. -
Um die Details über ein Ziel mit Hilfe der
GET /tenants/{tenant_id}/targets/{target_id}API-Methode zu erhalten.
Sie können die konfigurierten Mieter und Zielorte auch über die Routing-Konfigurationsschnittstelle anzeigen.
Die Autorisierung zwischen dem Dienst IBM Cloud Logs Routing und den Zielinstanzen erfolgt über IAM.
Verbindung zu IBM Cloud Logs Routing herstellen
{Der Bereich IBM® Cloud Logs Routing bietet API-Endpunkte für Verwaltungsfunktionen, wie z. B. die Erstellung oder Verwaltung einer Mandantenkonfiguration. Der Zugriff auf diese API-Endpunkte erfolgt über regionsspezifische URLs. Sie können die Endpunkte für jede unterstützte Region hier finden.
Sie können IBM Cloud Logs Routing mit Hilfe der Verwaltungs-API verwalten. Die Verwaltungs-API unterstützt entweder einen öffentlichen Endpunkt oder einen privaten Endpunkt. Ein öffentlicher Endpunkt kann über das Internet erreicht werden, während ein privater Endpunkt nur innerhalb des privaten Netzes IBM Cloud erreichbar ist.
Über die Benutzeroberfläche IBM Cloud Logs Routing können Sie einen Tenant in einer Region erstellen, indem Sie das öffentliche Netz verwenden.
Das IBM® Cloud Logs Routing unterstützt die folgenden Arten von Endpunkten für die private Verbindung zu IBM Cloud Logs Routing:
- IBM Cloud Cloud-Dienst-Endpunkt (CSE)
- Virtual Private Endpoint (VPE) for VPC.
Wenn Sie von einem IBM Cloud VPC aus eine Verbindung herstellen, können Sie entweder eine CSE oder VPE for VPC verwenden. Weitere Informationen finden Sie im Abschnitt zum Verwenden virtueller privater Endpunkte für VPC zum Herstellen einer privaten Verbindung zu IBM Cloud Logs Routing.
Wenn Sie eine Verbindung von einem System aus herstellen, das nicht in einem IBM Cloud VPC enthalten ist, besteht Ihre einzige Möglichkeit für einen privaten Endpunkt darin, eine Verbindung über eine CSE herzustellen. Die Verbindung zu IBM Cloud Logs Routing unter Verwendung einer CSE erfordert möglicherweise keine zusätzliche Arbeit Ihrerseits. Der Zugang zu den CSEs ist nur innerhalb des privaten Netzes IBM Cloud möglich. Weitere Informationen finden Sie im Abschnitt zur Verwendung von Serviceendpunkten zum Herstellen einer privaten Verbindung zu IBM Cloud Logs Routing.
Sie können nur über das öffentliche Netz auf die Benutzeroberfläche IBM Cloud Logs Routing zugreifen.
Sie können IBM Cloud Logs Routing mit Hilfe der Verwaltungs-API verwalten. Die Verwaltungs-API unterstützt entweder einen öffentlichen Endpunkt oder einen privaten Endpunkt. Ein öffentlicher Endpunkt kann über das Internet erreicht werden, während ein privater Endpunkt nur innerhalb des privaten Netzes IBM Cloud erreichbar ist.
- Um eine Konfiguration zu erstellen, zu aktualisieren oder zu löschen, können Sie die Verwaltungs-API IBM Cloud Logs Routing oder die Benutzeroberfläche IBM Cloud Logs Routing verwenden.
- Eine Liste der Verwaltungsendpunkte finden Sie unter Endpunkte.
Die Verwendung des öffentlichen Endpunkts erfordert keinen zusätzlichen Aufwand.