Share via

Obtención de métricas de Load Balancer con la CLI de Azure Monitor

  • Artículo

En este artículo, aprenderá algunos ejemplos para enumerar métricas de Load Balancer mediante la CLI de Azure Monitor.

La documentación de referencia completa y otros ejemplos para recuperar métricas mediante la CLI de Azure Monitor están disponibles en la referencia de métricas de az monitor.

Tabla de nombres de métricas a través de la CLI

Cuando se usa la CLI, las métricas de Load Balancer pueden usar un nombre de métrica diferente para el valor del parámetro de la CLI. Al especificar el nombre de la métrica a través del parámetro --metric dimension, use el nombre de la métrica de la CLI en su lugar. Por ejemplo, la métrica Disponibilidad de la ruta de acceso a datos se utilizaría especificando un parámetro de --metric VipAvaialbility.

Esta es una tabla de métricas comunes de Load Balancer, el nombre de la métrica de la CLI y los valores de agregación recomendados para las consultas:

Métrica Nombre de la métrica de la CLI Agregación recomendada
Disponibilidad de la ruta de acceso de datos VipAvailability Average
Estado del sondeo de mantenimiento DipAvailability Average
Recuento SYN (sincronizar) SYNCount Average
Recuento de conexiones SNAT SnatConnectionCount Sum
Puertos SNAT asignados AllocatedSnatPorts Media
Puertos SNAT usados UsedSnatPorts Average
Recuento de bytes ByteCount Sum
Recuento de paquetes PacketCount Sum

Para obtener definiciones de métricas y más detalles, consulte Supervisión de la referencia de datos del equilibrador de carga.

Ejemplos de la CLI para métricas de Load Balancer

El comando az monitor metrics se usa para ver las métricas de recursos de Azure. Para ver las definiciones de métricas disponibles para Standard Load Balancer, ejecute el comando az monitor metrics list-definitions.

# Display available metric definitions for a Standard Load Balancer resource

az monitor metrics list-definitions --resource <resource_id>

Nota:

En todos los ejemplos siguientes, reemplace <resource_id> por el identificador de recurso único de Standard Load Balancer.

Para recuperar las métricas de Standard Load Balancer de un recurso, puede usar el comando az monitor metrics list. Por ejemplo, use la opción --metric DipAvailability para recopilar la métrica Estado del sondeo de mantenimiento de Standard Load Balancer.


# List the Health Probe Status metric from a Standard Load Balancer

az monitor metrics list --resource <resource_id> --metric DipAvailability

Al ejecutar el comando anterior, la salida del Estado del sondeo de mantenimiento será similar a la siguiente:

user@Azure:~$ az monitor metrics list --resource <resource_id> --metric DipAvailability
{
  "cost": 59,
  "interval": "0:01:00",
  "namespace": "Microsoft.Network/loadBalancers",
  "resourceregion": "eastus2",
  "timespan": "2022-06-30T15:22:39Z/2022-06-30T16:22:39Z",
  "value": [
    {
      "displayDescription": "Average Load Balancer health probe status per time duration",
      "errorCode": "Success",
      "errorMessage": null,
      "id": "/subscriptions/6a5f35e9-6951-499d-a36b-83c6c6eed44a/resourceGroups/myResourceGroup2/providers/Microsoft.Network/loadBalancers/myLoadBalancer/providers/Microsoft.Insights/metrics/DipAvailability",
      "name": {
        "localizedValue": "Health Probe Status",
        "value": "DipAvailability"
      },
      "resourceGroup": "myResourceGroup2",
      "timeseries": [],
      "type": "Microsoft.Insights/metrics",
      "unit": "Count"
    }
  ]
}
...

Puede especificar el tipo de agregación de una métrica con el parámetro –-aggregation. Para obtener agregaciones recomendadas, consulte Supervisión de la referencia de datos del equilibrador de carga](./monitor-load-balancer-reference.md).


# List the average Health Probe Status metric from a Standard Load Balancer

az monitor metrics list --resource <resource_id> --metric DipAvailability --aggregation Average

Para especificar el intervalo en las métricas, use el parámetro --interval y especifique un valor en formato ##h##m. El intervalo predeterminado es de 1 minuto.


# List the average List the average Health Probe Status metric from a Standard Load Balancer in 5 minute intervals

az monitor metrics list --resource <resource_id> --metric DipAvailability --aggregation Average --interval 5m

De forma predeterminada, la lista de métricas de az monitor devuelve las métricas agregadas del recurso de la última hora. Puede consultar los datos de métricas durante un período de tiempo mediante --start-time y --end-time con el formato de fecha (aaaa-mm-dd) hora (hh:mm:ss.xxxxx) zona horaria (+/-hh:mm). Para enumerar el Estado del sondeo de mantenimiento agregado por día desde el 5 de mayo de 2022 y el 10 de mayo de 2022, use el siguiente comando:

# List average Health Probe Status metric aggregated per day from May 5, 2022 and May 10, 2022. 

az monitor metrics list --resource <resource_id> --metric DipAvailability --start-time 2022-05-01T00:00:00Z --end-time 2022-05-10T00:00:00Z --interval PT24H --aggregation Average

Nota:

Las horas de inicio y finalización se representan mediante un formato de formato aaaa-mm-dd. Por ejemplo, todos los días comprendidos entre el 5 de mayo de 2022 y el 10 de mayo de 2022 se representarían como 2022-05-01 y 2022-05-10.

Para dividir las métricas en una dimensión, como "BackendIPAddress", especifique la dimensión en la marca --filter. Las dimensiones de una métrica son pares nombre-valor que incluyen más datos para describir el valor de la métrica. Para más información sobre qué dimensiones se admiten para cada métrica, consulte Supervisión de la referencia de datos del equilibrador de carga.

# List average Health Probe Status metric and filter for all BackendIPAddress dimensions

az monitor metrics list --resource $res --metric DipAvailability --filter "BackendIPAddress eq '*'" --aggregation Average

También puede especificar un valor de dimensión específico.

# List average Health Probe Status metric and filter for the 10.1.0.4 BackendIPAddress dimension

az monitor metrics list --resource <resource_id> --metric DipAvailability --filter "BackendIPAddress eq '10.1.0.4'" --aggregation Average

En los casos en los que necesite filtrar por varios valores de dimensión, especifique el valor --filter mediante and entre los valores.

# List average Health Probe Status metric and filter for all BackendIPAddress and BackendPort dimensions

az monitor metrics list --resource <resource_id> --metric DipAvailability --filter "BackendIPAddress eq '*' and BackendPort eq '*'" --aggregation Average

Pasos siguientes