Справочный центр eXpress

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

Инженерное меню и логи

Инженерное меню eXpress

Во всех клиентских версиях приложения для всех платформ есть инженерное меню, в котором находится дополнительная информация о приложении, пользователе, текущей сессии и логи. Через это меню можно собрать дополнительные логи с технической информацией и внутренними событиями приложения, его функций (Smart App) и сервера, которые помогут выявить причину возникшей проблемы.

Как открыть инженерное меню?

Чтобы открыть инженерное меню, в любой версии eXpress нажмите (Чаты >) Настройки (кнопка с шестерёнкой), выберите пункт О программе. Далее много раз нажмите на логотип приложения, пока не откроется страница инженерного меню. Далее приведено описание наиболее важных параметров его вкладок, которые могут пригодиться при обращении в поддержку.

Инженерное меню в eXpress для Android

Содержит вкладки (рассматриваются только нужные при обращении в поддержку):
  • USER. Здесь находятся следующие сведения: о вошедшем в приложение пользователе (Main User info), о текущей сессии (Session info), о получаемых с сервера настройках (Sync info), сведения о приложении (App info).
  • DATA. На этой вкладке есть: кнопка для очистки базы данных (CLEAR DATABASE) — очищает весь кэш без выхода из сессии, кнопка очистки файлов, загруженных в кэш (CLEAR FILES), ниже можно узнать размер базы данных и кэша файлов (Cache size).
  • LOG. На этой вкладке можно собрать логи приложения. В подразделе общих логов (Main log) есть: тумблер для включения записи общих логов (Write main log to file), кнопка для отправки файла общих логов (SHARE MAIN LOG FILE) и кнопка для очистки файла общих логов (CLEAR MAIN LOG FILE). Подраздел логов звонков и конференций (Call log) содержит кнопку для отправки файла лога (SHARE CALL LOG FILE) и кнопку для очистки файла лога (CLEAR CALL LOG FILE). Ниже в подразделе Smart Apps log можно включить запись логов Smart App в файл общих логов (Enable Smart Apps log).
  • FEATURES. На этой вкладке переключаются дополнительные и экспериментальные функции eXpress: приложения Smart App (Smart Apps), интеграция с Vinteo и т.д.
  • PUSH. В подразделе Push Services находятся сведения о службах push-уведомлений. Если токен соответствующей службы пуст, уведомления работать через эту службу не будут.
  • Инженерное меню в eXpress для iOS (iPadOS)

    Содержит общие параметры и разделы (рассматриваются только нужные при обращении в поддержку):
    • Инфо на экране звонка. Дополнительная техническая информация на экране идущего звонка.
    • Логи уведомлений. Дополнительная информация в логах push-уведомлений.
    • Smart Apps. Включение функции Smart Apps в приложении.
    • Собирать логи Smart App. Запись логов Smart App в файл общих логов.
    • Подробные ошибки Share. Дополнительная информация в логах о взаимодействии приложения с системной функцией iOS «поделиться».
    • Current user info. Информация о вошедшем в приложение пользователе: HUID, страна, телефон, ..., сведения о токенах (apnsPushToken и voexPushToken отвечают за уведомления и звонки и не должны быть пустыми), ключах (signKeyId — ID открытого ключа) и т.д.
    • Список чатов. Сводная информация о чатах.
    • Логи. Все логи приложения (кроме звонков и конференций). Нажмите кнопку «поделиться» наверху и выберите лог:
      • Main app logs. Общие логи из основного приложения, которые нужны, если проблема возникла с самим приложением.
      • Push extension logs. Логи уведомлений, которые нужны при проблемах с уведомлениями или счётчиками непрочитанных сообщений.
      • Share extension logs. Логи, собираемые при отправке каких-либо данных из/в приложение через функцию iOS «поделиться», которые нужны при проблемах с этой функцией.
    • VOEX сессии. Логи звонков и конференций.
    • LOG toggler. Включение дополнительной информации в логи.

    Инженерное меню в eXpress для ПК (веб/десктоп)

    Содержит вкладки (рассматриваются только нужные при обращении в поддержку):
    • Общее. Содержит переключатели функций логирования, кнопки диагностических функций, информацию о пользователе, статистику и т.д.
      • Сохранять статистику. Запись дополнительной статистики в лог.
      • Логировать все запросы в сокет. Запись всех сетевых запросов (можно будет из консоли экспортировать их в файл *.har.
      • Собирать логи SmartApp. Возможность сбора логов Smart App.
      • СКАЧАТЬ СТЕЙТ. Скачивание стейта (сводной информации о пользователе и его чатах) в файл.
      • СБРОСИТЬ СТЕЙТ. Эта кнопка удаляет, а затем заново загружает с сервера информацию о пользователе, чаты и контакты без выхода из сессии.
      • СКОПИРОВАТЬ СТЕЙТ В КОНСОЛЬ. Копирование содержимого стейта в браузерную консоль.
      • СБРОСИТЬ СТАТИСТИКУ. Очистка всех диагностических данных.
      • ОТКРЫТЬ КОНСОЛЬ. Открытие полноценной браузерной консоли для детальной диагностики ошибок приложения и получения общих логов.
      • Далее приведена информация о пользователе (идентификатор HUID), о сессии (UDID), статистика чатов и т.д. Показатель Начало сбора статистики — это время подключения к WebSocket, с момента установления соединения с сервером.
    • Звонки. Логи звонков и конференций.
    • Experimental. На этой вкладке переключаются дополнительные и экспериментальные функции eXpress: приложения Smart App (SmartApps), интеграция с Vinteo Vinteo integration и т.д.
    Наверху справа есть кнопка, делающая инженерное меню компактным.

    В веб- и десктоп-версиях eXpress в инженерном меню содержатся только логи звонков/конференций и стейт, а общие логи содержатся в браузерной консоли:
    • Веб-версия: нажмите клавишу (Fn +) F12, на открывшейся сбоку панели выберите вкладку Console; для просмотра сетевых запросов выберите вкладку Network.
    • Десктоп-версия: откройте инженерное меню через Настройки > О программе > много раз нажмите на логотип, пока не откроется меню > нажмите кнопку ОТКРЫТЬ КОНСОЛЬ.

Логи eXpress для Android

Упрощённый сбор диагностических данных

Эта функция пригодится в случаях, если проблему можно снова воспроизвести, в остальных случаях логи нужно собирать способами, которые описаны далее. Работает эта функция так:
  1. В eXpress нажмите (Чаты >) Настройки (кнопка с шестерёнкой), выберите пункт О программе. Внизу нажмите кнопку Начать сбор диагностических данных.
  2. Воспроизведите проблему, чтобы она попала в логи.
  3. Вернитесь в раздел О программе и нажмите внизу Остановить и поделиться.
  4. Передайте файл логов в поддержку.

Общие логи из инженерного меню (Android)


Логи в приложении для Android не собираются в фоне постоянно, необходимо заранее включать их запись в инженерном меню.

Чтобы собрать общие логи из инженерного меню приложения на Android:
  1. Откройте инженерное меню: (Чаты >) Настройки > О программе > много раз нажмите на логотип, пока не откроется инженерное меню.
  2. На вкладке LOG включите тумблер Write main log to file. Начнётся запись логов.
  3. Выйдите из инженерного меню и воспроизведите проблему, которую нужно отразить в логах.
  4. Вернитесь в инженерное меню на вкладку LOG и нажмите SHARE MAIN LOG FILE. Получившийся файл лога можно сохранить на устройстве или отправить.

Логи звонков и конференций из инженерного меню (Android)

Логи по звонкам и конференциям сохраняются на вкладке LOG инженерного меню в подразделе Call log. Чтобы получить и сохранить или отправить логи звонков или конференций:
  1. Откройте инженерное меню: (Чаты >) Настройки > О программе > много раз нажмите на логотип, пока не откроется инженерное меню.
  2. На вкладке LOG нажмите на кнопку SHARE CALL LOG FILE. Получившийся файл лога можно сохранить на устройстве или отправить.

Логи eXpress для iOS / iPadOS

Упрощённый сбор диагностических данных

Эта функция пригодится в случаях, если проблему можно снова воспроизвести, в остальных случаях логи нужно собирать способами, которые описаны далее. Работает эта функция так:
  1. В eXpress нажмите (Чаты >) Настройки (кнопка с шестерёнкой), выберите пункт О программе. Внизу нажмите кнопку Начать сбор диагностических данных.
  2. Воспроизведите проблему, чтобы она попала в логи.
  3. Вернитесь в раздел О программе и нажмите внизу Остановить и поделиться.
  4. Передайте файл логов в поддержку.
⚠️ Во избежание проблем с производительностью приложения не забывайте останавливать сбор диагностических данных.

Общие логи из инженерного меню (iOS/iPadOS)

Если проблема воспроизвелась однократно и более не повторяется:
  1. Откройте инженерное меню: (Чаты >) Настройки > О программе > много раз нажмите на логотип, пока не откроется инженерное меню.
  2. В инженерном меню откройте папку Logs, нажмите кнопку Поделиться справа вверху.
  3. Далее выберите, какие логи нужны:
    • Main app logs. Логи из основного приложения, которые нужны, если проблема возникла с приложением.
    • Push extension logs. Логи уведомлений, которые нужны при проблемах с уведомлениями или счётчиками непрочитанных сообщений.
    • Share extension logs. Логи, собираемые при отправке каких-либо данных из/в приложение через функцию shareTo («Поделиться»), которые нужны при проблемах с этой функцией.
  4. Сохраните выбранные логи в файл или отправьте в поддержку.

Логи звонков, конференций и сообщений из инженерного меню (iOS/iPadOS)

Логи звонков находятся в разделе Voex сессии инженерного меню. Стейт (сводная информация) чатов есть в разделе Список чатов. Чтобы собрать такие логи:
  1. Откройте инженерное меню: (Чаты >) Настройки > О программе > много раз нажмите на логотип, пока не откроется инженерное меню.
  2. В инженерном меню откройте нужный раздел.
  3. Справа вверху нажмите Поделиться (либо всей папкой сразу, либо предварительно выбрав чат или звонок в списке).

Логи веб-приложения eXpress

Упрощённый сбор диагностических данных

Эта функция пригодится в случаях, если проблему можно снова воспроизвести, в остальных случаях логи нужно собирать способами, которые описаны далее. Работает эта функция так:
  1. В eXpress нажмите (Чаты >) Настройки (кнопка с шестерёнкой), выберите пункт О программе. Внизу нажмите кнопку Начать сбор диагностических данных.
  2. Воспроизведите проблему, чтобы она попала в логи.
  3. Вернитесь в раздел О программе и нажмите внизу Остановить и скачать.
  4. Передайте файл логов в поддержку.

Общие логи из консоли веб-приложения

Чтобы получить логи и/или информацию о сетевых запросах:
  1. Нажмите клавишу (Fn +) F12 и выберите вкладку Console. Для просмотра сетевых запросов выберите вкладку Network.
  2. В консоли нажмите кнопку-шестерёнку наверху, чтобы открыть настройки, и в подразделе Console включите параметр Show timestamps. Таким образом, в консоли будет фиксироваться время событий.
  3. Можно предварительно очистить консоль, в контекстном меню выбрав команду Clear console. Воспроизведите проблему. В консоли появится ошибка или предупреждение. Сделайте скриншот ошибки или сохраните весь лог консоли командой Save as... в контекстном меню лога консоли.
  4. Чтобы сохранить информацию о сетевых запросах в файл HAR, на вкладке Network в контекстном меню выберите команду Save all as HAR with content. Если нужно, сетевые запросы можно предварительно очистить кнопкой Clear наверху.

Если нужно, чтобы в логах консоли была расширенная информация, в eXpress откройте (Чаты >) Настройки > О программе > много раз нажмите на логотип, пока не откроется инженерное меню > включите тумблер Логировать все запросы в сокет. После включения этой настройки понадобится перезагрузить страницу приложения (лучше с очисткой кэша нажатием клавиш Ctrl (Cmd) + R).

Стейт из инженерного меню веб-приложения

Стейт — это сводная информация о текущем пользователе, сервере, приложении, ключах и событиях. Так как стейт содержит не все данные, зачастую только его бывает недостаточно для анализа проблемы.

Чтобы скачать стейт или скопировать его в консоль:
  1. Откройте инженерное меню: (Чаты >) Настройки > О программе > много раз нажмите на логотип, пока не откроется инженерное меню.
  2. В инженерном меню на вкладке Общее нажмите СКАЧАТЬ СТЕЙТ, чтобы скачать стейт в виде файла, или СКОПИРОВАТЬ СТЕЙТ В КОНСОЛЬ, чтобы отобразить стейт в консоли.

Лог звонка или конференции из инженерного меню (веб)


Учтите, что логи звонков и конференций хоть и пишутся в фоне постоянно, но полностью стираются после перезапуска приложения. Стейт после перезапуска приложения остаётся, но в сокращённом виде.

Чтобы сохранить лог звонка или конференции из инженерного меню:
  1. Откройте инженерное меню: (Чаты >) Настройки > О программе > много раз нажмите на логотип, пока не откроется инженерное меню.
  2. Найдите нужный лог на вкладке Звонки.
    В названии звонка будет ID звонка/конференции, эта информация может пригодиться для поиска соответствующих логов на сервере.
  3. Нажмите звонок/конференцию и нажмите кнопку для скачивания лога.

Лога звонка или конференции через уведомление «Довольны ли вы качеством звонка?» (веб)

Если настроено, по окончании звонка или конференции отображается всплывающее уведомление с просьбой оценить качество звонка. Если в ответ на вопрос «Довольны ли вы качеством звонка?» выбрать НЕТ, лог звонка/конференции из клиентского приложения выгрузится на сервер, откуда его вместе с серверными логами звонка/конференции может скачать системный администратор. В скачанном архиве клиентские логи находятся в подпапке client logs.

Логи десктоп-приложения eXpress

Упрощённый сбор диагностических данных

Эта функция пригодится в случаях, если проблему можно снова воспроизвести, в остальных случаях логи нужно собирать способами, которые описаны далее. Работает эта функция так:
  1. В eXpress нажмите (Чаты >) Настройки (кнопка с шестерёнкой), выберите пункт О программе. Внизу нажмите кнопку Начать сбор диагностических данных.
  2. Воспроизведите проблему, чтобы она попала в логи.
  3. Вернитесь в раздел О программе и нажмите внизу Остановить и скачать.
  4. Передайте файл логов в поддержку.

Общие логи из консоли десктоп-приложения

Чтобы получить логи и/или информацию о сетевых запросах:
  1. Откройте инженерное меню: (Чаты >) Настройки > О программе > много раз нажмите на логотип, пока не откроется инженерное меню. Нажмите кнопку Открыть консоль. Откроется вкладка Console консоли. Для просмотра сетевых запросов выберите вкладку Network.
  2. В консоли нажмите кнопку-шестерёнку наверху, чтобы открыть настройки, и в подразделе Console включите параметр Show timestamps. Таким образом, в консоли будет фиксироваться время событий.
  3. Можно предварительно очистить консоль, в контекстном меню выбрав команду Clear console. Воспроизведите проблему. В консоли появится ошибка или предупреждение. Сделайте скриншот ошибки или сохраните весь лог консоли командой Save as... в контекстном меню лога консоли.
  4. Чтобы сохранить информацию о сетевых запросах в файл HAR, на вкладке Network в контекстном меню выберите команду Save all as HAR with content. Если нужно, сетевые запросы можно предварительно очистить кнопкой Clear наверху.

Если нужно, чтобы в логах консоли была расширенная информация, в eXpress откройте (Чаты >) Настройки > О программе > много раз нажмите на логотип, пока не откроется инженерное меню > включите тумблер Логировать все запросы в сокет. После включения этой настройки понадобится перезагрузить страницу приложения (лучше с очисткой кэша нажатием клавиш Ctrl (Cmd) + R).

Стейт из инженерного меню десктоп-приложения

Стейт — это сводная информация о текущем пользователе, сервере, приложении, ключах и событиях. Так как стейт содержит не все данные, зачастую только его бывает недостаточно для анализа проблемы.

Чтобы скачать стейт или скопировать его в консоль:
  1. Откройте инженерное меню: (Чаты >) Настройки > О программе > много раз нажмите на логотип, пока не откроется инженерное меню.
  2. В инженерном меню на вкладке Общее нажмите СКАЧАТЬ СТЕЙТ, чтобы скачать стейт в виде файла, или СКОПИРОВАТЬ СТЕЙТ В КОНСОЛЬ, чтобы отобразить стейт в консоли.

Лог звонка или конференции из инженерного меню (десктоп)


Учтите, что логи звонков и конференций хоть и пишутся в фоне постоянно, но полностью стираются после перезапуска приложения. Стейт после перезапуска приложения остаётся, но в сокращённом виде.

Чтобы сохранить лог звонка или конференции из инженерного меню:
  1. Откройте инженерное меню: (Чаты >) Настройки > О программе > много раз нажмите на логотип, пока не откроется инженерное меню.
  2. Найдите нужный лог на вкладке Звонки.
    В названии звонка будет ID звонка/конференции, эта информация может пригодиться для поиска соответствующих логов на сервере.
  3. Нажмите звонок/конференцию и нажмите кнопку для скачивания лога.

Лога звонка или конференции через уведомление «Довольны ли Вы качеством звонка?» (десктоп)

Если настроено, по окончании звонка или конференции отображается всплывающее уведомление с просьбой оценить качество звонка. Если в ответ на вопрос «Довольны ли Вы качеством звонка?» выбрать НЕТ, лог звонка/конференции из клиентского приложения выгрузится на сервер, откуда его вместе с серверными логами звонка/конференции может скачать системный администратор. В скачанном архиве клиентские логи находятся в подпапке client logs.

Логи обновления десктоп-приложения

Для анализа проблем, связанных с обновлением десктоп-версии, могут потребоваться дополнительные логи, которые находятся в специальном файле.
ВерсияРасположение файла
Windows%USERPROFILE%\AppData\Roaming\Express\log.log
Mac OSБиблиотека/Logs/Express
Linux~/.config/eXpress/log.log
или
/home/ИМЯ_ПОЛЬЗОВАТЕЛЯ/.config/eXpress/logs/log.log
(для открытия файла могут понадобиться права администратора)

Логи регистрации или входа в приложение

Логи регистрации или входа из приложения на Android

  1. Вернитесь в начало на экран ввода номера телефона или экран выбора способа входа (если нужно, завершите сессию в настройках приложения для этого).
  2. Много раз нажмите надпись Введите номер телефона или Выберите способ входа, пока внизу не всплывёт уведомление о ведущейся записи логов. В шторке уведомлений Android появится уведомление о записи логов «Идёт дебаг, не забудьте выключить».
  3. Воспроизведите проблему, которая возникает на экране входа или сразу после входа в приложение.
  4. Откройте шторку уведомлений Android, нажмите на уведомление «Идёт дебаг, не забудьте выключить», нажмите кнопку Остановить, затем Поделиться, чтобы сохранить или отправить логи в поддержку.

Логи регистрации или входа из приложения на iOS

  1. Вернитесь в начало на экран ввода номера телефона или экран выбора способа входа (если нужно, завершите сессию в настройках приложения для этого).
  2. Много раз нажмите надпись Введите номер телефона или Выберите способ входа, пока не всплывёт уведомление о ведущейся записи логов.
  3. Дойдите до шага, когда возникает ошибка. На всплывшей наверху ошибке нажмите кнопку Показать отчет.
  4. Наверху справа нажмите кнопку «поделиться», чтобы сохранить или отправить логи в поддержку.

Логи регистрации или входа из веб-приложения

В браузере на основе Chromium:
  1. Вернитесь в начало на экран ввода номера телефона или экран выбора способа входа (если нужно, завершите сессию в настройках приложения для этого).
  2. Нажмите клавишу (Fn +) F12 и выберите вкладку Console.
  3. Попробуйте войти в приложение, чтобы дойти до ошибки.
  4. В журнале консоли появится ошибка или несколько ошибок. Нажмите на ссылку в тексте последней ошибки (красного цвета).
  5. Откроется дополнительная вкладка. Посмотрите значение Reason — это будет причина ошибки, которую можно сообщить в поддержку.

Логи регистрации или входа из десктоп-приложения

  1. Вернитесь в начало и нажмите Войти с помощью номера телефона внизу страницы или нажмите кнопку Номер телефона.
  2. Много раз нажмите на логотип, пока не откроется инженерное меню. Далее нажмите кнопку ОТКРЫТЬ КОНСОЛЬ.
  3. В открывшейся справа консоли выберите вкладку Console.
  4. Закройте инженерное меню и попробуйте войти в приложение, чтобы дойти до ошибки.
  5. В журнале консоли появится ошибка или несколько ошибок. Нажмите на ссылку в тексте последней ошибки (красного цвета). Вы попадёте на вкладку Network.
  6. Уже на вкладке Network щелкните эту же ошибку в списке запросов.
  7. В открывшемся описании ошибки перейдите на вкладку Response.
  8. Посмотрите значение Reason — это будет причина ошибки, которую можно сообщить в поддержку.

Серверные логи регистрации или входа в приложение

Информация для системного администратора или поддержки.

Попытки войти и причины неудачных попыток пользователей можно просмотреть в панели администратора корпоративного сервера в разделе Аудит.

Также в разделе Контейнеры в панели администратора можно получить логи следующих контейнеров:
  • ad_integration — для диагностики интеграции с Active Directory;
  • authentification — для диагностики входа в систему (только на ETS/RTS);
  • email_notifications — если не приходит код на почту пользователя.
И на корпоративном сервере в разделе Настройки > E-mail есть функция Тестирование отправки e-mail для отправки пробных писем на любую электронную почту.

Логи корпоративного сервера

Информация для системного администратора или поддержки.

Об уровнях логирования

Уровней логирования в контейнерах корпоративного сервера четыре:
  1. error выводит в логи только ошибки; рекомендуется для систем, где больше 10 тыс. пользователей.
  2. warning рекомендуется для постоянной работы.
  3. info используется по умолчанию, предназначен для диагностики проблем.
  4. debug - самый подробный для расширенной диагностики проблем. Не рекомендуется использовать, поскольку вызывает зависание системы.
Уровень логирования контейнеров задается командой, требующей повторный deploy контейнера командой 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 на Android

Как получить логи Smart App из клиентского приложения на Android:
  1. Нажмите (Чаты >) Настройки > О программе > много раз нажмите на логотип, пока не откроется инженерное меню.
  2. На вкладке LOG в подразделе Smart Apps log включите Enable Smart Apps log.
  3. Закройте инженерное меню, откройте Smart App, воспроизведите проблему и через кнопку-троеточие в самом Smart App скачайте его логи.

Если проблема наблюдается во время или сразу после запуска Smart App (когда ещё нет кнопки для скачивания логов в самом Smart App):
  1. Нажмите (Чаты >) Настройки > О программе > много раз нажмите на логотип, пока не откроется инженерное меню.
  2. На вкладке LOG в подразделе Smart Apps log включите Enable Smart Apps log.
  3. Вернитесь в раздел О программе. Внизу нажмите кнопку Начать сбор диагностических данных.
  4. Откройте каталог Smart Apps и нажмите на проблемный Smart App.
  5. Не сворачивая приложение и не отключая интернет, подождите 15 секунд.
  6. Вернитесь в раздел О программе и нажмите внизу Остановить и поделиться (скачать).

При необходимости предварительно очистите логи Smart Apps: в инженерном меню на вкладке LOG в подразделе Smart Apps log выключите Enable Smart Apps log, если она была включена, затем снова включите.

Клиентские логи Smart App на iOS

Как получить логи Smart App из клиентского приложения на iOS:
  1. В инженерном меню приложения ((Чаты >) Настройки > О программе > много раз нажмите на логотип, пока не откроется инженерное меню.
  2. Включите настройку Собирать логи SmartApp (Collect Smart apps logs).
  3. Закройте инженерное меню, откройте Smart App, воспроизведите проблему и через кнопку-троеточие в самом Smart App скачайте его логи.

При необходимости предварительно очистите логи Smart Apps: в инженерном меню выключите настройку Собирать логи SmartApp (Collect Smart apps logs), если она была включена, затем снова включите.

Клиентские логи Smart App из веб/десктоп-приложения

Как получить логи Smart App из клиентского веб/десктоп-приложения на ПК:
  1. В инженерном меню приложения ((Чаты >) Настройки > О программе > много раз нажмите на логотип, пока не откроется инженерное меню.
  2. Включите настройку Собирать логи SmartApp (Collect Smart apps logs).
  3. Закройте инженерное меню, откройте Smart App, воспроизведите проблему и через кнопку-троеточие в самом Smart App скачайте его логи.

При необходимости предварительно очистите логи Smart Apps: для очистки логов закройте панель Smart App или очистите кэш приложения нажатием клавиш (Cmd) Ctrl + R.

Клиентские логи Smart App «Главная» и «Сервисы»

  1. В инженерном меню приложения ((Чаты >) Настройки > О программе > много раз нажмите на логотип, пока не откроется инженерное меню и далее:
    • Android: на вкладке LOG в подразделе Smart Apps log включите Enable Smart Apps log.
    • iOS и веб/десктоп: включите настройку Собирать логи SmartApp (Collect Smart apps logs).
  2. Закройте инженерное меню, и:
    • откройте проблемный Smart App, воспроизведите проблему и через кнопку-троеточие скачайте логи в самом Smart App.
    • либо откройте Сервисы (кнопка с 9-ю точками) > после загрузки много раз нажмите надпись Сервисы, пока не появится системное меню приложений. В нём выберите Home Screen. Нажмите три точки справа в верхнем углу и выберите Логи.

Серверные логи бота или Smart App

Информация для системного администратора или поддержки.

Как получить логи бота и Smart App через консоль:
  1. Зайдите на сервер, на котором запущен бот, используя ssh:
    ssh user@your.server
  2. Найдите имя контейнера с ботом (в последнем столбце), используя команду:
    docker ps
  3. Подставьте имя контейнера в следующую команду, чтобы записать логи бота в файл:
    docker logs CONTAINER_NAME > /tmp/bot_logs.txt 2>&1
  4. Выгрузите файл с логами с сервера, используя команду scp (команду запускать на ПК, не на сервере) или любым другим удобным для вас способом:
    scp user@your.server:/tmp/bot_logs.txt