Разбор · Опубликовали 08.10.2026
Логирование записывает ход операции: агенты добавляют события, по которым можно восстановить путь
Как найти одну заявку среди записей приложения, отличить повтор от нового действия и принять логирование, которое добавили ИИ-агенты.
Материал собран машиной агентов под надзором Евгения Шилова · факты проверены 8 октября 2026
Логирование помогает восстановить путь заявки, если записи связаны общим номером операции. Сообщение «всё обработано» оставляет этот путь неизвестным.
Агенты добавляют записи, а инженер принимает восстановленный путь. Наш опыт относится к машине vibecoding.ru, клиентского кейса такого журнала у нас нет.
Не хотите разбираться сами? Внедряем ИИ в ваш бизнес: задачи без лимита, одна цена в месяц, отмена в любой момент.
1. Журнал полезен, когда по нему восстанавливают одну заявку.
Что произошло с конкретной заявкой? ИТ-директору нужен ответ от приёма до результата, включая место, где обработка остановилась.
Логирование записывает события во время работы программы. Структурированная запись хранит отдельными полями время, действие и результат, чтобы их можно было найти вместе.
Наша открытая машина разработки показывает изменения кода и отбор материалов. Git-лог объясняет, что изменили разработчики. Путь заявки записывает само приложение.
Что и как мы проверяли
| Факт | Что известно | Проверено |
|---|---|---|
| Первоисточники | Прочитаны публичные OWASP Logging Cheat Sheet, OpenTelemetry Logs Data Model, документация передачи контекста и W3C Trace Context. Их требования применены к задаче из брифа; таблицы приёмки составлены редакцией | 2026-10-08 |
| Наш опыт | Перечитаны записи машины vibecoding.ru за 13, 15 и 22 июля 2026. Это утечка в непубличный вывод, ложный сигнал из текста агента и пропуск запуска из-за замка. Клиентского кейса сквозного журнала заявки у нас нет | 2026-10-08 |
| Учебная заявка | А-17, названия событий и номера попыток придуманы для объяснения. Это не выгрузка клиента и не замер внедрения. Поведение при повторе требует отдельной защиты от повторного действия | 2026-10-08 |
| Цена подписки | Тариф «Один проект» — 250 000 ₽ в месяц на живой /services, проверено чтением публичной страницы 8 октября 2026 МСК. Цена относится к подписке, не к отдельной задаче логирования | 2026-10-08 |
2. Связь событий сохраняют через очередь и повтор.
Как найти продолжение заявки в другой части приложения? Общий номер операции передают вместе с заданием, в том числе через очередь фоновой обработки.
Номер HTTP-запроса может закончиться раньше работы с заявкой. Бизнес-операция продолжается, поэтому её номер сохраняют и при новом запросе, и при повторной попытке.
В учебном примере А-17 сохранена, но подтверждение уведомления не пришло. При повторе приложение проверяет прежний результат и не создаёт второе уведомление.
Повтор продолжает ту же операцию, а таймаут оставляет исход неизвестным
Учебный сценарий редакции, 08.10.2026. Это требование к поведению приложения, а не гарантия логирования. Связь событий: OWASP и OpenTelemetry.
Повтор получает свой номер попытки внутри шага. Общий номер заявки остаётся прежним, иначе поиск покажет две несвязанные истории.
Время получения строки не равно времени события. OpenTelemetry различает эти времена. Связь шагов нужна ещё и потому, что записи могут прийти в другом порядке.
Контекст трассы связывает технические вызовы между сервисами. Если в проекте уже есть OpenTelemetry, его идентификаторы сохраняют рядом с номером операции.
Согласованные поля позволяют найти путь, повтор и результат
Состав полей предложен редакцией, 08.10.2026, на основе OWASP Event attributes и OpenTelemetry Logs Data Model. Это пример для согласования, не универсальный стандарт.
3. Агент добавляет записи в код, а инженер определяет их смысл.
Что поручить агенту? Сначала инженер описывает путь заявки и границы результата. Из этого получается задача для агента с проверяемым «готово».
Агент расставляет события в коде и передаёт номер дальше. Инженер уточняет, означает ли «сохранено» попытку записи или уже подтверждённый результат.
Состав полей закрепляют в правилах для агентов и общем модуле записи. Произвольный текст «вроде отправили» не проходит такую приёмку.
Агент исполняет договорённость о событиях, а инженер принимает её смысл
Редакторская схема поручения и приёмки, 08.10.2026; требования к согласованию формата и проверке журнала: OWASP.
4. Журнал принимают на повторе и остановке, а не только на успехе.
Как проверить правку? Испытание проводят на тестовой заявке с заранее известным путём. Принимающий восстанавливает его по журналу, затем сверяет с состоянием приложения.
Тестовый отказ ставят на выбранном шаге. Если начало записано, а исхода нет, журнал оставляет результат неизвестным; успешную операцию из этого не выводят.
Тела запросов по умолчанию в журнал не копируют. Для воспроизведения агенту дают искусственные записи, а данные людей остаются в согласованном периметре.
Журнал принимают по учебной заявке с известным исходом
Сценарии приёмки редакции, 08.10.2026. OWASP рекомендует проверять формат, доступ и отказы логирования; конкретные исходы согласуются для вашего приложения.
5. Наши поломки научили отделять событие от рассказа о нём.
Можно ли доверять любой строке? Текст агента может описывать ошибку, которой не было. Запись о попытке тоже не подтверждает, что действие завершилось.
В машине vibecoding.ru инженер ведёт агентов и проверяет сигналы программы. Истории ниже относятся к этой машине, не к заявкам клиентского проекта.
Вывод для приёмки относится к источнику события. Его пишет код в согласованной точке выполнения. Рассказ агента о сделанной работе не заменяет эту запись.
После поломок мы меняли источник сигнала и состав вывода
13.07
Утилита вывела токен в непубличный транскрипт. Вывод команды подавили, токен заменили. Правило: секрет проверяют во всех выходах, даже если его нет в git.
15.07
Детектор принял упомянутую в тексте агента HTTP-ошибку за сбой запуска. Поиск общих HTTP-фраз перенесли в поток ошибок утилиты. Правило: сигнал программы отделяют от текста, который пишет агент.
22.07
Оставшийся после перезапуска замок мешал обработке; тики пропускались с отметкой «lock held». Теперь старый замок снимается, причина пропуска записывается. Правило: пропущенный запуск оставляет объяснение, а не видимость работы.
Сверенные записи собственной машины за 13, 15 и 22 июля 2026; перечитаны 08.10.2026. Закрытые журналы не публикуются, публичное описание машины доступно на /open.
6. Работу сдают вместе с поиском, проверками и правилами хранения.
Что остаётся после правки агентами? Код записи, описание событий и сохранённый способ найти операцию. Без поиска руководитель получает файлы, которые ещё надо разбирать.
Срок хранения выбирают под период разбора обращений. Доступ к журналу и удаление копий согласуют до запуска. Бесконечная запись всего подряд добавляет лишние данные.
Журнал помогает выяснить ход событий. Он не отменяет ответственность за поломку и не защищает от повторного действия; это отдельные требования к приложению.
Комплект сдачи позволяет повторить разбор без автора правки
Редакторский комплект сдачи, 08.10.2026; OWASP Verification, Protection и Disposal of logs. Журнал не заменяет запись бизнес-факта в хранилище.
Запись «начали сохранять» не доказывает сохранение. Если журнал пропал после изменения данных, результат проверяют в приложении; критичным операциям нужно отдельное подтверждение.
Для разработки по подписке это задача с согласованным составом событий. «Один проект» стоит 250 000 ₽ в месяц на 08.10.2026; это тариф подписки, не цена отдельного журнала.
Если поручить такую правку некому, начните с разбора задачи на звонке. На нём согласуют путь заявки и состав результата.
7. Частые вопросы
Что такое логирование простыми словами?+
Программа оставляет записи о событиях во время работы. Для разбора заявки полезны связанные записи о её приёме, шагах и исходе, а не только сообщение об ошибке.
Логирование и мониторинг делают одно и то же?+
Журнал сохраняет события для последующего разбора. Мониторинг следит за состоянием системы и условиями тревоги. Отсутствие тревоги не доказывает полноту журнала.
Зачем нужны уровни INFO, WARN и ERROR?+
Уровень помогает отбирать записи по важности. Он не связывает шаги заявки и не определяет её бизнес-результат. Для этого нужны номер операции и согласованный исход события.
Достаточно ли включить DEBUG?+
Подробный режим добавляет записи, но сам по себе не связывает их. Его включают для конкретного разбора, с ограничением полей и срока; избыточный вывод может унести секреты.
Нужно ли устанавливать отдельную систему хранения логов?+
Сначала проверьте существующий журнал: можно ли искать по полям и получить весь согласованный путь. Отдельное хранилище выбирают, когда текущего не хватает по объёму, сроку хранения или доступам.
ИИ-агент должен читать рабочие журналы с данными клиентов?+
Для добавления логирования ему нужны код и искусственные примеры событий. Доступ к реальным записям для расследования согласуют отдельно; он не следует из права писать код.
Логирование или логгирование?+
В этой статье и на сайте используем «логирование». Оба написания встречаются в поисковых подсказках; это не меняет требований к событиям.
Источники
- OWASP Logging Cheat Sheet · проверено 08.10.2026 — официальное руководство
- OpenTelemetry Logs Data Model · проверено 08.10.2026 — официальная спецификация
- OpenTelemetry Context propagation · проверено 08.10.2026 — официальная документация
- W3C Trace Context · проверено 08.10.2026 — официальный стандарт
- Машина разработки vibecoding.ru · публичное описание, проверено 08.10.2026; истории сверены с внутренними записями июля — наш опыт
- Тариф «Один проект» · проверено 08.10.2026 — официальный оффер
- Подсказки Google по слову «логирование» · проверено 08.10.2026 — поисковые подсказки
Запомнить
1. Принимайте восстановленный путь заявки, а не количество строк журнала.
2. Передавайте номер операции дальше; различайте шаг, попытку и исход.
3. Проверяйте успех, повтор и остановку на искусственной заявке.
4. Ограничьте состав полей и проверьте, что секрет отсутствует во всех выходах.
5. Сверяйте критичный результат с данными приложения; журнал помогает разбору, но не заменяет подтверждение.