Yandex Cloud
КейсыДокументация
ПрезентацияСвязаться с намиНачать бесплатно
Создавайте контент и получайте гранты!Готовы написать своё руководство? Участвуйте в контент-программе и получайте гранты на работу с облачными сервисами!
Подробнее о программе
Сделано на Gravity UI
Проект Яндекса
© 2026 ООО «Яндекс.Облако»
Yandex Query
  • Закрытие сервиса Yandex Query
    • Форматы данных и алгоритмы сжатия
      • Чтение данных с помощью соединений
      • Запись данных
    • Работа с базами данных Managed Service for ClickHouse®
    • Работа с базами данных Yandex MPP Analytics for PostgreSQL
    • Работа с базами данных Managed Service for MySQL®
    • Работа с базами данных Managed Service for PostgreSQL
    • Работа с базами данных Managed Service for YDB
    • Чтение данных из таблиц Iceberg
  • Управление доступом
  • Правила тарификации
  • Интеграции
  • Аудитные логи Audit Trails
  • Вопросы и ответы
  • Публичные материалы
  • Обучающие курсы

В этой статье:

  • Настройка соединения
  • Модель данных
  • Формат параметров запроса
  • Параметры прореживания
  • Пример чтения метрик
  1. Источники и приемники данных
  2. Работа с Yandex Monitoring
  3. Чтение данных с помощью соединений

Чтение данных из Monitoring с помощью соединений в Query

Статья создана
Yandex Cloud
Обновлена 18 ноября 2026 г.
Открыть в Markdown
  • Настройка соединения
  • Модель данных
    • Формат параметров запроса
    • Параметры прореживания
  • Пример чтения метрик

Важно

Сервис Yandex Query будет отключен 1 декабря 2026 года и станет недоступен. Подробнее о закрытии сервиса и переходе на другие решения читайте в разделе Закрытие сервиса Yandex Query.

Эта функциональность находится на стадии Preview.

Monitoring — сервис для сбора и хранения метрик, а также их отображения на дашбордах. Данные в Monitoring содержат значения измеряемых величин — метрики — и описывающие их метки.

Например, чтобы отслеживать количество сбоев приложения, в качестве метрики можно использовать число сбоев за интервал времени. Название хоста и версия приложения при сбое являются метками. В интерфейсе Monitoring можно выполнять агрегацию метрик по меткам.

Пример чтения метрик из Monitoring:

SELECT
    *
FROM
    monitoring.ydb
WITH (
    program = @@max{method="DescribeTable"}@@,

    from = "2025-03-12T14:00:00Z",
    to = "2025-03-12T15:00:00Z"
);

Настройка соединенияНастройка соединения

Чтобы настроить чтение метрик из Monitoring:

  1. Перейдите в сервис Yandex Query.

  2. На панели слева выберите Соединения.

  3. Нажмите Создать.

  4. В открывшемся окне в поле Имя укажите название соединения с Monitoring.

  5. В поле Тип выберите Monitoring.

  6. В поле Сервисный аккаунт выберите сервисный аккаунт для чтения метрик или создайте новый и назначьте ему на облако роль monitoring.viewer.

    Чтобы использовать сервисный аккаунт, пользователю нужна роль iam.serviceAccounts.user.

  7. Нажмите Создать.

Модель данныхМодель данных

Чтение метрик из Monitoring выполняется с помощью SQL-выражения:

SELECT
    *
FROM
    <соединение>.<сервис>
WITH (
    (selectors|program) = "<запрос>",
    labels = "<метки>",
    from = "<время_от>",
    to = "<время_до>",
    <параметры прореживания>
)

Где:

  • <соединение> — название соединения с Monitoring, созданного в предыдущем пункте.
  • <сервис> — сервис Monitoring.
  • <запрос> — запрос на языке запросов Monitoring.
  • <метки> — список имен меток, значения которых нужно получить в отдельных столбцах.
  • <время_от> — левая граница искомого временного интервала в формате ISO 8601.
  • <время_до> — правая граница искомого временного интервала в формате ISO 8601.

Такой запрос вернет все точки всех метрик сервиса <сервис>, удовлетворяющих <запросу> и находящихся во временном интервале [<время_от>, <время_до>). Результат запроса будет содержать колонки:

Имя Тип данных Описание
ts Datetime Время точки метрики
value Double? Значение точки метрики, соответствующее времени в столбце ts
type String Тип метрики, содержащей точку
labels YQL Dict Метки метрики, содержащей точку. Если в запросе указан параметр labels, данный столбец будет отсутствовать
<label> String Значение метки <label> метрики, содержащей точку

Примечание

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

Примечание

Метки folderId и service в наборе селекторов можно не указывать.

Формат параметров запросаФормат параметров запроса

Имя параметра Формат Пример
selectors ["sensor_name"]{[label_name1 = "label_value1", label_name2 = "label_value2", ...]} {name = "api.grpc.request.bytes", method="DescribeTable"}
program Запрос на языке запросов Monitoring series_sum{method="DescribeTable"}
labels "label1 [as alias1], label2 [as alias2], ..." "database.dedicated as db, database_path, api_service as api"
from / to Время в формате ISO 8601 "2025-05-20T12:00:00Z"

Параметры прореживанияПараметры прореживания

В Yandex Query поддерживаются следующие параметры прореживания:

Имя параметра Описание Принимаемые значения Значение по умолчанию
downsampling.disabled В случае значения true указывает, что данные в ответе на запрос будут получены без прореживания. true, false false
downsampling.aggregation Функция агрегации, которая используется для прореживания. MAX, MIN, SUM, AVG, LAST, COUNT AVG
downsampling.fill Параметры заполнения пропусков в данных. NULL, NONE, PREVIOUS PREVIOUS
downsampling.grid_interval Ширина временного окна (сетки) в секундах, используемая для прореживания. Целое число 15

Пример чтения метрикПример чтения метрик

Пример запроса для чтения метрик из Monitoring:

SELECT
    *
FROM
    monitoring.compute
WITH (
    selectors = @@"cpu_utilization"{resource_type="vm"}@@,

    labels = "cpu_name as cpu, resource_id",

    from = "2025-03-12T14:00:00Z",
    to = "2025-03-12T15:00:00Z",

    `downsampling.aggregation` = "AVG",
    `downsampling.fill` = "PREVIOUS",
    `downsampling.grid_interval` = "15"
);

Где:

  • monitoring — название соединения с Monitoring.
  • compute — сервис, по которому проводится поиск.
  • cpu_name as cpu, resource_id — список меток, значения которых вернутся в отдельных столбцах. Значение метки cpu_name будет возвращено в столбце cpu, resource_id — в столбце resource_id.
  • [2025-03-12T14:00:00Z – 2025-03-12T15:00:00Z) — временной интервал, по которому проводится поиск.

Была ли статья полезна?

Предыдущая
Запись данных
Следующая
Запись данных
Создавайте контент и получайте гранты!Готовы написать своё руководство? Участвуйте в контент-программе и получайте гранты на работу с облачными сервисами!
Подробнее о программе
Сделано на Gravity UI
Проект Яндекса
© 2026 ООО «Яндекс.Облако»