К содержанию
Checkcraft
Практика в Checkcraft

Как найти все логи операции в Kibana по traceId

Поможем с первой проверкой →

В журнале тысячи строк, а вам нужна одна операция. Поиск по тексту ошибки легко смешивает соседние запросы. Идентификатор трассировки помогает собрать связанный набор записей.

Подготовлено командой Checkcraft · Обновлено

Что получится

В учебном стенде фильтр по traceId показывает цепочку одной операции. Затем из неё можно выделить конкретное событие и сохранить проверку в Checkcraft.

Настоящая Kibana локального учебного стенда. Записи относятся к одной трассировке.
Настоящая Kibana локального учебного стенда. Записи относятся к одной трассировке. Полный размер ↗

Взять идентификатор из ответа

Сначала отправьте запрос и скопируйте traceId из ответа или заголовка вашей системы. В нашем примере имя поля traceId. В Elastic Common Schema стандартное имя trace.id. Используйте имя из ваших данных, а не автоматически подставленный вариант.

Настроить область поиска

В Discover выберите data view нужного индекса и интервал, в который попало выполнение запроса. Если результат пустой, расширьте интервал, проверьте часовой пояс и наличие свежих событий. Идентификатор без правильного индекса и времени не гарантирует результат.

Отфильтровать одну трассировку

Для поля traceId пример KQL выглядит так. Замените учебное значение идентификатором своего запроса. Если поле называется trace.id, поменяйте и левую часть. Поиск по .keyword зависит от mapping вашего индекса и нужен не во всех конфигурациях.

traceId : "YOUR_TRACE_ID"

Найти нужный этап операции

Если по одному идентификатору найдено много записей, добавьте фильтр module или phase из своего формата логов. Раскройте документ и проверьте фактические поля, тело сообщения и время. Нельзя делать вывод о всей операции по одной строке ERROR без её контекста.

Раскрытая запись в Kibana. Путь для проверки нужно брать из фактической структуры документа.
Раскрытая запись в Kibana. Путь для проверки нужно брать из фактической структуры документа. Полный размер ↗

Сохранить найденную проверку

Когда ручной поиск дал нужное событие, перенесите условия в источник логов и тест-кейс Checkcraft. Повторный Log-прогон позволит проверить следующую операцию по её идентификатору. Учебное правило ниже знакомит с проверкой поля до подключения Kibana.

Имена стандартных полей трассировки приведены в справочнике Elastic Common Schema.

Повторить на готовых данных

Здесь лежит учебный тест-кейс для Checkcraft, правильный JSON и вариант с намеренной ошибкой. Файлы доступны без регистрации. Это данные для упражнения, а не доступ к чужому API.

Если приложение уже открыто

Создайте коллекцию, конструктор проверки и тест-кейс через контекстное меню дерева. В редакторе нажмите «Импорт» и выберите файл тест-кейса. Откройте добавленный тест. Скопируйте содержимое правильного JSON и нажмите «Вставить данные для анализа». Затем «Запустить тест-кейс» и вкладку «Результат».

Повторите те же действия с испорченным JSON, сохранив правила. В первом запуске ожидается успешная проверка, во втором ошибка. Если результат отличается, сравните импортированный тест, источник данных и текст отчёта.

Сверить с полученными при подготовке страницы отчётами можно по файлам успешного прогона и прогона с ошибкой. Примеры проверены 14 сентября 2026 года на текущем исходном коде приложения.

Если непонятно, какой фильтр задать в Kibana

В руководстве по Discover и KQL показаны фильтр двух сервисов, поиск по trace.id и проверка наличия поля. Начните с времени и источника, затем добавляйте условия. Пустая выдача не всегда означает отсутствие операции.

От примера к своей проверке

Посмотреть, как это работает на ваших данных

Можно начать с учебного файла на этой странице, увидеть найденную ошибку и затем заменить данные своим обезличенным примером. Для Windows и Linux доступна Free без ограничения срока.

Получить FreeКак получить и запустить приложение

Для получения сборки нужен аккаунт и подтверждение email. Состав бесплатной версии опубликован на странице тарифов.

Можно спросить человека

Поможем с первой проверкой

Расскажите, что хотите проверить или на каком шаге остановились. Поможем запустить Checkcraft, подобрать пример и разобраться с первым прогоном. Можно написать до скачивания.

Telegram-группа открытая: не публикуйте пароли, токены и конфиденциальные рабочие данные. Для первого вопроса достаточно описания задачи.

Можно написать напрямую support@checkcraft.ru

Без регистрации. Ответим по email. Это обращение в поддержку, а не подписка на рассылку.