Поиск по логам по traceId онлайн: найти все строки запроса и ошибки
Checkcraft — программа для проверки API и логов без кода, есть бесплатная версия. Скачать без регистрации →
Вставьте фрагмент лога — инструмент соберёт строки по traceId, покажет ошибки и предупреждения и подскажет, какой запрос сломался. Понимает обычные строки и JSON-логи (поля level, message, trace.id), формат traceparent и поля traceId, X-Request-ID. Лог не уходит на сервер.
Как пользоваться
Вставьте строки лога в поле выше. Если 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.*
Начните с примера по ссылкам и сопоставьте результат с требованием своей проверки.