Informationen zu Zielen

Sie können Monitoring Ziele 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, den IBM Cloud Metrics Routing Terraform Provider und die Terraform IBM Module(TIM)für IBM Cloud Metrics Routing verwenden. Ein Ziel ist eine Ressource, in der Sie Metriken sammeln können. Die Ressource kann sich in demselben IBM Cloud Konto befinden, in dem die Metriken generiert werden, oder in einem anderen Konto.

Funktionsweise von Zielen in Ihrem Konto verstehen

Beachten Sie die folgenden Informationen zu Zielen:

Ziele sind unter einem Konto regional und können von jedem regionalen IBM Cloud Metrics Routing-API-Endpunkt aus aufgerufen werden.
Sie können ein Ziel an einer beliebigen unterstützten Position definieren, an der IBM Cloud Metrics Routing verfügbar ist. Weitere Informationen finden Sie in Standorte.
Sie können bis zu 16 Ziele in jedem Konto konfigurieren.
Sie können bis zu zwei Standardziele für jedes IBM Cloud-Konto konfigurieren.

Standardziele erfassen Metriken von Positionen, an denen Sie im Konto nicht angeben, wohin die an dieser Position generierten Metriken weitergeleitet werden.
Informationen zu Zielen werden als Metadaten in den primären und Backup-Positionen gespeichert, die Sie für das Konto IBM Cloud festgelegt haben. Die gespeicherten Informationen umfassen Details zur Zielressource und Berechtigungsnachweise zum Senden von Metriken.

Der primäre Metadatenspeicherort muss vor der Konfiguration eines Ziels festgelegt werden.

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 Ziele zu verwalten. Weitere Informationen über die Liste der verfügbaren Endpunkte finden Sie unter Endpunkte.
- Sie können Ziele vom privaten Netzwerk aus verwalten, indem Sie einen API-Endpunkt mit dem folgenden Format verwenden: https://private.REGION.metrics-router.cloud.ibm.com
- Sie können Ziele 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 Zielname 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.

Zieltypen

Sie können jeden der folgenden Zieltypen konfigurieren:

Liste der Ziele
Ziel	Typ	Bereich	Beschreibung
IBM Cloud Monitoring	`sysdig-monitor`	`Account`	Mit diesem Ziel können Sie Zeitreihendaten in der Region Ihrer primären Operationen konsolidieren.

IAM-Zugriff

Zur Verwaltung von Zielen müssen Sie sicherstellen, dass Sie über die richtigen IAM-Berechtigungen zum Konfigurieren von IBM Cloud Metrics Routing verfügen.

Damit der Service IBM Cloud Metrics Routing Metriken an Ihre Monitoring-Ziele senden kann, muss ein Service für die Serviceautorisierung in dem Konto konfiguriert sein, in dem sich das Ziel befindet. Weitere Informationen finden Sie unter Berechtigungen zum Erteilen von Zugriff zwischen Services verwalten.

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.

IAM-Aktionsbereiche und Rollen für die Verwaltung von Zielen
Task	IAM-Aktion	Geltungsbereich der IAM-Richtlinie	IAM-Rollen
Ziel erstellen	`metrics-router.target.create`	Bereich	`Administrator` `Editor`
Alle Ziele auflisten	`metrics-router.target.list`	Konto	`Administrator` `Editor` `Operator` `Viewer`
Details zu einem Ziel abrufen	`metrics-router.target.read`	Bereich	`Administrator` `Editor` `Operator` `Viewer`
Ziel ändern	`metrics-router.target.update`	Bereich	`Administrator` `Editor`
Ziel löschen	`metrics-router.target.delete`	Bereich	`Administrator` `Editor`

Wenn Sie die CLI verwenden, beachten Sie, dass Sie die Rolle metrics-router.target.list zum Erstellen, Lesen, Aktualisieren oder Löschen eines Ziels benötigen.

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.

Aktivitätsverfolgung Auditing Ereignis Aktion
Task	Aktivitätsverfolgung Auditing Ereignis Aktion
Ziel erstellen	`metrics-router.target.create`
Alle Ziele auflisten	`metrics-router.target.list`
Details zu einem Ziel abrufen	`metrics-router.target.read`
Ziel ändern	`metrics-router.target.update`
Ziel löschen	`metrics-router.target.delete`

Verwalten von Zielen über die Benutzeroberfläche

Sie können Ihre Zieldefinition über die Benutzeroberfläche IBM Cloud Metrics Routing verwalten. Weitere Informationen finden Sie unter Verwaltung von Zielen.

CLI-Voraussetzungen

Bevor Sie die Befehlszeilenschnittstelle zum Verwalten von Zielen verwenden, führen Sie die folgenden Schritte aus:

Stellen Sie sicher, dass Sie über die richtigen IAM-Berechtigungen verfügen, um IBM Cloud Metrics Routingzu konfigurieren.
Installieren Sie die IBM Cloud-Befehlszeilenschnittstelle.
Installieren Sie die IBM Cloud Metrics Routing CLI.

Befehle der Befehlszeilenschnittstelle

In der folgenden Tabelle sind die Aktionen aufgelistet, die Sie ausführen können, um Ziele zu verwalten:

Zielgerichtete Maßnahmen
Aktion	Befehl
`Create a target`	`ibmcloud metrics-router target create`
`Update a target`	`ibmcloud metrics-router target update`
`Delete a target`	`ibmcloud metrics-router target rm`
`Read a target`	`ibmcloud metrics-router target get`
`List all targets`	`ibmcloud metrics-router target ls`

Weitere Informationen finden Sie unter IBM Cloud Metrics Routing v3 CLI.

API-Voraussetzungen

Bevor Sie die API zur Verwaltung von Zielen verwenden, führen Sie die folgenden Schritte aus:

Stellen Sie sicher, dass Sie über die richtigen IAM-Berechtigungen verfügen, um IBM Cloud Metrics Routingzu konfigurieren.
Rufen Sie ein IAM-Zugriffstoken ab. Weitere Informationen finden Sie unter Abrufen von IAM-Zugriffstokens.
Ermitteln Sie den API-Endpunkt in der Region, in der Sie ein Ziel konfigurieren oder verwalten möchten. Weitere Informationen finden Sie unter Endpunkte.

API-Methoden

In der folgenden Tabelle sind die Aktionen aufgelistet, die Sie ausführen können, um Ziele zu verwalten:

Gezielte Aktionen durch Verwendung der IBM Cloud Metrics Routing REST-API
Aktion	REST-API-Methode	API_URL
`Create a target`	`POST`	`<ENDPOINT>/api/v3/targets`
`Update a target`	`PATCH`	`<ENDPOINT>/api/v3/targets/<TARGET_ID>`
`Delete a target`	`DELETE`	`<ENDPOINT>/api/v3/targets/<TARGET_ID>`
`Read a target`	`GET`	`<ENDPOINT>/api/v3/targets/<TARGET_ID>`
`List all targets`	`GET`	`<ENDPOINT>/api/v3/targets`

Weitere Informationen finden Sie unter IBM Cloud Metrics Routing v3-API.

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:

Liste der Antwortcodes HTTP
Statuscode	Status	Beschreibung
`200`	OK	Die Anforderung war erfolgreich.
`201`	OK	Die Anforderung war erfolgreich. Eine Ressource wird erstellt.
`204`	OK	Das Ziel wurde erfolgreich gelöscht.
`400`	Ungültige Anforderung	Die Anforderung war nicht erfolgreich. Möglicherweise fehlt ein Parameter, der erforderlich ist.
`401`	Nicht berechtigt	Die Berechtigungsanforderung schlägt fehl.
`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 Anforderungen haben die API zu schnell getroffen.
`500`	Interner Serverfehler	In der IBM Cloud Metrics Routing Verarbeitung ist etwas schief gelaufen.