Запись метрик в Monitoring

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.

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

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

Yandex Query автоматически выводит семантику параметров из 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: