Метки — инструмент для структурирования, фильтрации и быстрого поиска логов. Метки позволяют добавлять дополнительную информацию к каждому лог-сообщению, что упрощает работу с большими объемами данных.
Метки указываются при записи лога в массиве labels в формате "название_метки": "значение", например:
"labels": {"className": "usr","serviceVersion": "2.1"}
Требования к меткам
Значение метки может содержать символы кириллицы и латиницы, цифры, пробел и спецсимволы: !, #, %, &, ,, ., ^, *, <, >, $, @, :, _, /, -.
Максимальное количество меток в логе — 20.
Максимальное количество символов для пары "название_метки": "значение" — 63.
Просмотр меток лога
Посмотреть, какие метки используются в логе, можно несколькими способами:
В списке логов. По умолчанию метки не отображаются в таблице, но их можно добавить в виде отдельных столбцов. Для этого нажмите
и отметьте, какие метки нужно отобразить в таблице.
Название метки будет названием столбца, а значение метки — значением в строке.
Если у лога нет выбранной метки, в строке будет пусто.В JSON-сообщении лога. Метки лога перечислены в массиве labels.
Поиск и фильтрация по меткам
Метки можно использовать для фильтрации списка логов. Чтобы найти логи с определенной меткой, укажите ее в поле Запрос в формате labels.<название_метки>="значение".
Пример фильтрации по меткам, которые содержат название источника, отправившего сообщение, и название класса:
labels.source = "backend" AND labels.class_name = "usr"
Подробнее о фильтрующих выражениях читайте в статье Язык фильтрующих выражений сервиса Клиентского логирования.
Статистика меток
По меткам, присвоенным логам в лог-группе, можно посмотреть статистику использования. В статистику попадают все метки лог-группы. Для каждой метки можно посмотреть до пяти самых часто встречающихся значений.
Подробнее о статистике меток читайте в статье Посмотреть статистику меток.