Поделиться через

Конфигурация метрик кластера

  • Статья

Когда пользователь развертывает кластер, для коллекции включен стандартный набор метрик. Список метрик см. в разделе "Список собранных метрик".

Пользователи не могут управлять поведением (включением или отключением) для сбора этих стандартных метрик. Хотя пользователи могут управлять коллекцией некоторых необязательных метрик, которые не являются частью ссылки на список. Чтобы обеспечить эту возможность, пользователям необходимо создать и обновить ресурс MetricsConfiguration для кластера. По умолчанию создание этого ресурса MetricsConfiguration не изменяет коллекцию метрик. Пользователь должен обновить ресурс, чтобы включить или отключить эти необязательные коллекции метрик.

Примечание.

  • Для кластера можно создать только один ресурс MetricsConfiguration.
  • Пользователям необходимо создать ресурс MetricsConfiguration, чтобы проверить список необязательных метрик, которые можно контролировать.
  • Удаление ресурса MetricsConfiguration приводит к восстановлению стандартного набора метрик.

Управление конфигурацией метрик кластера

Для поддержки жизненного цикла конфигураций метрик кластера следующие взаимодействия позволяют создавать конфигурации метрик кластера и управлять ими.

Создание конфигурации метрик

az network cluster metricsconfiguration create Используйте команду для создания конфигурации метрик для кластера. Если у вас несколько подписок Azure, пользователь должен передать идентификатор подписки с помощью флага --subscription <SUBSCRIPTION_ID> в команду CLI или выбрать соответствующий идентификатор подписки с помощью команды az account set .

az networkcloud cluster metricsconfiguration create \
 --cluster-name "<CLUSTER>" \
 --extended-location name="<CLUSTER_EXTENDED_LOCATION_ID>" type="CustomLocation" \
 --location "<LOCATION>" \
 --collection-interval <COLLECTION_INTERVAL (1-1440)> \
 --enabled-metrics "<METRIC_TO_ENABLE_1>" "<METRIC_TO_ENABLE_2>" \
 --tags <TAG_KEY1>="<TAG_VALUE1>" <TAG_KEY2>="<TAG_VALUE2>" \
 --resource-group "<RESOURCE_GROUP>"
  • Замените значения внутри < > определенной информацией.
  • Запрос ресурса кластера и поиск значения <CLUSTER-EXTENDED-LOCATION-ID> в properties.clusterExtendedLocation
  • Поле collection-interval является обязательным и enabled-metrics является необязательным.

Кроме того, операторы могут предоставлять список включенных метрик через json или yaml-файл.

Пример: файл enabled-metrics.json

[
   "metric_1",
   "metric_2"
]

Пример: файл enabled-metrics.yaml

- "metric_1"
- "metric_2"

Пример команды для использования json/yaml с включенными метриками:

az networkcloud cluster metricsconfiguration create \
 --cluster-name "<CLUSTER>" \
 --extended-location name="<CLUSTER_EXTENDED_LOCATION_ID>" type="CustomLocation" \
 --location "<LOCATION>" \
 --collection-interval <COLLECTION_INTERVAL (1-1440)> \
 --enabled-metrics <path-to-yaml-or-json-file> \
 --tags <TAG_KEY1>="<TAG_VALUE1>" <TAG_KEY2>="<TAG_VALUE2>" \
 --resource-group "<RESOURCE_GROUP>"

<Здесь путь к yaml-or-json-файл> может быть ./enabled-metrics.json или ./enabled-metrics.yaml (поместите файл в текущий рабочий каталог) перед выполнением действия.

Чтобы просмотреть все доступные параметры и их описание, выполните команду:

az networkcloud cluster metricsconfiguration create --help

Элементы конфигурации метрик

Наименование параметра Description
CLUSTER Имя ресурса кластера
LOCATION Регион Azure, в котором развернут кластер
CLUSTER_EXTENDED_LOCATION_ID Расширенное расположение кластера из портал Azure
COLLECTION_INTERVAL Частота сбора стандартных метрик по умолчанию
RESOURCE_GROUP Имя группы ресурсов кластера
TAG_KEY1 Необязательный тег 1 для передачи в создание MetricsConfiguration
TAG_VALUE1 Необязательное значение тега1 для передачи в создание MetricsConfiguration
TAG_KEY2 Необязательный тег 2 для передачи в создание MetricsConfiguration
TAG_VALUE2 Необязательное значение tag2 для передачи в создание MetricsConfiguration
METRIC_TO_ENABLE_1 Дополнительная метрика "METRIC_TO_ENABLE_1", включенная в дополнение к метрикам по умолчанию
METRIC_TO_ENABLE_2 Дополнительная метрика "METRIC_TO_ENABLE_2", включенная в дополнение к метрикам по умолчанию

Указание --no-wait --debug параметров в az command приводит к асинхронной выполнению этой команды. Дополнительные сведения см. в статье об отслеживании асинхронных операций.

Примечание.

  • Интервал сбора метрик по умолчанию для стандартного набора метрик устанавливается каждые 5 минут. collectionInterval Изменение также влияет на частоту сбора стандартных метрик по умолчанию.
  • Для каждого кластера может быть только один набор конфигурации метрик. Ресурс создается с именем default.

Вывод списка конфигурации метрик

Вы можете проверить ресурс конфигурации метрик для определенного кластера с помощью az networkcloud cluster metricsconfiguration list команды:

az networkcloud cluster metricsconfiguration list \
 --cluster-name "<CLUSTER>" \
 --resource-group "<RESOURCE_GROUP>"

Получение конфигурации метрик

После создания конфигурации метрик операторы могут проверить сведения о ресурсе с помощью az networkcloud cluster metricsconfiguration show команды:

az networkcloud cluster metricsconfiguration show \
 --cluster-name "<CLUSTER>" \
 --resource-group "<RESOURCE_GROUP>"

Эта команда возвращает представление JSON конфигурации метрик. Список включенных и отключенных метрик можно просмотреть в дополнение к частоте сбора в качестве выходных данных для этой команды.

Обновление конфигурации метрик

Как и при создании конфигурации метрик, операторы могут выполнить действие обновления для изменения конфигурации или обновления тегов, назначенных конфигурации метрик.

az networkcloud cluster metricsconfiguration update \
 --cluster-name "<CLUSTER>" \
 --collection-interval <COLLECTION_INTERVAL (1-1440)> \
 --enabled-metrics "<METRIC_TO_ENABLE_1>" "<METRIC_TO_ENABLE_2>" \
 --tags <TAG_KEY1>="<TAG_VALUE1>" <TAG_KEY2>="<TAG_VALUE2>" \
 --resource-group "<RESOURCE_GROUP>"

Операторы могут обновляться collection-interval независимо от enabled-metrics списка. Опустить поля, которые не изменяются.

Указание --no-wait --debug параметров в az command приводит к асинхронной выполнению этой команды. Дополнительные сведения см. в статье об отслеживании асинхронных операций.

Удаление конфигурации метрик

Удаление конфигурации метрик возвращает кластер в неуправляемую конфигурацию. Чтобы удалить конфигурацию метрик, используйте команду:

az networkcloud cluster metricsconfiguration delete \
 --cluster-name "<CLUSTER>" \
 --resource-group "<RESOURCE_GROUP>"

Указание --no-wait --debug параметров в az command приводит к асинхронной выполнению этой команды. Дополнительные сведения см. в статье об отслеживании асинхронных операций.