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

В AWS Lambda доставка журналов в CloudWatch Logs зависит от разрешений роли выполнения. Документация AWS перечисляет logs:CreateLogGroup, logs:CreateLogStream и logs:PutLogEvents; источник проверен 21 октября 2026 года. Исправляйте доступ к нужным ресурсам по принятой политике, не выдавая функции административные права ради диагностики.

Нет журнала и нет объяснения — разные поломки

СимптомПроверка
Вызов подтверждён, записей не видноРегион, группа логов, время и разрешения доставки
Есть начало и конец, этап неизвестенСобытия границ внутри handler
Ошибка видна, задача не определяетсяСвязь task_id и идентификаторов попытки
Сообщения двух задач смешалисьКонтекст корреляции в каждой записи
Журнал обрываетсяПоследний подтверждённый этап и системный исход вызова

Идентификатор вызова платформы описывает попытку, а бизнес-задача может пережить несколько попыток и функций. Храните оба уровня связи. Входящий correlation ID нельзя без проверки использовать как доверенный признак пользователя или разрешения. Для поиска годится непрозрачный безопасный идентификатор, который не раскрывает адрес почты и содержимое документа.

Событие должно отвечать на конкретный вопрос

Условная запись, не системный формат AWS:
{task_id: demo-task, attempt: 2, stage: parse,
 event: failed, error_code: INVALID_INPUT,
 function_revision: demo-v2, elapsed_ms: measured}
отдельно: start / completed для значимых этапов
не включать: токены, тела документов, заголовки авторизации

Время выполнения берётся из измерения, а код ошибки — из ограниченного словаря приложения. Сообщение «что-то пошло не так» не позволяет выбрать следующий шаг. При этом полный текст исключения тоже может раскрывать секреты в URL или параметрах. Санитизация нужна до отправки события в общий журнал; последующее скрытие в интерфейсе не удаляет уже сохранённые данные.

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

Приёмка — восстановить путь без догадок

  • По ID задачи находятся все связанные попытки.
  • Видны версия функции и последний завершённый этап.
  • Временный отказ зависимости отличается от неверного входа.
  • Повтор не выглядит как вторая новая бизнес-задача.
  • В сохранённых событиях отсутствуют секреты и пользовательский текст.

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

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

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