Чтобы собрать ошибки в одно место, недостаточно переслать файлы в общий поиск. Записи должны содержать имя сервиса, время события и идентификатор запроса. Сначала проведите один безопасный тестовый запрос через два компонента и убедитесь, что по одному значению можно найти обе записи. Тогда общий экран показывает цепочку, а не смесь похожих сообщений.
Идентификатор создаётся или проверяется на доверенной границе системы и передаётся дальше. Не используйте email, номер заказа или токен как request_id. Если внешний клиент прислал своё значение, ограничьте формат и длину по правилам приложения: произвольная строка не должна ломать журнал или становиться доверенным признаком пользователя.
Согласуем запись раньше выбора хранилища
Условный JSON одной строки:
{
"timestamp": "2026-10-11T00:05:00Z",
"service": "catalog-api",
"environment": "staging",
"severity": "ERROR",
"request_id": "example-request-a",
"event": "dependency_timeout",
"dependency": "inventory"
}Названия event и dependency в примере — локальный договор, не обязательные поля OpenTelemetry. Стандартная модель логов предоставляет поля времени, уровня, источника и контекста трассировки. Выберите стабильные имена для своего формата и документируйте их. Если один сервис пишет requestId, а другой request_id, поиск без преобразования не свяжет записи.
| Поле | Вопрос при поиске |
|---|---|
| service и environment | какой компонент и какое окружение |
| timestamp | когда возникло событие |
| request_id | какие записи относятся к обращению |
| trace_id и span_id при трассировке | какое действие входит в распределённую цепочку |
| event и severity | что произошло и как это классифицировано |
Граница очереди требует отдельной связи
Фоновая задача может начаться после завершения HTTP-запроса. Запишите связь исходного обращения с ID задачи, а каждый запуск задачи отличайте от предыдущей попытки. Повторная доставка не обязана означать повтор одного и того же выполнения. Без номера попытки две ошибки одной задачи легко принять за два независимых пользовательских обращения.
Request ID помогает искать записи, но сам по себе не заменяет распределённую трассировку. Trace ID связывает трассу, а Span ID обозначает её участок в модели OpenTelemetry. Если библиотека уже переносит такой контекст, используйте поддерживаемую интеграцию. Самодельная пересылка заголовков без понимания границ доверия и жизненного цикла может дать смешанные или потерянные цепочки.
Доставка тоже может сломаться
- Создать на стенде распознаваемое тестовое событие без личных данных.
- Найти его в локальном журнале и центральном поиске.
- Сравнить время события и время поступления.
- Отключить тестовый сборщик в согласованном окружении.
- Проверить буфер, повтор доставки и поведение после восстановления.
Ошибка сборщика не должна незаметно остановить полезную работу приложения. Выберите ограниченный буфер и заранее решите, что делать при его заполнении. Бесконечное накопление переносит отказ мониторинга в нехватку диска. Удаление старых записей и остановка отправки имеют разные последствия; выбранная политика должна быть видна дежурному специалисту.
Некоторые транспортные схемы повторяют отправку после неоднозначного ответа. Поэтому допускайте дубль события и храните собственный event_id, если требуется отличать повтор доставки от нового сбоя. Не дедуплицируйте только по тексту сообщения: несколько настоящих ошибок могут иметь одинаковую формулировку. Возможность и правила повтора определяются выбранным агентом, а не наличием общей панели.
Приёмка: один запрос найден целиком
Тест считается полезным, когда из записи входного сервиса можно перейти к вызову зависимости и, при наличии очереди, к нужной попытке задачи. Сверьте часовые пояса и задержку появления записи. Дополнительно ограничьте доступ и срок хранения: централизованный поиск расширяет круг мест, где доступны технические сведения, даже если тела запросов туда не отправляются.
Начните с двух сервисов и одного сценария, затем подключайте остальные по тому же договору полей. Для настройки подготовьте обезличенные строки обоих форматов, схему передачи контекста и описание отказа транспорта. По этим данным можно выбрать преобразования и проверить полноту цепочки без выгрузки всех рабочих логов.