Query Trace Logs
Обзор функции
Trace Logs позволяют пользователям выполнять запросы и анализировать логи, связанные с конкретным распределённым трассировочным запросом, используя его уникальный TraceID. Эта функция помогает разработчикам и операторам быстро находить проблемы, понимать потоки запросов и связывать бизнес-логи с контекстами трассировки.
Основные преимущества:
- Анализ первопричин: выявление ошибок и проблем с задержками в микросервисах распределённых систем.
- Корреляция контекста: связывание бизнес-логов с трассировочными спанами для полного обзора.
- Эффективная фильтрация: фильтрация логов по Pod или TraceID для фокусировки на релевантных данных.
Основные возможности
- Запрос по TraceID: получение всех логов, связанных с конкретной трассировкой по её TraceID.
- Фильтрация по Pod: просмотр логов из конкретных Pod, участвующих в трассировке.
- Исключение логов Sidecar: фильтрация инфраструктурных логов для фокусировки на бизнес-данных.
- Экспорт логов: экспорт отфильтрованных логов в настраиваемых форматах.
- Просмотр контекста логов: изучение записей логов до и после целевой записи для более глубокого анализа.
Требования
Перед выполнением запросов логов по TraceID необходимо сначала инструментировать ваши сервисы для включения TraceID в бизнес-логи. Следуйте руководству Business Log Correlation with TraceID Guide для настройки.
Поведение по умолчанию:
- Отображает логи за весь период трассировки.
- Для трассировок короче 1 минуты выполняет запрос логов в течение 1 минуты после времени начала трассировки.
Операции с запросами логов
Доступ к логам трассировки
- После выполнения запроса трассировок кликните по конкретной трассировке для просмотра её деталей.
- Перейдите на вкладку View Log в панели визуализации трассировки.
Фильтрация логов
По имени Pod
В селекторе Pod Name выберите целевой Pod из списка участвующих сервисов.
По диапазону времени
В селекторе Time Range выберите нужный временной интервал.
По условиям запроса
Введите ключевые слова в поле Query Conditions для фильтрации логов по конкретному содержимому.
Содержит Trace ID
Отметьте чекбокс Contain Trace ID.
Скрыть логи Sidecar
Отметьте Hide Sidecar Logs для исключения инфраструктурных записей.
Расширенные операции
Экспорт логов
- Нажмите Export.
- Выберите поля для включения с помощью чекбоксов столбцов.
- Выберите формат экспорта (JSON/CSV).
Настройка отображаемых полей
Нажмите Set. Переключайте видимость полей логов в панели отображения.
Просмотр контекста логов
- Нажмите Insight рядом с любой записью лога.
- Просмотрите 5 предыдущих и 5 последующих логов вокруг целевой временной метки.
- Прокручивайте вверх/вниз мышью для загрузки дополнительных логов.