Журналы и метрики для интеграции RouteDesk
Версия 2.7
Корреляция операций
Для исходящего вызова храните локальный идентификатор работы, среду, время, этап операции, итог и номер отправления при наличии. Для входящего webhook добавьте event_id и время приёма. Свяжите журнал сетевого запроса с записью очереди и обновлением заказа. Тогда оператор сможет восстановить путь даже при перезапуске исполнителя.
Измерение задержки
Измеряйте отдельно время запроса, возраст задачи в очереди и задержку от принятого webhook до изменения заказа. Один общий показатель скрывает узкое место. Быстрый HTTP-ответ при растущей очереди может означать, что приложение принимает события быстрее, чем обрабатывает. В такой ситуации сравните состояние потребителей и время их последнего успешного изменения.
Частота ошибок и повторов
Следите за долей HTTP 429, ошибками проверки подписи, повторными входящими event_id и долей заказов с неизвестным итогом создания. Группируйте по среде, операции и экземпляру клиента. Всплеск HOOK-401 только на одной реплике указывает, где проверять секрет, исходное тело запроса и системное время. Рост повторов без увеличения заказов стоит сопоставить с сетевыми тайм-аутами.
Содержимое диагностической записи
Журнал должен помочь найти конкретную попытку без доступа к полному телу HTTP-запроса. Для события обычно достаточно event_id, кода ответа и часового пояса. Не записывайте Authorization, секрет webhook, полную подпись, одноразовые коды и данные получателя. Если нужна расширенная проверка парсера, используйте обезличенный пример в тестовой среде.
Как использовать графики при сбое
Отметьте время первой ошибки и последнее успешное действие. Проверьте, совпал ли сбой с ротацией ключа, сменой URL, выпуском приложения или ростом партии. Затем сопоставьте один отказ с конкретным запросом и одним подтверждённым эффектом. График помогает сузить поиск. Итог отдельной операции подтверждают журнал запроса, кабинет и состояние локальной записи.
Передача смене по наблюдаемым признакам
Укажите, какой участок цепочки уже проверен и какой остаётся подтвердить. Например, журнал отправителя видит доставку, входящий журнал содержит событие, а журнал обновления заказа пуст. В таком случае следующая смена начнёт с потребителя очереди. Для длинного разбора сохраняйте ссылку на конкретный диапазон времени и на локальный идентификатор работы.
Проверка качества самих журналов
Отправьте тестовый запрос и убедитесь, что трасса соединяет все ожидаемые этапы. Отключите один обработчик и посмотрите, какое отсутствие записи видит дежурный. Проверьте маскирование заранее известных синтетических секретов и адресов. Полезный журнал показывает факт отказа и путь восстановления, сохраняя поля, которые можно передать в поддержку без ручного удаления приватных данных.