Мониторинг Яндекс Облака с помощью Proto Observability Platform

На этой странице:

• Сбор метрик Yandex Cloud
  • Конфигурация ProtoOBP агента
    • Если агент запускается в виде службы на хосте
    • Если агент запускается в виде Docker контейнера
  • Переменные окружения
  • Параметры конфигурации
  • Как происходит сбор метрик
  • Теги, добавляемые автоматически
  • Проверка
  • Список метрик
    • Метрики Compute Cloud
      • Виртуальные машины и диски
      • Файловые хранилища
      • Группы виртуальных машин
    • Метрики Managed Kubernetes
      • Мастер
      • Контейнеры
      • Узлы
      • Поды
      • Постоянные тома
    • Служебная метрика интеграции

Сбор метрик Yandex Cloud

Интеграция yandex_cloud собирает метрики через Yandex Cloud Monitoring API в формате Prometheus text. На каждой паре folder_id × yandex_cloud_service агент выполняет HTTP GET к https://monitoring.api.cloud.yandex.net/monitoring/v2/prometheusMetrics и парсит ответ построчно.

В системе доступен сбор любых метрик из Яндекс Облака; для метрик Compute Cloud поставляются встроенные дашборды, позволяющие анализировать производительность виртуальных машин:

• Список виртуальных машин Compute Cloud:
• Дашборд виртуальной машины Compute Cloud:

Ссылки на официальную документацию:

• Yandex Cloud Monitoring API: https://yandex.cloud/ru/docs/monitoring/api-ref/
• Получение API-ключа: https://yandex.cloud/ru/docs/monitoring/api-ref/authentication
• Справочник метрик: https://yandex.cloud/ru/docs/monitoring/metrics-ref/

Конфигурация ProtoOBP агента

Если агент запускается в виде службы на хосте

1. Положите файл проверки yandex_cloud.py в /etc/protoobp-agent/checks.d/.

2. Создайте файл /etc/protoobp-agent/conf.d/yandex_cloud.d/conf.yaml:

   init_config:
   
   instances:
     - folder_id:
         - "<FOLDER_ID_1>"
         - "<FOLDER_ID_2>"
       yandex_cloud_service:
         - "compute"
         - "managed-clickhouse"
         - "managed-kubernetes"
       api_key: "<YANDEX_API_KEY>"
       metrics:
       label_tag_allowlist: []
       tags:
         - platform:yandex_cloud
       metric_prefix: "yandex_cloud."
       timeout: 10
       ssl_verify: true
   

3. Перезапустите агента: systemctl restart protoobp-agent.

Если агент запускается в виде Docker контейнера

Смонтируйте каталоги checks.d и conf.d/yandex_cloud.d в контейнер агента и передайте folder_id, yandex_cloud_service и api_key через переменные окружения. В docker-compose.yaml:

services:
  protoobp-agent:
    image: registry.git.proto.group/protoobp/protoobp-artifacts/protoobp-agent:7.40.3
    volumes:
      - ./checks.d:/etc/protoobp-agent/checks.d:ro
      - ./conf.d/yandex_cloud.d:/etc/protoobp-agent/conf.d/yandex_cloud.d:ro
    environment:
      - POBP_API_KEY=${POBP_API_KEY}
      - POBP_POBP_URL=${POBP_BACKEND_URL}
      - YANDEX_API_KEY=${YANDEX_API_KEY}
      - YANDEX_FOLDER_ID=${YANDEX_FOLDER_ID}
      - YANDEX_SERVICE=${YANDEX_SERVICE}

Файл conf.d/yandex_cloud.d/conf.yaml рядом — тот же, что и для службы на хосте; folder_id, yandex_cloud_service и api_key агент возьмёт из переменных окружения, поэтому в YAML их можно оставить пустыми или вовсе убрать соответствующие ключи.

Переменные окружения

Если значение указано и в YAML, и в переменной окружения, приоритет — у YAML.

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

Как происходит сбор метрик

• Для каждой пары folder_id × yandex_cloud_service выполняется GET-запрос: <endpoint>?folderId=<folder_id>&service=<service>.
• Ответ читается как Prometheus text format и парсится построчно.
• Все значения отправляются как gauge. Типы метрик из документации Yandex Cloud Monitoring (RATE, HIST_RATE, DGAUGE, IGAUGE) на стороне интеграции не сохраняются: в Proto Observability Platform все они попадают как gauge, поэтому гистограммы и rate автоматически не обрабатываются.
• Метрики типа RATE (например, байты/с, операции/с) на дашбордах рекомендуется отображать как «текущее значение».
• Некорректные и нечисловые значения игнорируются.
• При временной ошибке (HTTP 429, 5xx, таймаут) выполняется один повторный запрос с увеличенным таймаутом.

Теги, добавляемые автоматически

К каждой точке добавляются:

• folder_id:<id> — ID папки.
• yandex_cloud_service:<service> — сервис, для которого собирались метрики.
• Все лейблы Prometheus-метрики (с учётом label_tag_allowlist). Лейбл service автоматически переименовывается в yandex_cloud_service, чтобы не затирать общий тег service агента.

Особый случай для дисков:

• Если метрика содержит лейбл disk, но не содержит instance, интеграция ищет instance в других метриках с тем же disk и подставляет его.
• Дисковым метрикам дополнительно проставляется resource_id, равный instance (или найденному по disk).

Проверка

Убедитесь, что проверка запустилась и собирает метрики:

docker exec protoobp-agent agent status | grep -A 10 "yandex_cloud (unversioned)"

Ожидаемый вывод — Instance ID: ... [OK] и ненулевое Metric Samples:

    yandex_cloud (unversioned)
    --------------------------
      Instance ID: yandex_cloud:e8aa6920911941c3 [OK]
      Configuration Source: file:/etc/protoobp-agent/conf.d/yandex_cloud.d/conf.yaml
      Total Runs: 90
      Metric Samples: Last Run: 1,618, Total: 143,289
      Events: Last Run: 0, Total: 0
      Service Checks: Last Run: 1, Total: 90
      Average Execution Time : 3.649s
      Last Execution Date : 2026-05-13 13:47:16 UTC
      Last Successful Execution Date : 2026-05-13 13:47:16 UTC

Запустить проверку вручную:

docker exec protoobp-agent agent check yandex_cloud

Список метрик

• yandex_cloud_services — служебная метрика (gauge = 1) на каждую комбинацию folder_id × service.
• Все метрики, которые вернул Yandex Cloud Monitoring Prometheus Metrics API для указанных сервисов.
  • Итоговое имя метрики формируется как yandex_cloud_ + исходное имя, при этом точки заменяются на _. Пример: filestore.read_ops → yandex_cloud_filestore_read_ops.
  • Чтобы ограничить набор, используйте параметр metrics со списком исходных имён из Yandex Cloud Monitoring.

Метрики Compute Cloud

Все метрики Compute Cloud имеют тег yandex_cloud_service=compute. Если у ресурса задано имя, в метках возвращается имя; иначе — идентификатор. В таблицах ниже приведены итоговые имена метрик в Proto Observability Platform (префикс yandex_cloud_, точки заменены на _).

Виртуальные машины и диски

Файловые хранилища

Общие лейблы для метрик файловых хранилищ:

• filestore — идентификатор файлового хранилища.
• instance — имя виртуальной машины.

Группы виртуальных машин

Доступные метрики зависят от типа масштабирования группы ВМ.

Метрики Managed Kubernetes

Все метрики Managed Kubernetes имеют тег yandex_cloud_service=managed-kubernetes.

Мастер

Контейнеры

Узлы

Поды

Постоянные тома

Служебная метрика интеграции