Obtener métricas de utilización de máquina virtual mediante la API de REST

Artículo
01/30/2024

Se aplica a: ✔️ máquinas virtuales Linux ✔️ conjuntos de escalado flexibles

En este ejemplo se muestra cómo recuperar la utilización de CPU de una máquina virtual Linux mediante la API REST de Azure.

La documentación de referencia completa y los ejemplos para la API de REST están disponibles en el artículo de referencia de REST de Azure Monitor.

Compilar la solicitud

Utilice la siguiente solicitud GET para recopilar la métrica de porcentaje de CPU desde una máquina Virtual

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{vmname}/providers/microsoft.insights/metrics?api-version=2018-01-01&metricnames=Percentage%20CPU&timespan=2018-06-05T03:00:00Z/2018-06-07T03:00:00Z

Encabezados de solicitud

Los siguientes encabezados son obligatorios:

Encabezado de solicitud	Descripción
Content-Type:	Necesario. Establézcalo en `application/json`.
Authorization:	Necesario. Establézcalo en un token de acceso`Bearer` válido.

Parámetros del identificador URI

Nombre	Descripción
subscriptionId	El id. de suscripción que identifica una suscripción de Azure. Si tiene varias suscripciones, consulte Trabajo con varias suscripciones.
resourceGroupName	El nombre del grupo de recursos de Azure asociado al recurso. Puede obtener este valor de la API Azure Resource Manager, la CLI o el portal.
vmname	El nombre de la máquina virtual de Azure.
metricnames	Lista separada por comas de métricas válidas de Load Balancer.
api-version	La versión de API que se usará para la solicitud. En este documento se describe la versión `2018-01-01` de la API que se incluye en la dirección URL anterior.
timespan	Cadena con el siguiente formato `startDateTime_ISO/endDateTime_ISO` que define el intervalo de tiempo de las métricas devueltas. Este parámetro opcional se establece para devolver los datos recopilados durante un día en el ejemplo.

Cuerpo de la solicitud

No se necesita ningún cuerpo de solicitud para esta operación.

Control de la respuesta

Cuando la lista de valores de métricas se devuelve correctamente, se devuelve el código de estado 200. Una lista completa de códigos de error está disponible en la documentación de referencia.

Respuesta de ejemplo

{
    "cost": 0,
    "timespan": "2018-06-08T23:48:10Z/2018-06-09T00:48:10Z",
    "interval": "PT1M",
    "value": [
        {
            "id": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{vmname}/providers/microsoft.insights/metrics?api-version=2018-01-01&metricnames=Percentage%20CPU",
            "type": "Microsoft.Insights/metrics",
            "name": {
                "value": "Percentage CPU",
                "localizedValue": "Percentage CPU"
            },
            "unit": "Percent",
            "timeseries": [
                {
                    "metadatavalues": [],
                    "data": [
                        {
                            "timeStamp": "2018-06-08T23:48:00Z",
                            "average": 0.44
                        },
                        {
                            "timeStamp": "2018-06-08T23:49:00Z",
                            "average": 0.31
                        },
                        {
                            "timeStamp": "2018-06-08T23:50:00Z",
                            "average": 0.29
                        },
                        {
                            "timeStamp": "2018-06-08T23:51:00Z",
                            "average": 0.29
                        },
                        {
                            "timeStamp": "2018-06-08T23:52:00Z",
                            "average": 0.285
                        } ]
                } ]
        } ]
}