Справочный центр eXpress
Собрали ответы на все самые популярные вопросы, чтобы вам было легко и удобно пользоваться eXpress. Также вам может помочь наша База знаний. Если вы не найдете ответ на свой вопрос, свяжитесь с нашей службой поддержки.
Инженерное меню и логи
- Справочный центр
- Что такое eXpress и список терминов
- Установка и системные требования
- Регистрация и авторизация
- Аккаунт и учётная запись
- Чаты, каналы и обсуждения
- Контакты
- Теги
- Файлы
- Звонки и конференции
- Уведомления
- Чат-боты и Smart Apps
- Инженерное меню и логи
- Очистка кэша и полное удаление
- Администратору сервера
- Документация
- Политика конфиденциальности
- Условия лицензирования
Инженерное меню и логи
- Инженерное меню eXpress
- Логи eXpress для Android
- Логи eXpress для iOS / iPadOS
- Логи веб-версии eXpress
- Логи десктоп-версии eXpress
- Логи регистрации или авторизации
- Логи корпоративного сервера
- Логи ботов и Smart Apps
Логи eXpress для Android
Упрощённый сбор диагностических данных 
Эта функция пригодится в случаях, если проблему можно снова воспроизвести, в остальных случаях логи нужно собирать способами, которые описаны далее. Работает эта функция так:- В eXpress нажмите (Чаты >) Настройки (кнопка с шестерёнкой), выберите пункт О программе. Внизу нажмите кнопку Начать сбор диагностических данных.
- Воспроизведите проблему, чтобы она попала в логи.
- Вернитесь в раздел О программе и нажмите внизу Остановить и поделиться.
- Передайте файл логов в поддержку.
Общие логи из приложения для Android 
Логи в приложении для Android не собираются в фоне постоянно, необходимо заранее включать их запись в инженерном меню.
Чтобы собрать общие логи из приложения на Android:
- Откройте инженерное меню: (Чаты >) Настройки > О программе > много раз нажмите на логотип, пока не откроется инженерное меню.
- На вкладке LOG включите тумблер Write main log to file. Начнётся запись логов.
- Выйдите из инженерного меню и воспроизведите проблему, которую нужно отразить в логах.
- Вернитесь в инженерное меню на вкладку LOG и нажмите SHARE MAIN LOG FILE. Получившийся файл лога можно сохранить на устройстве или отправить.
Логи звонков и конференций из приложения для Android 
Логи по звонкам и конференциям сохраняются на вкладке LOG инженерного меню в подразделе Call log. Чтобы получить и сохранить или отправить логи звонков или конференций:
- Откройте инженерное меню: (Чаты >) Настройки > О программе > много раз нажмите на логотип, пока не откроется инженерное меню.
- На вкладке LOG нажмите на кнопку SHARE CALL LOG FILE. Получившийся файл лога можно сохранить на устройстве или отправить.
Логи eXpress для iOS / iPadOS
Упрощённый сбор диагностических данных 
Эта функция пригодится в случаях, если проблему можно снова воспроизвести, в остальных случаях логи нужно собирать способами, которые описаны далее. Работает эта функция так:- В eXpress нажмите (Чаты >) Настройки (кнопка с шестерёнкой), выберите пункт О программе. Внизу нажмите кнопку Начать сбор диагностических данных.
- Воспроизведите проблему, чтобы она попала в логи.
- Вернитесь в раздел О программе и нажмите внизу Остановить и поделиться.
- Передайте файл логов в поддержку.
Общие логи из приложения для iOS / iPadOS 
Если проблема воспроизвелась однократно и более не повторяется:
- Откройте инженерное меню: (Чаты >) Настройки > О программе > много раз нажмите на логотип, пока не откроется инженерное меню.
- В инженерном меню откройте папку Logs, нажмите кнопку Поделиться справа вверху.
- Далее выберите, какие логи нужны:
- Main app logs. Логи из основного приложения, которые нужны, если проблема возникла с приложением.
- Push extension logs. Логи уведомлений, которые нужны при проблемах с уведомлениями или счётчиками непрочитанных сообщений.
- Share extension logs. Логи, собираемые при отправке каких-либо данных из/в приложение через функцию shareTo («Поделиться»), которые нужны при проблемах с этой функцией.
- Сохраните выбранные логи в файл или отправьте в поддержку.
Если проблема постоянная (в самом приложении), можно включить расширенное логирование заранее:
- Откройте инженерное меню: (Чаты >) Настройки > О программе > много раз нажмите на логотип, пока не откроется инженерное меню.
- В нижней части инженерного меню откройте Log Toggler. Включите тумблер Toggle all, чтобы в логи записывалась вся расширенная информация.
- Далее перейдите в раздел Logs, нажмите значок урны, чтобы очистить старые логи.
- Воспроизведите проблему, перейдите в инженерное меню, откройте папку Logs, нажмите кнопку Поделиться справа вверху. Сохраните Main app logs в файл или отправьте в поддержку.
- В конце расширенное логирование можно выключить.
Логи звонков, конференций и сообщений из приложения для iOS / iPadOS 
Логи звонков находятся в разделе Voex сессии инженерного меню. Стейт (сводная информация) чатов есть в разделе Список чатов. Чтобы собрать такие логи:
- Откройте инженерное меню: (Чаты >) Настройки > О программе > много раз нажмите на логотип, пока не откроется инженерное меню.
- В инженерном меню откройте нужный раздел.
- Справа вверху нажмите Поделиться (либо всей папкой сразу, либо предварительно выбрав чат или звонок в списке).
Логи веб-версии eXpress
Упрощённый сбор диагностических данных 
Эта функция пригодится в случаях, если проблему можно снова воспроизвести, в остальных случаях логи нужно собирать способами, которые описаны далее. Работает эта функция так:- В eXpress нажмите (Чаты >) Настройки (кнопка с шестерёнкой), выберите пункт О программе. Внизу нажмите кнопку Начать сбор диагностических данных.
- Воспроизведите проблему, чтобы она попала в логи.
- Вернитесь в раздел О программе и нажмите внизу Остановить и скачать.
- Передайте файл логов в поддержку.
Общие логи из консоли веб-версии приложения 
Чтобы получить логи и/или информацию о сетевых запросах:
- Нажмите клавишу (Fn +) F12 и выберите вкладку Console. Для просмотра сетевых запросов выберите вкладку Network.
- В консоли нажмите кнопку-шестерёнку наверху, чтобы открыть настройки, и в подразделе Console включите параметр Show timestamps. Таким образом, в консоли будет фиксироваться время событий.
- Можно предварительно очистить консоль, в контекстном меню выбрав команду Clear console. Воспроизведите проблему. В консоли появится ошибка или предупреждение. Сделайте скриншот ошибки или сохраните весь лог консоли командой Save as... в контекстном меню лога консоли.
- Чтобы сохранить информацию о сетевых запросах в файл HAR, на вкладке Network в контекстном меню выберите команду Save all as HAR with content. Если нужно, сетевые запросы можно предварительно очистить кнопкой Clear наверху.
Если нужно, чтобы в логах консоли была расширенная информация, в eXpress откройте (Чаты >) Настройки > О программе > много раз нажмите на логотип, пока не откроется инженерное меню > включите тумблер Логировать все запросы в сокет. После включения этой настройки понадобится перезагрузить страницу приложения (лучше с очисткой кэша нажатием клавиш Ctrl (Cmd) + R).
Стейт из инженерного меню веб-версии приложения 
Стейт — это сводная информация о текущем пользователе, сервере, приложении, ключах и событиях. Так как стейт содержит не все данные, зачастую только его бывает недостаточно для анализа проблемы.
Чтобы скачать стейт или скопировать его в консоль:
- Откройте инженерное меню: (Чаты >) Настройки > О программе > много раз нажмите на логотип, пока не откроется инженерное меню.
- В инженерном меню на вкладке Общее нажмите СКАЧАТЬ СТЕЙТ, чтобы скачать стейт в виде файла, или СКОПИРОВАТЬ СТЕЙТ В КОНСОЛЬ, чтобы отобразить стейт в консоли.
Лог звонка или конференции из инженерного меню (веб) 
Учтите, что логи звонков и конференций хоть и пишутся в фоне постоянно, но полностью стираются после перезапуска приложения. Стейт после перезапуска приложения остаётся, но в сокращённом виде.
Чтобы сохранить лог звонка или конференции из инженерного меню:
- Откройте инженерное меню: (Чаты >) Настройки > О программе > много раз нажмите на логотип, пока не откроется инженерное меню.
- Найдите нужный лог на вкладке Звонки.
В названии звонка будет ID звонка/конференции, эта информация может пригодиться для поиска соответствующих логов на сервере. - Нажмите звонок/конференцию и нажмите кнопку для скачивания лога.
Лога звонка или конференции через уведомление «Довольны ли Вы качеством звонка?» (веб) 
Если настроено, по окончании звонка или конференции отображается всплывающее уведомление с просьбой оценить качество звонка. Если в ответ на вопрос «Довольны ли Вы качеством звонка?» выбрать НЕТ, лог звонка/конференции из клиентского приложения выгрузится на сервер, откуда его вместе с серверными логами звонка/конференции может скачать системный администратор. В скачанном архиве клиентские логи находятся в подпапке client logs.
Логи десктоп-версии eXpress
Упрощённый сбор диагностических данных 
Эта функция пригодится в случаях, если проблему можно снова воспроизвести, в остальных случаях логи нужно собирать способами, которые описаны далее. Работает эта функция так:- В eXpress нажмите (Чаты >) Настройки (кнопка с шестерёнкой), выберите пункт О программе. Внизу нажмите кнопку Начать сбор диагностических данных.
- Воспроизведите проблему, чтобы она попала в логи.
- Вернитесь в раздел О программе и нажмите внизу Остановить и скачать.
- Передайте файл логов в поддержку.
Общие логи из консоли десктоп-версии приложения 
Чтобы получить логи и/или информацию о сетевых запросах:
- Откройте инженерное меню: (Чаты >) Настройки > О программе > много раз нажмите на логотип, пока не откроется инженерное меню. Нажмите кнопку Открыть консоль. Откроется вкладка Console консоли. Для просмотра сетевых запросов выберите вкладку Network.
- В консоли нажмите кнопку-шестерёнку наверху, чтобы открыть настройки, и в подразделе Console включите параметр Show timestamps. Таким образом, в консоли будет фиксироваться время событий.
- Можно предварительно очистить консоль, в контекстном меню выбрав команду Clear console. Воспроизведите проблему. В консоли появится ошибка или предупреждение. Сделайте скриншот ошибки или сохраните весь лог консоли командой Save as... в контекстном меню лога консоли.
- Чтобы сохранить информацию о сетевых запросах в файл HAR, на вкладке Network в контекстном меню выберите команду Save all as HAR with content. Если нужно, сетевые запросы можно предварительно очистить кнопкой Clear наверху.
Если нужно, чтобы в логах консоли была расширенная информация, в eXpress откройте (Чаты >) Настройки > О программе > много раз нажмите на логотип, пока не откроется инженерное меню > включите тумблер Логировать все запросы в сокет. После включения этой настройки понадобится перезагрузить страницу приложения (лучше с очисткой кэша нажатием клавиш Ctrl (Cmd) + R).
Стейт из инженерного меню десктоп-версии приложения 
Стейт — это сводная информация о текущем пользователе, сервере, приложении, ключах и событиях. Так как стейт содержит не все данные, зачастую только его бывает недостаточно для анализа проблемы.
Чтобы скачать стейт или скопировать его в консоль:
- Откройте инженерное меню: (Чаты >) Настройки > О программе > много раз нажмите на логотип, пока не откроется инженерное меню.
- В инженерном меню на вкладке Общее нажмите СКАЧАТЬ СТЕЙТ, чтобы скачать стейт в виде файла, или СКОПИРОВАТЬ СТЕЙТ В КОНСОЛЬ, чтобы отобразить стейт в консоли.
Лог звонка или конференции из инженерного меню (десктоп) 
Учтите, что логи звонков и конференций хоть и пишутся в фоне постоянно, но полностью стираются после перезапуска приложения. Стейт после перезапуска приложения остаётся, но в сокращённом виде.
Чтобы сохранить лог звонка или конференции из инженерного меню:
- Откройте инженерное меню: (Чаты >) Настройки > О программе > много раз нажмите на логотип, пока не откроется инженерное меню.
- Найдите нужный лог на вкладке Звонки.
В названии звонка будет ID звонка/конференции, эта информация может пригодиться для поиска соответствующих логов на сервере. - Нажмите звонок/конференцию и нажмите кнопку для скачивания лога.
Лога звонка или конференции через уведомление «Довольны ли Вы качеством звонка?» (десктоп) 
Если настроено, по окончании звонка или конференции отображается всплывающее уведомление с просьбой оценить качество звонка. Если в ответ на вопрос «Довольны ли Вы качеством звонка?» выбрать НЕТ, лог звонка/конференции из клиентского приложения выгрузится на сервер, откуда его вместе с серверными логами звонка/конференции может скачать системный администратор. В скачанном архиве клиентские логи находятся в подпапке client logs.
Логи обновления десктоп-версии приложения 
Для анализа проблем, связанных с обновлением десктоп-версии, могут потребоваться дополнительные логи, которые находятся в специальном файле.
Версия | Расположение файла |
Windows | %USERPROFILE%\AppData\Roaming\Express\log.log |
Mac OS | Библиотека/Logs/Express |
Linux | ~/.config/eXpress/logs/log.log |
Логи регистрации или авторизации
Логи регистрации или авторизации из приложения на Android 
- Вернитесь в начало на экран ввода номера телефона (если нужно, завершите сессию в настройках приложения для этого).
- Много раз нажмите надпись Введите номер телефона, пока внизу не всплывёт уведомление о ведущейся записи логов. В шторке уведомлений Android появится уведомление о записи логов «Идёт дебаг, не забудьте выключить».
- Воспроизведите проблему, которая возникает на экране авторизации или сразу после входа в приложение.
- Откройте шторку уведомлений Android, нажмите на уведомление «Идёт дебаг, не забудьте выключить», нажмите кнопку Остановить, затем Поделиться, чтобы сохранить или отправить логи в поддержку.
Логи регистрации или авторизации из приложения на iOS 
- На всплывающей ошибке нажмите кнопку Показать отчет.
- Наверху справа нажмите кнопку «поделиться», чтобы сохранить или отправить логи в поддержку.
Логи регистрации или авторизации из веб-приложения 
- Нажмите клавишу (Fn +) F12 и выберите вкладку Console. Для просмотра сетевых запросов выберите вкладку Network.
- В консоли нажмите кнопку-шестерёнку наверху, чтобы открыть настройки, и в подразделе Console включите параметр Show timestamps. Таким образом, в консоли будет фиксироваться время событий.
- Можно предварительно очистить консоль, в контекстном меню выбрав команду Clear console. Воспроизведите проблему с авторизацией. В консоли появится ошибка или предупреждение. Сделайте скриншот ошибки или сохраните весь лог консоли командой Save as... в контекстном меню лога консоли.
- Чтобы сохранить информацию о сетевых запросах в файл HAR, на вкладке Network в контекстном меню выберите команду Save all as HAR with content. Если нужно, сетевые запросы можно предварительно очистить кнопкой Clear наверху.
Логи регистрации или авторизации из десктоп-приложения 
- Нажмите Войти с помощью номера телефона внизу страницы.
- Много раз нажмите на логотип, пока не откроется инженерное меню. Далее нажмите кнопку ОТКРЫТЬ КОНСОЛЬ.
- В открывшейся справа консоли выберите вкладку Console. Для просмотра сетевых запросов выберите вкладку Network.
- В консоли нажмите кнопку-шестерёнку наверху, чтобы открыть настройки, и в подразделе Console включите параметр Show timestamps. Таким образом, в консоли будет фиксироваться время событий.
- Можно предварительно очистить консоль, в контекстном меню выбрав команду Clear console. Воспроизведите проблему с авторизацией. В консоли появится ошибка или предупреждение. Сделайте скриншот ошибки или сохраните весь лог консоли командой Save as... в контекстном меню лога консоли.
- Чтобы сохранить информацию о сетевых запросах в файл HAR, на вкладке Network в контекстном меню выберите команду Save all as HAR with content. Если нужно, сетевые запросы можно предварительно очистить кнопкой Clear наверху.
Серверные логи регистрации или авторизации 
Информация для системного администратора или поддержки.
Попытки войти и причины неудачных попыток пользователей можно просмотреть в панели администратора корпоративного сервера в разделе Аудит.
Также в разделе Контейнеры в панели администратора можно получить логи следующих контейнеров:
- ad_integration — для диагностики интеграции с Active Directory;
- authentification — для диагностики входа в систему (только на ETS/RTS);
- email_notifications — если не приходит код на почту пользователя.
Логи корпоративного сервера
Информация для системного администратора или поддержки.
Об уровнях логирования
Уровней логирования в контейнерах корпоративного сервера четыре:
Либо уровень логирования задаётся командой в консоли самого сервиса, без повторного deploy контейнера:
Логи звонков и конференций с корпоративного сервера
Чтобы собрать логи звонка с корпоративного сервера, в панели администратора перейдите в раздел Звонки, найдите желаемый звонок и нажмите Скачать логи.
Логи конференций доступны в подразделе Конференции панели администратора. Учтите, что конференция появится в этом списке, только если она была создана на этом сервере.
Логи контейнеров с корпоративного сервера
Чтобы собрать логи контейнера с корпоративного сервера, в панели администратора перейдите в раздел Контейнеры, нажмите >_логи напротив нужного контейнера. Введите дату и количество строк, которые нужно вывести, снимите флажок follow (чтобы не получать сообщения в режиме реального времени) и нажмите кнопку show.
Общие логи сервера и логи контейнеров можно получить не только в панели администратора, но и через консоль:
Логи контейнеров messaging и voex (для звонков):
Логи контейнеров coturn и redis (для звонков):
Логи контейнера file service:
Об уровнях логирования 
Уровней логирования в контейнерах корпоративного сервера четыре:
- 1.
error
выводит в логи только ошибки; рекомендуется для систем, где больше 10 тыс. пользователей. - 2.
warning
рекомендуется для постоянной работы. - 3.
info
используется по умолчанию, предназначен для диагностики проблем. - 4.
debug
- самый подробный для расширенной диагностики проблем. Не рекомендуется использовать, поскольку вызывает зависание системы.
dpl -d
(ниже пример для контейнера trusts):
trusts_env_override:
LOGGER_LEVEL: debug
Учтите, что при выполнении команды
dpl -d
для критических контейнеров будет перерыв в работе сервиса!
Либо уровень логирования задаётся командой в консоли самого сервиса, без повторного deploy контейнера:
Logger.configure(level: :debug)
Логи звонков и конференций с корпоративного сервера 
Чтобы собрать логи звонка с корпоративного сервера, в панели администратора перейдите в раздел Звонки, найдите желаемый звонок и нажмите Скачать логи.
Звонок можно найти по ID чата, в котором был звонок, либо по ID звонка (этот ID можно получить из логов инженерного меню приложения).
Логи конференций доступны в подразделе Конференции панели администратора. Учтите, что конференция появится в этом списке, только если она была создана на этом сервере.
ID конференции можно взять из логов звонков и конференций в инженерном меню самого приложения.
Логи контейнеров с корпоративного сервера 
Чтобы собрать логи контейнера с корпоративного сервера, в панели администратора перейдите в раздел Контейнеры, нажмите >_логи напротив нужного контейнера. Введите дату и количество строк, которые нужно вывести, снимите флажок follow (чтобы не получать сообщения в режиме реального времени) и нажмите кнопку show.
Общие логи сервера и логи контейнеров можно получить не только в панели администратора, но и через консоль:
dpl –-dc logs –tail=1000 > logs.txt
В tail указывается количество выводимых последних строк лога.
Логи контейнеров messaging и voex (для звонков):
cd /opt/express
dpl --dc logs -tail=1000 messaging > filename.log
dpl --dc logs -tail=1000 voex > filename.log
Логи контейнеров coturn и redis (для звонков):
cd /opt/express-voice
dpl --dc logs -tail=1000 coturn > filename.log
dpl --dc logs -tail=1000 redis > filename.log
Логи контейнера file service:
cd /opt/express
dpl --dc logs -tail=1000 file_service > filename.log
Логи ботов и Smart Apps
Клиентские логи Smart App 
Как получить логи Smart App из клиентского приложения:
- В инженерном меню приложения ((Чаты >) Настройки > О программе > много раз нажмите на логотип, пока не откроется инженерное меню и далее:
- Android: на вкладке LOG в подразделе Smart Apps log включите Enable Smart Apps log.
- iOS и веб/десктоп: включите настройку Собирать логи SmartApp (Collect Smart apps logs).
- Закройте инженерное меню, откройте Smart App, воспроизведите проблему и через кнопку-троеточие в самом Smart App скачайте его логи.
При необходимости предварительно очистите логи Smart Apps:
- Android: в инженерном меню на вкладке LOG в подразделе Smart Apps log выключите Enable Smart Apps log, если она была включена, затем снова включите.
- iOS: в инженерном меню выключите настройку Собирать логи SmartApp (Collect Smart apps logs), если она была включена, затем снова включите.
- Веб/десктоп: для очистки логов закройте панель Smart App или очистите кэш приложения нажатием клавиш (Cmd) Ctrl + R.
Клиентские логи Smart App «Главная» и «Сервисы» 
- В инженерном меню приложения ((Чаты >) Настройки > О программе > много раз нажмите на логотип, пока не откроется инженерное меню и далее:
- Android: на вкладке LOG в подразделе Smart Apps log включите Enable Smart Apps log.
- iOS и веб/десктоп: включите настройку Собирать логи SmartApp (Collect Smart apps logs).
- Закройте инженерное меню, и:
- откройте проблемный Smart App, воспроизведите проблему и через кнопку-троеточие скачайте логи в самом Smart App.
- либо откройте Сервисы (кнопка с 9-ю точками) > после загрузки много раз нажмите надпись Сервисы, пока не появится системное меню приложений. В нём выберите Home Screen. Нажмите три точки справа в верхнем углу и выберите Логи.
Серверные логи бота или Smart App 
Информация для системного администратора или поддержки.
Как получить логи бота и Smart App через консоль:
- Зайдите на сервер, на котором запущен бот, используя ssh:
ssh user@your.server
Найдите имя контейнера с ботом (в последнем столбце), используя команду:
docker ps
Подставьте имя контейнера в следующую команду, чтобы записать логи бота в файл:docker logs CONTAINER_NAME > /tmp/bot_logs.txt 2>&1
Выгрузите файл с логами с сервера, используя команду scp (команду запускать на ПК, не на сервере) или любым другим удобным для вас способом:scp user@your.server:/tmp/bot_logs.txt