Практический сценарий

traceId: что это и как найти запрос в логах

traceId — общий номер для всех записей одного запроса во всех сервисах. Зная его, за минуту находишь в логах, что происходило между запросом и ответом.

Checkcraft · 7 ноября 2026

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

Что такое traceId

Когда запрос проходит через несколько сервисов, каждый пишет свои логи. traceId создаётся на входе, в шлюзе или первом сервисе, и передаётся дальше в заголовках, поэтому все записи одной операции получают одинаковый номер. Стандарт W3C Trace Context передаёт его в заголовке traceparent: версия, 32 шестнадцатеричных символа traceId, 16 символов идентификатора шага и флаги. Встречаются и другие заголовки: X-B3-TraceId у Zipkin, X-Request-ID и X-Correlation-ID в собственных системах.

traceparent: 00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01

Где его взять

Посмотрите заголовки ответа: многие сервисы возвращают traceId или X-Request-ID. Часто он есть в теле ошибки. Если сервис его не отдаёт, попросите разработчиков добавить: это небольшая доработка, которая экономит часы при разборе. Некоторые системы принимают X-Request-ID от клиента, тогда номер можно задать самому.

Как искать в Kibana

Откройте Discover, выберите интервал времени вокруг запроса и введите запрос KQL по полю с идентификатором. В схеме Elastic Common Schema оно называется trace.id, в других системах — traceId или trace_id. Результат — все записи операции по всем сервисам, по порядку.

trace.id : "4bf92f3577b34da6a3ce929d0e0e4736"

Зачем тестировщику

Ответ 200 ещё не значит, что всё прошло правильно: в логах бывают повторные попытки, ошибки фоновых шагов и не те суммы. Checkcraft берёт traceId из ответа, сам находит записи в Kibana и проверяет их теми же правилами, что и ответ API, а результат показывает в одном отчёте.

Следующий шаг

Повторите это на своём API

Checkcraft — настольная программа: сохраняет проверки ответа API без кода и показывает, что не совпало. Начните с учебного примера, затем подставьте свои обезличенные данные. Free работает на Windows и Linux без ограничения срока.

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

Скачивание без регистрации и почты, архив готов за пару минут. Состав бесплатной версии опубликован на странице тарифов.

Документация

W3C Trace Context · Elastic ECS: поля трассировки

Начните с примера по ссылкам и сопоставьте результат с требованием своей проверки.