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

Monitoring - это сервис, позволяющий собирать и хранить метрики, а также отображать их в виде графиков на дашбордах. Отправляемые в Monitoring данные представляют из себя значения измеряемых величин (метрики) и метки (labels), их описывающие.

Например, чтобы следить за количеством сбоев приложения, в качестве метрики можно использовать число сбоев за интервал времени. Данные, описывающие это падение: название хоста, версия приложения - являются метками. В интерфейсе 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. В открывшемся окне в поле Имя указать название соединения с Monitoring.

3. В выпадающем поле Тип выбрать Monitoring.

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

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

5. Создать соединение, нажав кнопку Создать.

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

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

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

Где:

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

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

• временную метку;
• список метрик с указанием их типа. 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.