Query Trace Logs

Содержание

Обзор функции

Trace Logs позволяют пользователям выполнять запросы и анализировать логи, связанные с конкретным распределённым трейсом, используя его уникальный TraceID. Эта функция помогает разработчикам и операторам быстро находить проблемы, понимать потоки запросов и связывать бизнес-логи с контекстами трейсинга.

Основные преимущества:

  • Анализ первопричин: выявление ошибок и проблем с задержками в микросервисах распределённых систем.
  • Корреляция контекста: связывание бизнес-логов с трассировочными спанами для сквозной видимости.
  • Эффективная фильтрация: фильтрация логов по Pod или TraceID для фокусировки на релевантных данных.

Применимые сценарии:

  • Отладка сбоев транзакций между сервисами.
  • Анализ узких мест производительности в сложных рабочих процессах.
  • Аудит потоков обработки запросов для соответствия требованиям.

Основные возможности

  • Запрос по TraceID: получение всех логов, связанных с конкретным трейсом по его TraceID.
  • Фильтрация по Pod: просмотр логов из конкретных Pod, участвующих в трейсинге.
  • Экспорт логов: экспорт отфильтрованных данных в настраиваемых форматах.
  • Контекстный просмотр логов: изучение записей логов до и после целевой записи для более глубокого анализа.

Требования

TIP

Перед выполнением запросов логов по TraceID необходимо сначала настроить ваши сервисы на включение TraceID в бизнес-логи. Следуйте руководству Business Log Correlation with TraceID Guide для деталей настройки.

Поведение по умолчанию:

  • Отображает логи за весь период трейсинга.
  • Для трейсинга короче 1 минуты запрашивает логи в течение 1 минуты после времени начала трейсинга.

Операции с запросами логов

Доступ к логам трейсинга

  1. После выполнения запроса трейсинга кликните по конкретному трейсу для просмотра его деталей.
  2. Перейдите на вкладку View Log в панели визуализации трейсинга.

Фильтрация логов

По имени Pod

В селекторе Pod Name выберите целевой Pod из списка участвующих сервисов.

По временному диапазону

В селекторе Time Range выберите нужный временной интервал.

По условиям запроса

Введите ключевые слова в текстовое поле Query Conditions для фильтрации логов по конкретному содержимому.

Содержит Trace ID

Установите флажок Contain Trace ID.

Расширенные операции

Экспорт логов

  1. Нажмите Export.
  2. Выберите поля для включения с помощью чекбоксов столбцов.
  3. Выберите формат экспорта (JSON/CSV).

Настройка отображаемых полей

Нажмите Set. Переключайте видимость полей логов в панели отображения.

Просмотр контекста лога

  1. Нажмите Insight рядом с любой записью лога.
  2. Изучите 5 предыдущих и 5 последующих логов относительно целевой временной метки.
  3. Прокручивайте вверх/вниз мышью для загрузки дополнительных логов.