Модель данных в Monitoring
Данные в сервисе Yandex Monitoring хранятся в виде временных рядов
Метрики
Метрика — это временной ряд, который показывает изменение какой-либо величины во времени. Например, состояние ресурса одного из сервисов Yandex Cloud: количество занятого места на диске, скорость передачи данных по сети и т. д.
Для идентификации метрик используются текстовые метки.
Метки
Метка — характеристика метрики в формате ключ: "значение"
. Каждая метрика идентифицируется неупорядоченным набором меток. Обычно в качестве метки используется параметр, который принимает ограниченное множество значений. Например, код состояния HTTP, тип выполняющихся процедур в базе данных и т. д.
Метки бывают обязательные и дополнительные. Список обязательных меток:
cloudId
— идентификатор облака, в котором находится ресурс.folderId
— идентификатор каталога, в котором находится ресурс.service
— указывает на сервис Yandex Cloud, которому принадлежит ресурс. Например,compute
илиmanaged-postgresql
.
Важно
При загрузке пользовательских метрик необходимо записать значение custom
в метку service
.
Ограничения на метки и их значения
Для меток и их значений действуют следующие ограничения:
- метрика может иметь не более 16 меток, включая обязательные метки
cloudId
,folderId
,service
; - имя метки не может быть пустым;
- имя метки не должно состоять из символа
-
; - длина имени — не больше 32 символов;
- начинаться имя должно с буквы (регистр не важен), далее в имени могут быть буквы, цифры, символы
.
и_
; - в именах меток и значениях метрик не допускается использовать алфавит, отличный от латинского.
Типы метрик
В сервисе Yandex Monitoring есть следующие типы метрик:
Тип | Описание |
---|---|
DGAUGE |
Числовой показатель (дробное число). Показывает значение метрики в определенный момент времени. Например, количество занятой оперативной памяти |
IGAUGE |
Числовой показатель (целое число). Показывает значение метрики в определенный момент времени. |
COUNTER |
Счетчик. Показывает значение метрики, которое растет со временем. Например, количество дней непрерывной работы сервиса. |
RATE |
Производная. Показывает изменение значения метрики во времени. Например, количество запросов в секунду |
Запросы
Запрос — произвольное выражение на языке запросов, результатом которого является линия или набор линий. В тексте запроса можно ссылаться на результаты вышестоящих запросов как на переменные.
Monitoring позволяет строить запросы для выборки набора метрик и отображения их на графике. В качестве значений меток могут использоваться шаблоны.
В сервисе Monitoring доступны следующие шаблоны:
Синтаксис | Описание |
---|---|
label="*" |
Выводит все метрики с указанной меткой. Например, запрос host="*" выведет все метрики, у которых есть метка host . |
label="glob" |
Выводит все метрики, значение метки которого удовлетворяет glob-выражению* — любое количество символов (в том числе отсутствие). Например, name="folder*" выведет все метрики, у которых значение метки name начинается с префикса folder .? — один произвольный символ. Например, name="metric?" выведет все метки, у которых есть в значении есть один символ после metric ` |