Voraussetzungen

• Installieren Sie die IBM Cloud-Befehlszeilenschnittstelle.

• Installieren Sie die IBM Cloud Metrics Routing CLI.

• Sie müssen eine Benutzer-ID mit Berechtigungen zum Verwalten von IBM Cloud Metrics Routinghaben. Weitere Informationen zu IAM-Rollen und deren Zuweisung finden Sie unter Zugriff mit IAM verwalten und Zugriff auf IBM Cloud Metrics Routing.

• Wenn Sie IBM Cloud Metrics Routing für die Weiterleitung von Metriken an eine Monitoring-Instanz konfigurieren möchten, müssen Sie einen Service für die Serviceautorisierung konfigurieren. Sie müssen keine Berechtigungsnachweise für IBM Cloud Metrics Routingbereitstellen.

  Informationen zum Konfigurieren der Service-to-Service-Authentifizierung finden Sie unter Berechtigungen zum Erteilen des Zugriffs zwischen Services verwalten.

Schritt 1. Kontoeinstellungen konfigurieren

Legen Sie diese Kontoeinstellungen fest, um mithilfe von IBM Cloud Metrics Routingzu definieren, wo und wie Metriken erfasst, weitergeleitet und verwaltet werden.

Wenn Sie IBM Cloud Metrics Routing in Ihrem Konto konfigurieren, können Sie Kontoeinstellungen wie Metadatenpositionen, Typ der Endpunkte, die zur Verwaltung der Konfiguration berechtigt sind, Positionen, an denen Ziele definiert werden können, und Standardziele für die Erfassung von Metriken in Regionen konfigurieren, für die Sie nicht explizit konfiguriert haben, wie Metriken weitergeleitet werden sollen. Weitere Informationen finden Sie unter IBM Cloud Metrics Routing-Kontoeinstellungen konfigurieren.

Bevor Sie Ziele und Routen im Konto konfigurieren, müssen Sie die primäre Metadatenposition konfigurieren, die die Region definiert, in der alle IBM Cloud Metrics Routing-Ressourcendefinitionen gespeichert werden.

Führen Sie den folgenden Befehl aus, um den Speicherort der primären Metadaten zu konfigurieren:

ibmcloud metrics-router setting update --primary-metadata-region <REGION>

Dabei wird <REGION> auf eine unterstützte Region gesetzt, in der IBM Cloud Metrics Routing verfügbar ist. Weitere Informationen finden Sie in Standorte.

Bevor Sie den Speicherort für die Metadaten festlegen, prüfen Sie, ob die für den Datenspeicherort geltenden Compliance- oder Branchenvorschriften eingehalten werden.

Schritt 2. 1 Ziel konfigurieren

Ein Ziel definiert, wo Metriken erfasst werden. Weitere Informationen zu Zielen finden Sie unter Funktionsweise von Zielen in Ihrem Konto verstehen.

Wenn Sie ein Ziel konfigurieren, definieren Sie das Ziel, an das Sie Plattformmetriken senden möchten, die in einer Region in Ihrem Konto erfasst werden.

Führen Sie die folgenden Schritte aus, um ein Ziel zu konfigurieren:

1. Definieren Sie ein Ziel, an das Metriken weitergeleitet werden sollen.

   ibmcloud metrics-router target create --name TARGET_NAME --destination-crn DESTINATION_TARGET_CRN [--region REGION]
   

   Wo

   --name

   Legt den Namen fest, der dem Ziel gegeben werden soll.

   --destination-crn

   Definiert den CRN der IBM Cloud Monitoring-Instanz, an die Sie die Metriken weiterleiten möchten. IBM Cloud Monitoring-Ziele werden nur unterstützt.

   --region

   [Optional] Definiert die Region, in der die Zieldefinition erstellt wird Sie können nur eine unterstützte Region angeben. Legen Sie diese Option fest, wenn Sie ein Ziel in einer Region erstellen möchten und Sie mit einem anderen Ziel verbunden sind.

2. Definieren Sie einen Service zur Serviceautorisierung zwischen dem Service IBM Cloud Metrics Routing und der IBM Cloud Monitoring-Instanz, die Sie als Ziel im Ziel konfiguriert haben. Weitere Informationen finden Sie unter Berechtigungen zum Erteilen von Zugriff zwischen Services verwalten.

Schritt 3. 1 Route konfigurieren

Eine Route definiert die Regeln, die angeben, welche Metriken in einer Region weitergeleitet werden und wo sie gespeichert werden sollen. Routen sind unter einem Konto global und werden in allen Regionen ausgewertet, in denen IBM Cloud Metrics Routing eingesetzt wird. Weitere Informationen finden Sie unter Funktionsweise von Routen in Ihrem Account verstehen.

In diesem Schritt konfigurieren Sie eine Route, um Metriken an das Ziel umzuleiten, das Sie im vorherigen Schritt konfiguriert haben.

Führen Sie den folgenden Befehl aus, um die Route zu erstellen:

ibmcloud metrics-router route create --name ROUTE_NAME  --rules RULES

Wo

--name ROUTE_NAME

Legt den Namen fest, der der Route gegeben werden soll.

--rules RULES

Definiert eine JSON-formatierte Regeldefinition, die in einfachen Anführungszeichen steht. Weitere Informationen.

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

Um beispielsweise eine Route zu erstellen, die in us-east generierte Metriken an das im vorherigen Schritt erstellte Ziel sendet, führen Sie den folgenden Befehl aus.

ibmcloud metrics-router route create --name "my-route" --rules '[{"action": "send", "targets":[{"id":"TARGETID"}], "inclusion_filters":[{"operand": "location","operator": "is","values": "us-east"}]}]''

Dabei ist " TARGETID die ID des Ziels, das Sie im vorherigen Schritt erstellt haben.

Schritt 4. Erfassung von Metriken überprüfen

Nachdem das Ziel und die Route konfiguriert wurden, müssen Sie überprüfen, ob Metriken verfügbar sind.

Starten Sie die IBM Cloud Monitoring-Benutzerschnittstelle für die Monitoring-Instanz, die Sie als Ziel konfiguriert haben, und untersuchen Sie die Metriken.