Überwachung von Metriken aktivieren

Sie müssen Ihre IBM Cloud Monitoring-Instanz konfigurieren, bevor Sie Überwachungsmetriken empfangen können.

Führen Sie die folgenden Schritte aus, um Überwachungsmetriken zu empfangen:

1. Navigieren Sie zum Portal für die Metriküberwachung und klicken Sie auf "Überwachungsinstanz erstellen ".

2. Wählen Sie eine Region für Ihre IBM Cloud Monitoring-Instanz aus.

   Wenn Sie über keinen vorhandenen VPN-Server verfügen, lesen Sie die Informationen unter VPN-Server erstellen, um einen VPN-Server bereitzustellen.

   Die Region muss mit der Position Ihres vorhandenen VPN-Servers übereinstimmen.

3. Wählen Sie Ihren Preisstrukturplan aus. Details zum Preisstrukturplan werden im Auswahlfenster erläutert. Wählen Sie den Plan aus, der Ihren Anforderungen am besten entspricht.

4. Geben Sie einen eindeutigen Servicenamen für Ihre Instanz an. Der Name kann ein beliebiger Name sein und hat keine Auswirkungen auf die Funktionalität.

   Verwenden Sie nicht denselben Namen für mehrere IBM Cloud Monitoring-Instanzen.

5. Wählen Sie optional eine Ressourcengruppe aus. Durch eine Ressourcengruppe werden Kontoressourcen in anpassbaren Gruppierungen zusammengefasst. Jede Kontoressource, die über IAM-Zugriffssteuerung (IAM = IBM Cloud Identity and Access Management) verwaltet wird, gehört zu einer Ressourcengruppe in Ihrem Konto.

   Verwenden Sie die Standardauswahl, wenn Sie über keine vorkonfigurierten Ressourcengruppen verfügen oder kein Anlass besteht, die Ressource selektiv zur gemeinsamen Verwendung zur Verfügung zu stellen.

   Wenn Ihr Konto über mehrere Ressourcengruppen verfügt, können Sie auswählen, welche Ressourcengruppe Zugriff auf die IBM Cloud Monitoring-Instanz haben soll. Durch die Verwendung dieses selektiven Zugriffs können Metriken für einige Ressourcengruppen zur Verfügung stehen, für andere dagegen nicht.

6. Wählen Sie das Kontrollkästchen Plattformmetriken aktivieren aus. Sie müssen diese Option auswählen, um Metriken von Ihrem VPN-Server zu empfangen.

7. Klicken Sie auf Erstellen. Sie werden zur Homepage der Überwachungsmetriken zurückgeleitet.

Innerhalb weniger Minuten wird Ihre neue IBM Cloud Monitoring-Instanz mit mehreren Konfigurationen angezeigt. Möglicherweise müssen Sie Ihren Browser aktualisieren, damit die Instanz angezeigt wird.

MitIBM Cloud Monitoring und den APIs arbeiten

Sie können mit der IBM Cloud Monitoring-Instanz auch über die APIs für das Abfragen von Metriken arbeiten. Die Verwendung der APIs kann hilfreich sein, wenn Sie Rohdatenpunkte benötigen oder Ihre Metriken über eine Befehlszeilenschnittstelle und nicht mithilfe der IBM Cloud Monitoring-Dashboards verarbeiten möchten.

Nach dem Erstellen Ihrer IBM Cloud Monitoring-Instanz müssen Sie die beiden folgenden Informationen ermitteln.

• Das Monitor-API-Token
• Der Endpunkt Ihrer Instanz von IBM Cloud Monitoring

Führen Sie die folgenden Schritte aus, um diese Informationen zu ermitteln und mit Ihrer IBM Cloud Monitoring-Instanz unter Verwendung der API für Metrikabfrage zu arbeiten:

1. Rufen Sie die Monitoring-Homepageauf.

2. Klicken Sie auf Dashboard öffnen neben der Instanz, mit der Sie arbeiten möchten.

3. Sobald das IBM Cloud Monitoring-Dashboard angezeigt wird, wählen Sie in der Seitenleiste das Symbol für Ihr Kontoprofil und dann Einstellungen aus. Daraufhin werden Ihre Kontoeinstellungen angezeigt.

4. Ihr Token der Überwachungs-API ist eine alphanumerische Zeichenfolge, die sich im Feld Token der Sysdig-Überwachungs-API befindet. Klicken Sie auf die Schaltfläche Kopieren, um das Token in die Zwischenablage zu kopieren.

   Geben Sie dieses API-Token nicht weiter. Jeder, der dieses API-Token besitzt, hat uneingeschränkten Zugriff auf Ihre Metriken.

5. Der Endpunkt Ihrer IBM Cloud Monitoring-Instanz gilt pro Region. Wenn Ihre IBM Cloud Monitoring-Instanz beispielsweise in us-south vorhanden ist, lautet ihr Endpunkt wie folgt:

   https://us-south.monitoring.cloud.ibm.com/api/data/batch
   

   Der erste Teil der URL (im Beispiel us-south.monitoring.cloud.ibm.com) stellt Ihren Endpunkt dar. Notieren Sie diese URL.

6. Nachdem Sie sowohl das API-Token als auch den Endpunkt ermittelt haben, können Sie Ihre POST-Anforderung formatieren. Das folgende Beispiel einer POST-Anforderung enthält alle Parameter, die Sie ändern können. Dabei handelt es sich um die folgenden Parameter:

   • Das Monitor-API-Token.
   • Endpunkt Ihrer IBM Cloud Monitoring-Instanz
   • Der Wert für ibm_is_vpn_server_name (der Name des VPN-Servers, für den Metriken angezeigt werden sollen).

   Wenn Sie diese Metrik für alle Ihre VPN-Server anzeigen möchten, geben Sie keinen Wert für das Attribut scope ein. Verwenden Sie zum Beispiel "scope" : "".

   • Der Metriktyp, für den die Ergebnisse angezeigt werden sollen. In diesem Beispiel wird ibm_is_vpn_server_health_status verwendet.
   • Die Attribute from und to definieren den Zeitraum, auf die der Suchlauf begrenzt werden soll. Sie werden in Mikrosekunden in Epochenzeit angegeben.
   • Die Attribute sampling und value legen in der Post-Anforderung die Granularität fest, mit der Daten zurückgegeben werden.

Da ein großes Datenvolumen in IBM Cloud Monitoringgespeichert wird, ist die Auswahl der jeweiligen Granularitätsstufe wichtig. IBM Cloud Monitoring kann pro Anforderung jeweils nur 600 Datenpunkte zurückgeben. Folglich sind die Attribute sampling und value wichtig. Wenn Sie diese beiden Zeilen in Ihrer Anforderung auslassen, wird stattdessen eine kumulierte Summe für den jeweiligen Zeitraum zurückgegeben.

Wenn der über from und to angegebene Zeitraum sehr groß ist (z. B. 4 Tage) und Sie für sampling und value 10 Sekunden festlegen, dann bedeutet dies, dass Sie die Menge an Daten für 4 Tage in Blöcken von 10 Sekunden erhalten. Diese Abtastung ist aufgrund der großen Menge an zurückgegebenen Daten wenig sinnvoll. Es wird empfohlen, eine größere Blockgröße (zum Beispiel 1 Stunde anstelle von 10 Sekunden) anzugeben.

   curl \
   -H 'Authorization: Bearer <API_TOKEN>’ \
   -H 'Content-Type: application/json' \
   https://us-south.monitoring.cloud.ibm.com/api/data/batch  \
   -d '{
     "requests": [
         {
             "format": {
                 "type": "data"
             },
             "scope": "ibm_is_vpn_server_name = \"test-001\"",
             "metrics": {
                 "k0": "timestamp",
                 "v1": "ibm_is_vpn_server_health_status"
             },
             "time": {
                 "from": 1624849800000000,
                 "to": 1624850400000000,
                 "sampling": 60000000
             },
             "group": {
                 "by": [
                     {
                        "metric": "k0",
                         "value" : 60000000
                     }
                 ],
                 "aggregations": {
                     "v1": "avg"
                 },
                 "groupAggregations": {
                     "v1": "avg"
                 }
             }
         }
     ]
 }'