К содержанию
CheckcraftСкачать
Практический сценарий

Поиск по логам по traceId онлайн: найти все строки запроса и ошибки

Checkcraft — программа для проверки API и логов без кода, есть бесплатная версия. Скачать без регистрации →

Вставьте фрагмент лога — инструмент соберёт строки по traceId, покажет ошибки и предупреждения и подскажет, какой запрос сломался. Понимает обычные строки и JSON-логи (поля level, message, trace.id), формат traceparent и поля traceId, X-Request-ID. Лог не уходит на сервер.

Checkcraft ·

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

Как пользоваться

Вставьте строки лога в поле выше. Если traceId известен — например, он пришёл в ответе API или в заголовке, — впишите его и нажмите «Найти»: останутся только строки этого запроса, ошибки отмечены первыми. Если traceId не знаете, оставьте поле пустым: инструмент сам найдёт все идентификаторы в тексте и покажет сначала запросы, в которых есть ошибки. Кнопка «Вставить пример» показывает типичный случай: заказ создан с ответом 201, а платёж упал с ошибкой суммы.

Какие форматы понимает

Текстовые строки с уровнем ERROR, WARN, INFO и словами Exception или Traceback. JSON-строки: уровень берётся из полей level, log.level или severity, текст — из message или msg. Идентификаторы: заголовок traceparent по стандарту W3C (32 шестнадцатеричных символа trace-id), поля traceId, trace_id, trace.id из Elastic Common Schema, X-Request-ID и correlationId. Если в логах сервиса другое имя поля, просто впишите сам идентификатор — поиск идёт по подстроке.

То же в консоли и в Kibana

На сервере то же самое делают grep и jq. В Kibana Discover — один фильтр KQL по полю с traceId, к нему можно добавить уровень.

# все строки одного запроса во всех файлах
grep -rh "4bf92f3577b34da6a3ce929d0e0e4736" /var/log/app/ | sort

# только ошибки этого запроса
grep -rh "4bf92f3577b34da6a3ce929d0e0e4736" /var/log/app/ | grep -E "ERROR|Exception"

# JSON-логи: jq по полю trace.id
jq -c 'select(.["trace.id"] == "4bf92f3577b34da6a3ce929d0e0e4736")' app.json.log

# Kibana Discover, KQL
trace.id : "4bf92f3577b34da6a3ce929d0e0e4736" and log.level : ("ERROR" or "WARN")

Когда ответ 200, а в логах ошибка

Самая коварная ситуация: API ответил 200 или 201, тест зелёный, а через полсекунды соседний сервис записал ERROR — платёж не прошёл, сообщение не отправилось, заказ завис в статусе NEW. По ответу этого не видно, поэтому после важных запросов стоит смотреть логи по traceId. Если делать это руками после каждого прогона, проверка быстро превращается в рутину, которую пропускают.

Проверять логи автоматически

В Checkcraft лог — часть проверки: программа берёт traceId из ответа или заголовка, находит записи в Kibana или Elasticsearch и проверяет в них поля так же, как в ответе API, например что нет ERROR и сумма совпадает. Связь ответов с логами по traceId есть в бесплатной версии без ограничений, источник подключается через Kibana Proxy или напрямую к Elasticsearch. Без регистрации, Windows и Linux.

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

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

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

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

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

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

W3C Trace Context: заголовок traceparent · Elastic ECS: поля трассировки · Elastic ECS: поля log.*

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

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

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

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

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

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

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