IBM Cloud Docs
Extracción de métricas de una instancia utilizando el cliente Python de Monitoring

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:

  • Ejemplo 1: Este script de ejemplo muestra cómo obtener datos creando una petición que no tiene filtro ni segmentación.

  • Ejemplo 2: Este script de ejemplo muestra cómo obtener datos creando una petición que tiene un filtro y una segmentación.

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.