Log

Log — это реакция для записи структурированных данных в логи вашего бота. Она незаменима при отладке, мониторинге и анализе работы триггеров, позволяя сохранять «слепки» состояния системы в ключевых точках выполнения сценариев.

В отличие от стандартных событий (Update, Request, Response), реакция Log создает кастомный контекстный объект, который отображается в отдельной вкладке логов (Context). Это позволяет разработчику выводить именно те данные, которые важны в данный момент, не захламляя общий поток системной информацией.

Параметры

Параметр	Тип	Обязательный	Описание
Название	Строка	❌ Нет	Задает имя для контекстного объекта в логах. Это облегчает поиск и фильтрацию нужных записей.
Путь	Строка	❌ Нет	Позволяет вывести в логи только конкретный объект или параметр (например, только данные пользователя или результат API-запроса), игнорируя остальной контекст.

Как это работает

При выполнении реакции Log платформа создает специальную запись в логах.
Если указан параметр «Название», запись получает соответствующий заголовок — это упрощает навигацию по большому количеству логов.
Если указан параметр «Путь», в логи попадает только та часть данных, на которую ссылается путь. Это полезно, когда полный контекст слишком громоздкий, а нужна только одна переменная (например, ID пользователя, сумма платежа или текст сообщения).

Примеры использования

Пример 1: Логирование с названием

Вы хотите отслеживать момент входа пользователя в бота.

Реакция Log:

Название: user_login
Путь: (не указан)

Результат в логах: В разделе Context появится запись с заголовком user_login, содержащая полный контекст выполнения триггера.

Пример 2: Вывод конкретного параметра

Вам нужно записать только ID пользователя и его баланс при выполнении команды /balance.

Реакция Log:

Название: balance_check
Путь: update

Результат в логах: Вместо всего контекста будет записан только компактный JSON-объект с приходящими из ТГ данными.

Пример 3: Отладка HTTP-запроса

После выполнения SendRequest вы хотите сохранить только полученный ответ от внешнего API.

Реакция Log:

Название: api_response
Путь: web.response.body

Результат в логах: В логах будет записано только тело ответа от внешнего сервиса, без лишней служебной информации.

Где смотреть результаты

Все записи, созданные реакцией Log, отображаются в разделе «Логи» (/adm → Настройки → Логи) при включенном фильтре Context.

Связь с другими разделами

Данная реакция активно используется вместе с:

HTTP-запросами (SendRequest) — для логирования ответов API.
Условиями — для проверки корректности данных в определенных ветках сценария.
Отладкой — как основной инструмент поиска и исправления ошибок.

Подробнее о работе с логами читайте в статье о логах.