Получение метрик Load Balancer с помощью CLI Azure Monitor

Из этой статьи вы узнаете несколько примеров для перечисления Load Balancer метрик с помощью Azure Monitor CLI.

Полные справочные материалы и другие примеры для получения метрик с помощью CLI Azure Monitor доступны здесь.

Вывод таблицы имен метрик с помощью CLI

При использовании CLI метрики Load Balancer могут использовать другое имя метрики для значения параметра CLI. При указании имени метрики с помощью параметра --metric dimension используйте имя метрики CLI. Например, метрика "Доступность пути данных" будет использоваться при указании параметра --metric VipAvaialbility.

Ниже приведена таблица общих метрик Load Balancer, имени метрики CLI и рекомендуемых значения агрегирования для запросов.

Метрика Имя метрики CLI Рекомендуемая статистическая обработка
Доступность пути к данным VipAvailability Среднее
Состояние проверки работоспособности DipAvailability Среднее
Количество SYN (синхронизация) SYNCount Среднее
Количество подключений SNAT SnatConnectionCount SUM
Выделенные порты SNAT AllocatedSnatPorts Средний
Используемые порты SNAT UsedSnatPorts Средний
Количество байтов ByteCount SUM
Количество пакетов PacketCount SUM

Сведения об определениях метрик и боле подробную информацию см. в справочнике по данным мониторинга Load Balancer.

Примеры CLI для метрик Load Balancer

Команда az monitor metrics используется для просмотра метрик ресурсов Azure. Чтобы просмотреть определения метрик, доступные для Load Balancer (цен. категория "Стандартный"), выполните команду az monitor metrics list-definitions.

# Display available metric definitions for a Standard Load Balancer resource

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

Примечание

В следующих примерах замените <resource_id> уникальным идентификатором ресурса Load Balancer (цен. категория "Стандартный").

Чтобы получить метрики Load Balancer (цен. категория "Стандартный") для ресурса, можно использовать команду az monitor metrics list. Например, воспользуйтесь параметром --metric DipAvailability для сбора метрики состояния пробы работоспособности из Load Balancer (цен. категория "Стандартный").


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

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

При выполнении приведенной выше команды выходные данные состояния пробы работоспособности будут выглядеть следующим образом:

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"
    }
  ]
}
...

Можно указать тип агрегата для метрики с помощью параметра –-aggregation. Рекомендуемые агрегаты см. в справочнике по мониторингу данных подсистемы балансировки нагрузки (./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 

Чтобы указать интервал для метрик, используйте параметр --interval и укажите значение в формате ##h##m. Интервал по умолчанию — 1 мин.


# 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

По умолчанию az monitor metrics list возвращает агрегированные метрики ресурса за последний час. Можно запросить данные метрики за определенный период. Для этого используйте --start-time и --end-time с форматом даты (гггг-мм-дд), времени (чч:мм:сс.xxxxx) и часового (+/-чч:мм). Чтобы получить список среднего состояния пробы работоспособности, агрегируемой ежедневно с 5 мая 2022 г. по 10 мая 2022 г., используйте следующую команду:

# 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

Примечание

Время начала и окончания представлено в формате гггг-мм-дд. Например, каждый день в период с 5 мая 2022 г. по 10 мая 2022 г. будет представлен как 2022-05-01 и 2022-05-10.

Чтобы разделить метрики по измерению, например "BackendIPAddress", укажите измерение в флаге --filter. Измерения метрики — это пары "имя — значение", которые содержат дополнительные данные для описания значения метрики. Дополнительные сведения о том, какие измерения поддерживаются для каждой метрики, см. в справочнике по данным мониторинга Load Balancer.

# 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

Можно также указать определенное значение измерения.

# 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 

В случаях, когда необходимо выполнить фильтрацию по нескольким значениям измерения, укажите значение --filter, используя and между значениями.

# 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 

Следующие шаги