Extracción de métricas de una instancia utilizando el cliente Python de Monitoring
Puede extraer métricas de una instancia de IBM Cloud Monitoring a través de operaciones de API REST que puede ejecutar utilizando un cliente Python o utilizando un mandato cURL.
Obtener métricas utilizando un cliente Python
Para aprender a utilizar el cliente Python, consulte Utilización del cliente Python.
El código siguiente muestra la estructura de un script Python que puede utilizar para recuperar métricas de una instancia de Monitoring:
# 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)
Debe incluir la siguiente información: <MONITORING-ENDPOINT>, <IAM_APIKEY>, y <GUID> Estos datos son necesarios para autenticar la solicitud con la instancia de monitorización. Para obtener
la información de la instancia de supervisión, consulte Autenticar el ID de usuario o de servicio utilizando IAM.
Ejemplos
Para ver ejemplos de Python, consulte los siguientes ejemplos:
Diccionario de métricas
Para ver las métricas predefinidas, consulte Diccionario de métricas.
Para ver las métricas predefinidas definidas por los servicios de IBM Cloud que están habilitados con Monitoring, consulte Servicios en la nube.
Agregación de datos
Para saber más sobre la agregación de datos, consulte Agregación de datos.