Пустой лог приложения не доказывает, что отправитель не прислал webhook. Запрос мог остановиться перед приложением, а запись могла потеряться в самом механизме логирования. Начните с одного искусственного события и проследите четыре границы: HTTP-вход, проверка, устойчивое сохранение и завершение фоновой обработки.
Для каждой попытки нужен собственный идентификатор, а для повторов одного события — общая связь с событием источника. Тогда расследование отвечает на вопрос «какая стадия не завершилась», а не сводится к поиску одинаковых строк JSON. Полные тела запросов для этого не нужны.
Отсутствующая отметка задаёт следующий вопрос
| Последнее доказательство | Где искать дальше | Чего оно не доказывает |
|---|---|---|
| Отправитель начал доставку | Публичный вход и транспортный исход | Что приложение приняло запрос |
| HTTP-вход увидел попытку | Маршрут и проверка отправителя | Что подпись допустима |
| Проверка успешна | Устойчивое сохранение и постановка задачи | Что бизнес-действие выполнено |
| Задание принято | Worker и результат эффекта | Что пользователь увидел изменение |
OWASP рекомендует связывать относящиеся к одному взаимодействию события идентификатором и фиксировать результат действия. Документация проверена 16 октября 2026 года. Для webhook полезно дополнить эту общую рекомендацию двумя уровнями: event_ref объединяет логическое событие, attempt_ref отличает конкретное поступление или запуск. Названия полей здесь условные.
Стадия записывается там, где она действительно произошла
Условные безопасные отметки:
attempt_A | entry_seen
attempt_A | verification_passed
attempt_A | inbox_committed | event_X
attempt_A | response_sent | 2xx
run_B | processing_started | event_X
run_B | effect_confirmed | result_ref
run_B | processing_finishedНе записывайте inbox_committed до подтверждения сохранения, а effect_confirmed — до проверяемого результата. Между действием и отметкой возможен сбой, поэтому отсутствие строки не всегда означает отсутствие действия. Для внешнего эффекта нужен отдельный способ сверки по его идентичности. Журнал помогает найти неопределённость, но не устраняет её обещанием «всё ровно один раз».
Сохраните время в согласованной зоне и различайте время события у источника, время поступления и время обработки. Без этого задержка очереди выглядит как поздняя отправка провайдера. Длительность внутри одного процесса по возможности измеряйте подходящим монотонным таймером; несовпадающие часы разных узлов не дают точную длительность простым вычитанием.
Отладка тоже проходит отрицательный тест
- Доставить синтетическое событие с известной связью.
- Отклонить отдельную тестовую попытку проверкой отправителя.
- Смоделировать отказ сохранения в изолированной среде.
- Остановить тестовый worker после принятия задания.
- Проверить, что недоступность журнала сама обнаруживается и не выдаётся за отсутствие webhook.
Для каждого теста заранее запишите ожидаемую последнюю стадию и доступное доказательство. Затем сравните фактическую цепочку, включая пропуски. Если система использует выборочное логирование, аварийные переходы не должны исчезать по той же случайной выборке, что обычная телеметрия. Политика отказа журнала определяется требованиями приложения: диагностическая запись и обязательный аудит могут иметь разные последствия для приёма события.
Ограничьте значения причин и длину полей, чтобы непроверенный ввод не ломал формат записей. Секреты и рабочие подписи остаются вне общего журнала, доступ к нему разделяется по назначению. Для первого расследования подготовьте безопасные event_ref и attempt_ref, временной диапазон и последнюю подтверждённую стадию. Этого достаточно, чтобы назначить следующий точный поиск без пересылки чужих данных.