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