Metriken aus einer Instanz mithilfe des Monitoring-Python-Clients extrahieren
Sie können Metriken aus einer IBM Cloud Monitoring-Instanz über REST-API-Operationen extrahieren, die Sie mit einem Python-Client oder mit einem cURL-Befehl ausführen können.
Metriken mithilfe eines Python-Clients abrufen
Informationen zur Verwendung des Python-Clients finden Sie unter Python-Client verwenden.
Der folgende Code zeigt die Struktur eines Python-Scripts, das Sie zum Abrufen von Metriken aus einer Monitoring-Instanz verwenden können:
# Reference the Python client
from sdcclient import IbmAuthHelper, SdMonitorClient
# Add the monitoring instance information that is required for authentication
URL = <MONITORING-ENDPOINT>
APIKEY = <IAM_APIKEY>
GUID = <GUID>
ibm_headers = IbmAuthHelper.get_headers(URL, APIKEY, GUID)
# Instantiate the Python client
sdclient = SdMonitorClient(sdc_url=URL, custom_headers=ibm_headers)
# Specify the ID for keys, and ID with aggregation for values
metrics = [
{"id": "cpu.used.percent", "aggregations": {"time": "timeAvg", "group": "avg"}}
]
# Add a data filter or set to None if you want to see "everything"
filter = None
# Time window:
# - for "from A to B": start is equal to A, end is equal to B (expressed in seconds)
# - for "last X seconds": start is equal to -X, end is equal to 0
start = -600
end = 0
# Sampling time:
# - for time series: sampling is equal to the "width" of each data point (expressed in seconds)
# - for aggregated data (similar to bar charts, pie charts, tables, etc.): sampling is equal to 0
sampling = 60
# Load data
ok, res = sdclient.get_data(metrics, start, end, sampling, filter=filter)
if ok:
print(res)
Sie müssen die folgenden Informationen angeben: <MONITORING-ENDPOINT>, <IAM_APIKEY>, und <GUID> Diese Daten sind erforderlich, um die Anfrage bei der Überwachungsinstanz zu authentifizieren.
Informationen zum Abrufen der Informationen zur Überwachungsinstanz finden Sie unter Ihren Benutzer oder Ihre Service-ID mithilfe von IAM authentifizieren.
Beispiele
Nachstehend einige Python-Beispiele:
-
Beispiel 1: Dieses Beispielskript zeigt, wie man Daten abruft, indem man eine Anfrage ohne Filter und ohne Segmentierung erstellt.
-
Beispiel 2: Dieses Beispielskript zeigt, wie Sie Daten abrufen, indem Sie eine Anfrage mit einem Filter und einer Segmentierung erstellen.
Metrikverzeichnis
Eine Übersicht über die vordefinierten Metriken finden Sie im Wörterbuch der Metriken.
Informationen zum Anzeigen der vordefinierten Metriken, die durch überwachungsfähige IBM Cloud-Services definiert werden, finden Sie unter Cloud-Services.
Datenaggregation
Weitere Informationen zur Datenaggregation finden Sie unter Datenaggregation.