Obtention des métriques à l'aide d'un client Python

Pour savoir comment utiliser le client Python, voir Utilisation du client Python.

Le code suivant présente la structure d'un script Python que vous pouvez utiliser pour extraire les métriques d'une instance 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)

Vous devez inclure les informations suivantes : <MONITORING-ENDPOINT>, <IAM_APIKEY>, et <GUID> Ces données sont nécessaires pour authentifier la demande auprès de l'instance de monitoring. Pour obtenir les informations sur l'instance de surveillance, voir Authentification de votre ID d'utilisateur ou de service à l'aide d'IAM.

Exemples

Pour des exemples Python, reportez-vous à l'un des exemples suivants :

• Exemple 1: Cet exemple de script montre comment obtenir des données en créant une requête sans filtre ni segmentation.

• Exemple 2: cet exemple de script montre comment obtenir des données en créant une requête comportant un filtre et une segmentation.

Dictionnaire des métriques

Pour voir les métriques prédéfinies, voir Dictionnaire des métriques.

Pour afficher les métriques prédéfinies des services IBM Cloud compatibles avec la surveillance (Monitoring), voir Services cloud.

Agrégation des données

Pour en savoir plus sur l'agrégation des données, voir Agrégation des données.