Пустой лог приложения не доказывает, что отправитель не прислал 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 — до проверяемого результата. Между действием и отметкой возможен сбой, поэтому отсутствие строки не всегда означает отсутствие действия. Для внешнего эффекта нужен отдельный способ сверки по его идентичности. Журнал помогает найти неопределённость, но не устраняет её обещанием «всё ровно один раз».

Сохраните время в согласованной зоне и различайте время события у источника, время поступления и время обработки. Без этого задержка очереди выглядит как поздняя отправка провайдера. Длительность внутри одного процесса по возможности измеряйте подходящим монотонным таймером; несовпадающие часы разных узлов не дают точную длительность простым вычитанием.

Отладка тоже проходит отрицательный тест

  1. Доставить синтетическое событие с известной связью.
  2. Отклонить отдельную тестовую попытку проверкой отправителя.
  3. Смоделировать отказ сохранения в изолированной среде.
  4. Остановить тестовый worker после принятия задания.
  5. Проверить, что недоступность журнала сама обнаруживается и не выдаётся за отсутствие webhook.

Для каждого теста заранее запишите ожидаемую последнюю стадию и доступное доказательство. Затем сравните фактическую цепочку, включая пропуски. Если система использует выборочное логирование, аварийные переходы не должны исчезать по той же случайной выборке, что обычная телеметрия. Политика отказа журнала определяется требованиями приложения: диагностическая запись и обязательный аудит могут иметь разные последствия для приёма события.

Ограничьте значения причин и длину полей, чтобы непроверенный ввод не ломал формат записей. Секреты и рабочие подписи остаются вне общего журнала, доступ к нему разделяется по назначению. Для первого расследования подготовьте безопасные event_ref и attempt_ref, временной диапазон и последнюю подтверждённую стадию. Этого достаточно, чтобы назначить следующий точный поиск без пересылки чужих данных.

Проверенные источники