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 последующих логов вокруг целевой временной метки.
- Прокручивайте вверх/вниз мышью для загрузки дополнительных логов.