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

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

Важно

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

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

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

Пример записи метрик из Yandex Query в Monitoring:

INSERT INTO `monitoring`.custom
SELECT
    `my_timestamp`,
    host_name,
    app_version,
    exception_count,
    "exception_monitor" AS service_type
FROM $query;

При потоковой обработке данных Yandex Query может отправлять в Monitoring результаты выполнения запроса в виде метрик и их меток.

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

Чтобы настроить отправку метрик в Monitoring:

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

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

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

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

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

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

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

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

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

Запись метрик в Monitoring выполняется с помощью SQL-выражения следующего вида:

INSERT INTO
    <соединение>.custom
SELECT
    <поля>
FROM
    <запрос>;

Где:

  • <соединение> — название соединения с Monitoring, созданного в предыдущем разделе.
  • <поля> — список полей, содержащих временную метку, метрики и их метки.
  • <запрос> — запрос-источник данных Yandex Query.

Примечание

Для записи пользовательских метрик используйте конструкцию INSERT INTO <соединение>.custom. В ней custom — зарезервированное имя в Monitoring.

Для записи метрик используется метод write API Monitoring. Передайте следующие данные:

  • временную метку;
  • список метрик с указанием их типа — Yandex Query поддерживает типы DGAUGE и IGAUGE;
  • список меток.

Yandex Query автоматически выводит семантику параметров из SQL-запроса.

Тип поля

Описание

Ограничения

Временной: Date, Datetime, Timestamp, TzDate, TzDatetime, TzTimestamp

Временная метка всех метрик

В запросе может быть только одно поле с временной меткой.

Целочисленный: Bool, Int8, Uint8, Int16, Uint16, Int32, Uint32, Int64, Uint64

Значения метрик типа IGAUGE

Название поля из SQL-выражения является именем метрики. В одном запросе может быть неограниченное число метрик.

С плавающей точкой: Float, Double

Значения метрик типа DGAUGE

Название поля из SQL-выражения является именем метрики. В одном запросе может быть неограниченное число метрик.

Текстовый: String, Utf8

Значения меток

Название поля из SQL-выражения является именем метки, а текстовое значение — значением метки. В одном запросе может быть неограниченное число меток.

Другие типы данных в полях не допускаются.

Пример записи метрикПример записи метрик

Пример запроса для записи метрик из Yandex Query в Monitoring:

INSERT INTO
    `monitoring`.custom
SELECT
    `my_timestamp`,
    host AS host_name,
    app_version,
    exception_count,
    "exception_monitor" AS service_type
FROM $query;

Где:

Поле

Тип

Описание

monitoring

Название соединения с Monitoring.

$query

Источник данных в SQL-запросе. Это может быть подзапрос YQL, в том числе подключение к источнику данных.

my_timestamp

Метка времени

Источник данных — столбец my_timestamp в потоке-источнике данных stream.

exception_count

Метрика

Источник данных — столбец exception_count в потоке-источнике данных stream.

host_name

Метка

Источник данных — столбец host в потоке-источнике данных stream.

app_version

Метка

Источник данных — столбец app_version в потоке-источнике данных stream.

Пример результата выполнения запроса в Monitoring:

Результат записи метрик в Monitoring

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

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