Поддержка

Собрали ответы на популярные вопросы, чтобы пользоваться eXpress было легко и удобно. Не нашли ответ на свой вопрос? Свяжитесь с нашей поддержкой.

Логи ботов и SmartApps
Обновлено 08.10.2026

Логи ботов и SmartApps

Клиентские логи собираются с устройства пользователя; серверные — с инфраструктуры, где размещён бот или SmartApp.

Клиентские логи ботов и SmartApps

CTS
eCTS
⚠️ Администратору: до того как воспроизводить проблему и собирать клиентские логи SmartApp, может понадобиться включить переменные отладки на сервере — подробнее.

Сбор логов SmartApp без инженерного меню

Лог SmartApp можно собрать и передать в поддержку из меню SmartApp: нажмите кнопку-троеточие в открытом SmartApp. Инженерное меню для этого не нужно. Набор команд зависит от того, как настроил SmartApp администратор:

    Как администратор настроил SmartApp Как собрать и передать лог
    Назначено отдельное приложение поддержки Нажмите Связаться с поддержкой: команда открывает приложение поддержки и передаёт в него архив с логом. Лог пишется с момента открытия SmartApp. Снимок экрана прикладывается к логу, если его включил администратор и снимки экрана разрешены в вашей организации. Отдельной команды для выгрузки лога в таком случае нет.
    Приложения поддержки нет, включена постоянная запись логов Нажмите Поделиться логами: лог выгрузится вам. Приложите его к обращению сами.
    Постоянная запись логов выключена Включите запись вручную: нажмите Начать сбор логов, воспроизведите проблему и нажмите Остановить сбор логов и скачать (веб и десктоп) или Остановить сбор логов (Android и iOS).
Доступно в серверном ПО, веб-/десктоп-приложении и на iOS с версии 3.72, на Android — с версии 3.73. Если нужен лог с самого запуска SmartApp, а постоянная запись выключена, см. «Лог SmartApp с момента запуска».

Сбор клиентских логов ботов и SmartApps через экран «О программе»

Логи для диагностики ботов и SmartApps собираются через экран «О программе».

Для диагностики ботов клиентских логов недостаточно: нужны и серверные логи.

Лог SmartApp с момента запуска

Нужен, если ошибка возникает сразу при открытии SmartApp и собрать лог через троеточие не получается. Способа два:

  • Попросите администратора сервера вашей организации включить для этого SmartApp флажок Постоянная запись логов в разделе «Боты». Лог будет писаться при каждом открытии SmartApp: воспроизведите ошибку и выгрузите лог через кнопку-троеточие.
  • Если администратор недоступен, соберите диагностику через экран «О программе»: Настройки > О программе > Начать сбор диагностической информации, откройте SmartApp и подождите 15 секунд, затем О программе > Остановить и поделиться.

Серверные логи ботов и SmartApps

CTS
eCTS
Инструкции ниже — для стандартных ботов eXpress в контейнерах. Логи ботов сторонних разработчиков могут собираться иначе: как собрать диагностику по такому боту, узнайте у его разработчика.
Администратору: параметры отладки ботов и SmartApps
  1. При необходимости измените переменные отладки в файле /opt/express/bots/your_bot/.env и перезапустите контейнеры бота/SmartApp и Worker.
    ⚠️ Переменные отладки есть не во всех ботах и SmartApps.
    Переменная отладки Что включает
    DEBUG=true|false Режим подробного логирования для основных компонентов бота или SmartApp.
    IMAP_DEBUG=true|false Только для Email SmartApp: режим подробного логирования для клиента IMAP. Нужно и значение DEBUG=true.
    EXCHANGE_DEBUG=true|false Только для Email/Calendar SmartApps: режим подробного логирования для клиента Exchange. Нужно и значение DEBUG=true.
Администратору: сбор серверных логов ботов и SmartApps
  1. Подключитесь к серверу для сбора логов. Определите имя контейнера с ботом/SmartApp (последний столбец): docker ps
    У некоторых SmartApps два контейнера: основной и worker. Тогда нужны логи обоих.
  2. Экспортируйте логи: docker logs CONTAINER_NAME > /tmp/bot_logs.txt 2>&1
  3. Скачайте файл: scp user@your.server:/tmp/bot_logs.txt
Администратору: файлы .env и docker-compose.yaml
  1. Если поддержка запросит, пришлите ей файл /opt/express/bots/your_bot/.env и конфигурационный файл docker-compose.yaml из /opt/express/bots/your_bot/. Перед отправкой удалите из файла .env чувствительные данные.

Связанные вопросы