Установка Metrics Provider

Metrics Provider — связующий элемент между объектом в кластере Managed Service for Kubernetes и сервисом Yandex Monitoring.

Провайдер преобразует запрос на получение внешних метрик от объекта в кластере Kubernetes в нужный Yandex Monitoring формат, а также выполняет обратное преобразование — от Yandex Monitoring до объекта кластера.

Чтобы установить Metrics Provider:

1. Создайте сервисный аккаунт.
2. Установите провайдер с помощью Cloud Marketplace.

Создание сервисного аккаунта и статического ключа доступа

Для работы провайдера нужно создать сервисный аккаунт и получить для него ключ.

1. Установите утилиту потоковой обработки JSON-файлов jq:

   sudo apt update && sudo apt install jq
   

2. Создайте сервисный аккаунт с ролью monitoring.viewer.

3. Создайте ключ для сервисного аккаунта и сохраните его на локальный компьютер:

   yc iam key create \
     --service-account-id <идентификатор сервисного аккаунта> \
     --folder-id <идентификатор каталога> \
     --cloud-id <идентификатор облака> \
     --description metrics-provider \
     --format json \
     -o key.json
   

   Результат выполнения команды:

   {
     "id": "<идентификатор ключа сервисного аккаунта>",
     "service_account_id": "<идентификатор сервисного аккаунта>",
     "created_at": "2022-01-27T03:29:45.139311367Z",
     "description": "metrics-provider",
     "key_algorithm": "RSA_2048"
   }
   

   Примечание

   Сохраните идентификаторы сервисного аккаунта и его ключа — они понадобятся при дальнейшей установке.

4. Сохраните ключ сервисного аккаунта в формате Base64:

   jq -r .private_key key.json > key.pem
   

Установка с помощью Cloud Marketplace

1. Перейдите на страницу каталога и выберите сервис Managed Service for Kubernetes.
2. Нажмите на имя нужного кластера и выберите вкладку Marketplace.
3. В разделе Доступные для установки приложения выберите Metrics Provider и нажмите кнопку Использовать.
4. Задайте настройки приложения:

   • Пространство имен — выберите пространство имен или создайте новое.

   • Название приложения — укажите название приложения.

   • Идентификатор каталога — укажите идентификатор каталога, в котором будет работать Metrics Provider.

   • Ширина временного окна — укажите ширину временного окна, за которую будут собираться метрики (в формате DdHhMmSs, например, 5d10h30m20s).

   • (опционально) Отключение прореживания — выберите эту опцию, чтобы не применять к данным функцию прореживания.

   • (опционально) Функция агрегации — выберите функцию агрегации данных. Значение по умолчанию — AVG.

   • (опционально) Заполнение данных — выберите настройки заполнения пропусков в данных:

     • NULL — возвращает null в качестве значения метрики и timestamp в качестве временной метки. Значение по умолчанию.
     • NONE — не возвращает значений.
     • PREVIOUS — возвращает значение из предыдущей точки.

   • (опционально) Максимальное количество точек — укажите максимальное количество точек, которое будет получено в ответе на запрос. Значение параметра должно быть больше 10.

   • (опционально) Ширина временного окна прореживания — укажите ширину временного окна (сетки) в миллисекундах. Используется для прореживания: точки внутри окна объединяются в одну при помощи функции агрегации. Значение параметра должно быть больше 0.

     Примечание

     Выберите только одну из настроек Максимальное количество точек или Ширина временного окна прореживания. Чтобы не использовать эти настройки, оставьте оба поля пустыми. Подробнее см. в документации API.

   • ID сервисного аккаунта — укажите идентификатор созданного ранее сервисного аккаунта.

   • ID ключа сервисного аккаунта — укажите идентификатор ключа сервисного аккаунта.

   • Приватный ключ сервисного аккаунта — скопируйте в это поле содержимое файла key.pem.

5. Нажмите кнопку Установить.