Query Trace Logs
Содержание
Feature Overview
Trace Logs позволяют пользователям выполнять запросы и анализировать логи, связанные с конкретным распределённым трассировочным идентификатором TraceID. Эта функция помогает разработчикам и операторам быстро находить проблемы, понимать потоки запросов и связывать бизнес-логи с контекстами трассировки.
Основные преимущества:
- Анализ первопричин: выявление ошибок и проблем с задержками в микросервисах распределённых систем.
- Корреляция контекста: связывание бизнес-логов с трассировочными спанами для сквозной видимости.
- Эффективная фильтрация: фильтрация логов по Pod или TraceID для фокусировки на релевантных данных.
Core Features
- TraceID-Based Query: получение всех логов, связанных с конкретной трассировкой по её TraceID.
- Pod-Centric Filtering: просмотр логов из конкретных Pod, участвующих в трассировке.
- Sidecar Log Exclusion: исключение инфраструктурных логов для фокусировки на бизнес-данных.
- Log Export: экспорт отфильтрованных логов в настраиваемых форматах.
- Contextual Log Viewing: просмотр записей логов до и после целевой записи для более глубокого анализа.
Prerequisites
Перед выполнением запросов логов по TraceID необходимо инструментировать ваши сервисы для включения TraceID в бизнес-логи. Следуйте руководству Business Log Correlation with TraceID Guide для настройки.
Поведение по умолчанию:
- Отображаются логи за весь период трассировки.
- Для трассировок короче 1 минуты выполняется запрос логов в течение 1 минуты после времени начала трассировки.
Log Query Operations
Access Trace Logs
- После выполнения запроса трассировок нажмите на конкретную трассировку для просмотра её деталей.
- Перейдите на вкладку View Log в панели визуализации трассировки.
Filter Logs
By Pod Name
В селекторе Pod Name выберите целевой Pod из списка участвующих сервисов.
By Time Range
В селекторе Time Range выберите нужный временной диапазон.
By Query Conditions
Введите ключевые слова в текстовое поле Query Conditions для фильтрации логов по конкретному содержимому.
Contain Trace ID
Отметьте чекбокс Contain Trace ID.
Hide Sidecar Logs
Установите флажок Hide Sidecar Logs для исключения записей, связанных с инфраструктурой.
Advanced Operations
Export Logs
- Нажмите Export.
- Выберите поля для включения с помощью чекбоксов столбцов.
- Выберите формат экспорта (JSON/CSV).
Customize Display Fields
Нажмите Set. Переключайте видимость полей логов в панели отображения.
View Log Context
- Нажмите Insight рядом с любой записью лога.
- Просмотрите 5 предыдущих и 5 последующих логов вокруг целевой временной метки.
- Прокручивайте вверх/вниз мышью для загрузки дополнительных логов.