Поддержка

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

Диагностика и логи

Версии приложения

⚠️ Обновляйте приложение, чтобы получать последние исправления и новшества — подробнее.
Платформа Где найти номер версии?
Веб/десктоп Номер версии отображается в нижнем левом углу страницы или окна приложения или откройте Настройки (аватар над списком чатов) > О программе.
Android, iOS/iPadOS, Aurora Откройте Настройки (аватар над списком чатов) > О программе или см. в нижней части экрана входа в приложение.
Сервер

Версии сервисов серверного ПО приложения доступны для просмотра администраторам:

Cбор диагностики через экран «O программе»

Что такое сбор диагностической информации?

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

⚠️ Временно недоступно в приложении для Aurora — используйте общие логи из инженерного меню (Aurora).

Как собрать диагностическую информацию?

  1. В приложении перейдите в Настройки (аватар над списком чатов) > О программе и нажмите кнопку Начать сбор диагностических данных.
  2. Воспроизведите проблему, чтобы она зафиксировалась в логах.
  3. Вернитесь в раздел О программе и нажмите Остановить и поделиться.
    Начиная с версии 3.37 в десктоп-приложении также будет предложено сохранить логи обновления в отдельный файл.
  4. Передайте файл(ы) логов в поддержку.

Инженерное меню приложения

Что такое инженерное меню?

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

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

  1. В приложении выберите Настройки (аватар над списком чатов) > О программе.
  2. Несколько раз нажмите на логотип приложения, пока не откроется инженерное меню.
Инженерное меню в приложении для 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 Apps (аналогично Main log).
FEATURES Переключает дополнительные функции (Smart Apps, интеграция с Vinteo и др.).
PUSH Информация о push-уведомлениях:
  • push_service_type — текущая служба push-уведомлений.
    Если значение UNDEFINED, возможные причины:
    • Отсутствие необходимых push-служб на устройстве.
    • Нет разрешения на уведомления в настройках ОС.
    • Некорректные настройки push-службы на сервере (см. подробнее).

  • push_token — токен push-службы.
    Должен содержать звёздочки. Если видите прочерк — уведомления не работают. Нажмите RESET PUSH TOKEN, чтобы обновить токен.
  • User Push Service — если уведомления не работают, в качестве крайней меры вы можете выбрать другую службу и нажать SET USER PUSH SERVICE. Если проблема не решается, соберите логи и обратитесь в поддержку eXpress.
Инженерное меню в приложении для iOS (iPadOS)

Содержит следующие разделы (указаны только ключевые для диагностики):

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

Содержит следующие вкладки:

Вкладка Описание
USER Информация о пользователе, сессии и настройках синхронизации.
DATA
  • CLEAR DATABASE — очистка базы данных.
  • CLEAR FILES — удаление кэша файлов.
  • Cache size — размер кэша.
LOG управление логами (подробнее).
Инженерное меню в веб-/десктоп-приложении

В веб-/десктоп-приложении инженерное меню также можно открыть на экране входа, многократно нажав на логотип.


Содержит следующие вкладки (ключевые для диагностики):

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

Кнопка в верхнем правом углу переключает компактный режим.

Инженерное меню веб-/десктоп-приложения содержит только логи звонков и стейт. Для общего лога используйте консоль браузера.

Логи аутентификации (входа) в приложение

Зачем нужны эти логи?

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

Логи аутентификации из приложения на Android

На начальном экране Шаги
«Выберите способ входа»
  • Вернитесь на первый экран для выбора способа входа. При необходимости завершите текущую сессию в настройках приложения.
  • Несколько раз нажмите на надпись Выберите способ входа, пока не появится уведомление о записи логов. В шторке уведомлений Android отобразится сообщение: «Идёт дебаг, не забудьте выключить».
  • Воспроизведите проблему, возникающую на экране входа или сразу после входа.
  • Откройте шторку уведомлений, нажмите на сообщение «Идёт дебаг, не забудьте выключить», затем выберите Остановить > Поделиться. Или, если вошли в приложение, перейдите в раздел О программе и нажмите Остановить и поделиться.
«Введите номер телефона»
  • Вернитесь на первый экран для ввода номера телефона. При необходимости завершите текущую сессию в настройках приложения.
  • Несколько раз нажмите на надпись Введите номер телефона, пока не появится уведомление о записи логов. В шторке уведомлений Android отобразится сообщение: «Идёт дебаг, не забудьте выключить».
  • Воспроизведите проблему, возникающую на экране входа или сразу после входа.
  • Откройте шторку уведомлений, нажмите на сообщение «Идёт дебаг, не забудьте выключить», затем выберите Остановить > Поделиться. Или, если вошли в приложение, перейдите в раздел О программе и нажмите Остановить и поделиться.

Логи аутентификации из приложения на iOS

На начальном экране Шаги
«Выберите способ входа»
  • Вернитесь на первый экран для выбора способа входа. При необходимости завершите текущую сессию в настройках приложения.
  • Несколько раз нажмите на надпись Выберите способ входа, пока не появится уведомление о записи логов.
  • Воспроизведите проблему, возникающую на экране входа или сразу после входа.
  • Нажмите кнопку с вопросительным знаком внизу экрана или, если вошли в приложение, перейдите в раздел О программе и выберите Остановить и поделиться.
«Введите номер телефона»
  • Вернитесь на первый экран для ввода номера телефона. При необходимости завершите текущую сессию в настройках приложения.
  • Несколько раз нажмите на надпись Введите номер телефона, пока не появится уведомление о записи логов.
  • Воспроизведите проблему, возникающую на экране входа или сразу после входа.
  • Нажмите кнопку с вопросительным знаком внизу экрана или, если вошли в приложение, перейдите в раздел О программе и выберите Остановить и поделиться.

Логи аутентификации из приложения на Aurora

Эта функция пока недоступна в приложении для Aurora. Можно собрать только логи после входа в приложение из инженерного меню.

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

Отчёт об ошибке

Во всплывающем сообщении об ошибке щёлкните Подробнее. Раскройте блок data для просмотра причины ошибки в открывшемся окне.

Диагностика в консоли разработчика

Для сбора логов или диагностики сетевых запросов при проблемах на экране входа:

  1. Откройте консоль браузера или десктоп-приложения:
    Платформа Путь
    Chrome, Edge, Opera, Яндекс Браузер, десктоп-приложение Нажмите F12 (или Fn + F12).
    Safari (macOS) Нажмите Option + Cmd + C или щёлкните правой кнопкой мыши в любом месте страницы и выберите Проверить элемент.
    Если консоль не открылась, включите функции разработчика: Safari > Настройки > Дополнения > Показывать функции для разработчиков. Название и состав меню разработчика отличаются в разных версиях Safari.
  2. Перейдите на вкладку Console.
  3. Воспроизведите проблему при входе.
  4. Найдите последнюю ошибку (красный текст) и нажмите на ссылку в ней.
  5. Во вкладке Network выберите соответствующий запрос.
  6. В описании ошибки откройте вкладку Response.
  7. Значение Reason укажет причину ошибки. Можно скопировать его (сделать скриншот) и отправить в поддержку.

Серверные логи аутентификации

Администратору: серверные логи аутентификации

Попытки входа и причины ошибок доступны в панели администратора:

Раздел Описание
«Аудит» Просмотр неудачных попыток входа на
CTS
,
eCTS
. Щёлкните идентификатор события для просмотра деталей.
«Контейнеры» Соберите логи сервисов:
  • ad_integration — диагностика синхронизации с Active Directory/OpenID на
    CTS
    /
    eCTS
    ;
  • authentication — логи аутентификации пользователей (только на
    RTS
    ,
    ETS
    );
  • email_notifications — если проверочный код не приходит с
    CTS
    /
    eCTS
    на почту.
E-mail Для пробной отправки писем c сервера используйте функцию Тестирование отправки e-mail.

Дополнительные логи клиентского приложения

Эти логи требуются лишь в особых случаях, как правило, по запросу специалистов поддержки.

Логи приложения Android из инженерного меню

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

Логи приложения iOS/iPadOS из инженерного меню

Чтобы собрать имеющиеся общие логи из инженерного меню приложения на iOS/iPadOS «задним числом»:

  1. Откройте инженерное меню: Настройки > О программе > многократно нажмите на логотип.
  2. В папке Logs используйте кнопку «Поделиться» для выбора типа лога:
    Пункт Описание
    Main app logs Общие логи приложения при проблемах с его работой.
    Push extension logs Логи уведомлений и счётчиков непрочитанных сообщений.
    Share extension logs Логи системной функции «Поделиться» в iOS.

Логи приложения Aurora из инженерного меню

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

Диагностика в консоли разработчика (веб/десктоп)

Чтобы просмотреть логи из консоли, откройте веб- или десктоп-приложение, воспроизведите ошибку и затем:

  1. Если необходимо (по просьбе поддержки), включите расширенное логирование запросов:
    • Откройте инженерное меню через Настройки > О программе > многократно нажмите на логотип.
    • Включите Логировать все запросы в сокет и обновите кэш Ctrl (Cmd) + R.
  2. Откройте консоль разработчика:
    Платформа Путь
    Chromium-браузеры и десктоп-приложение Нажмите F12 (на Mac: Cmd+Opt+I или выберите Консоль в меню приложения).
    Safari (macOS) Нажмите Option + Cmd + C или щёлкните правой кнопкой мыши в любом месте страницы и выберите Проверить элемент.
    Если консоль не открылась, включите функции разработчика: Safari > Настройки > Дополнения > Показывать функции для разработчиков. Название и состав меню разработчика отличаются в разных версиях Safari.
  3. В настройках (кнопка-шестерёнка в верхнем углу консоли) включите Отображать временные метки (Show timestamps)
  4. Очистите консоль (Clear console) > воспроизведите ошибку
  5. Сохраните логи через Сохранить как (Save as...) или сделайте скриншот.

Диагностика сетевых запросов в HAR (веб/десктоп)

  1. Откройте консоль разработчика:
    Платформа Путь
    Chromium-браузеры и десктоп-приложение Нажмите F12 (на Mac: Cmd+Opt+I или выберите Консоль в меню приложения).
    Safari (macOS) Нажмите Option + Cmd + C или щёлкните правой кнопкой мыши в любом месте страницы и выберите Проверить элемент.
    Если консоль не открылась, включите функции разработчика: Safari > Настройки > Дополнения > Показывать функции для разработчиков. Название и состав меню разработчика отличаются в разных версиях Safari.
  2. Откройте вкладку Network.
  3. Очистите список запросов (Clear) > обновите страницу Ctrl/Cmd+R и воспроизведите ошибку.
  4. Экспортируйте логи через Сохранить все как HAR с содержимым (Save all as HAR with content) в Chromium или кнопка Экспортировать в Safari

Можно загрузить HAR в консоль разработчика для просмотра выгруженных сетевых запросов:
  1. Откройте консоль разработчика. Если нужно, предварительно очистите запросы кнопкой Clear (Очистить) наверху.
  2. На вкладке Network (Сеть) нажмите кнопку импорта HAR.

Стейт веб-/десктоп-приложения

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

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

Информация для разработчика (веб/десктоп)

Можно включить дополнительный пункт в контекстном меню сообщений и звонков для просмотра HUID отправителя сообщения, ID сообщения и прочей информации, которая может быть полезна для диагностики:
  1. Откройте инженерное меню: Настройки > О программе > многократно нажмите на логотип.
  2. Включите Инфо для разработчика в меню сообщения.
  3. Щёлкните правой кнопкой мыши любое сообщение или звонок в списке звонков и выберите Инфо для разработчика.

Файл log.log в папке десктоп-приложения

Содержит события, связанные с запуском, работой и обновлением приложения.

Если используется приложение-клиент для ETS, вместо eXpress будет другое название.
ОСРасположение файла log.log
Windows%USERPROFILE%\AppData\Roaming\eXpress\log.log
macOS~/Library/Logs/eXpress/log.log (через Переход > Переход к папке в Finder)
Linux~/.config/eXpress/log.log или
/home/ИМЯ_ПОЛЬЗОВАТЕЛЯ/.config/eXpress/log.log
(могут потребоваться права администратора)
С версии 3.37 файл log.log входит в состав диагностической информации, собранной на экране О программе.

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

Для анализа проблем с запуском десктоп-приложения (белый экран, зависания) и взаимодействия с операционной системой:

  1. Закройте приложение.
  2. Выполните следующие шаги:
    Если используется брендированное ETS-приложение, вместо eXpress будет другое название.
    ОС Шаги
    Windows

    1. Откройте командную строку: Win+R > введите cmd > Enter.

    2. Щёлкните ярлык приложения правой кнопкой мыши > Свойства > скопируйте путь к файлу .exe из поля Объект.

    3. В командную строку введите "скопированный_путь_к_eXpress.exe" --args --enable-logging --log-level=DEBUG (⚠️ путь должен быть в двойных кавычках, если содержит пробелы) и нажмите Enter.

    macOS

    1. Откройте приложение «Терминал».

    2. Введите cd /Applications и нажмите Enter.

    3. В терминал введите: open eXpress.app --args --enable-logging --log-level=DEBUG и нажмите Enter.

    4. Выведите лог в терминал: log stream --predicate 'process == "eXpress"' --style compact и нажмите Enter.

    Linux

    1. Откройте приложение терминала.

    2. Щёлкните ярлык приложения правой кнопкой мыши > Свойства > скопируйте путь к нему (например, из поля Команда на Astra Linux). Либо скопируйте путь к директории с приложением, а имя исполняемого файла допишите в конце пути.

    3. В терминал введите: "путь_к_приложению" --args --enable-logging --log-level=DEBUG (⚠️ путь должен быть в двойных кавычках, если содержит пробелы) и нажмите Enter.

  3. Воспроизведите проблему с приложением.
  4. Отправьте скриншот или листинг терминала/командной строки в поддержку.

Логи звонков и конференций

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

Логи звонков и конференций на Android

Логи сохраняются на вкладке LOG > Call log инженерного меню:

  1. Откройте инженерное меню: Настройки (аватар) > О программе > многократно нажмите на логотип.
  2. Нажмите SHARE CALL LOG FILE для сохранения или отправки лога.
Логи SIP-звонков на Android нельзя собрать задним числом — используются диагностические данные через «О программе», сбор которых нужно включать заранее.

Логи звонков и конференций на iOS/iPadOS

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

Логи звонков и конференций в веб-/десктоп-приложении

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

Уведомление «Оцените качество звонка»

Иногда по окончании звонка или конференции может отобразиться запрос с просьбой оценить качество связи и указать причины, если оно было неудовлетворительным.


При оценке меньше 5 (или нажатии Нет в уведомлении «Довольны ли вы качеством звонка?»):

  • Клиентские логи автоматически выгружаются на сервер
    RTS
    /
    CTS
    /
    eCTS
    , где их может просмотреть администратор или поддержка.
  • Они доступны администратору в папке client logs архива с логами.

Диагностика звонков веб-приложения в браузере

Если звонок в веб-приложении не устанавливается или идёт без звука и видео, соберите статистику медиасоединения. Она показывает, какие сетевые пути браузер пробовал и какие из них не сработали.

Браузер Как собрать
Google Chrome, Chromium, Microsoft Edge, Yandex Browser, Vivaldi, Opera Откройте новую вкладку с адресом chrome://webrtc-internals (в Edge — edge://webrtc-internals, в Yandex Browser — browser://webrtc-internals) до начала звонка, затем совершите звонок, раскройте на этой вкладке раздел Create a WebRTC-Internals dump и нажмите кнопку Download the "webrtc-internals dump"
Mozilla Firefox Откройте вкладку с адресом about:webrtc до начала звонка, совершите звонок и сохраните страницу кнопкой Сохранить страницу

Дополнительно приложите:

Серверные логи звонков и конференций

Администратору: серверные логи звонков и конференций eXpress (VoEx+SIP)
RTS
CTS
eCTS
  1. Соберите логи с сервера:
    Вид звонка Шаги
    VoEx В панели администратора: Звонки/Конференции > найдите по ID чата/звонка > нажмите Скачать логи. ID можно получить из лога звонка в инженерном меню приложения.
    SIP
    • До 3.63: соберите логи контейнера messaging.
    • 3.63 и выше: соберите логи контейнера sip_calls.
    Как собрать лог контейнера Docker
  2. Сделайте скриншот настроек Janus и VoEx/SIP из раздела VoEx панели администратора.
  3. Уточните версию Janus:
    Версия сервера Шаги
    3.60 и выше См. версию Janus в разделе «Сервер» в панели администратора.
    Ниже 3.60 Выполните docker ps -a на сервере VoEx/Front.
  4. Соберите логи Janus в Docker (опционально):
    docker logs -t voex-janus-1 &> /tmp/janus.log
    Если версия серверного ПО ниже 3.65, логи Janus должны содержать временные метки (timestamps).

Логи ботов и SmartApps

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

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

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

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

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

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

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

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

Информации в клиентских логах недостаточно для диагностики ботов, обязательно потребуются серверные логи.

Сбор клиентских логов закреплённых SmartApps на Android/iOS

  1. Откройте инженерное меню: Настройки (аватар) > О программе > многократно нажмите на логотип.
  2. Включите сбор логов SmartApps:
    • Android: LOG > SmartApps log > Write main log to file.
    • iOS/iPadOS и веб/десктоп: включите Собирать логи SmartApp (Collect Smart apps logs).
  3. Долго нажмите на закреплённый внизу SmartApp > Собрать логи.

Логи SmartApps на Android

  1. Откройте инженерное меню: Настройки (аватар) > О программе > многократно нажмите на логотип.
  2. Вкладка LOG > SmartApps log > включите Write main log to file.
    Для очистки логов: выключите и снова включите тумблер.
  3. Через кнопку-троеточие в SmartApp скачайте логи.

При проблемах на этапе запуска SmartApp:

  1. Откройте инженерное меню: Настройки (аватар) > О программе > многократно нажмите на логотип.
  2. Вкладка LOG > SmartApps log > включите Write main log to file.
  3. О программе > Начать сбор диагностических данных.
  4. Откройте проблемный SmartApp > подождите 15 секунд.
  5. О программе > Остановить и поделиться.

Логи SmartApps на iOS/iPadOS

  1. Откройте инженерное меню: Настройки (аватар) > О программе > многократно нажмите на логотип.
  2. Включите Собирать логи SmartApp
    Для очистки логов: выключите и снова включите тумблер.
  3. Через кнопку-троеточие в SmartApp скачайте логи.

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

  1. Откройте инженерное меню: Настройки (аватар) > О программе > многократно нажмите на логотип.
  2. Включите Собирать логи SmartApp
    Для предварительной очистки: Ctrl+R (Mac: Cmd+R)
  3. Если нужен режим отладки (необязательно): на вкладке SmartApps в инженерном меню включите Включить режим отладки SmartApps, укажите HUID бота SmartApp в соответствующее поле и нажмите кнопку Установить параметры отладки.
  4. Воспроизведите проблему и через кнопку-троеточие в SmartApp скачайте логи.

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

  1. Откройте инженерное меню: Настройки (аватар) > О программе > многократно нажмите на логотип.
  2. Включите сбор логов SmartApps:
    Платформа Путь
    Android LOG > SmartApps log > Write main log to file.
    iOS/iPadOS
    и веб/десктоп
    Включите Собирать логи SmartApp (Collect Smart apps logs).
  3. Соберите лог из SmartApp одним из способов:
    • Через кнопку-троеточие в SmartApp.
    • Долго нажмите на Главная или Сервисы > Собрать логи (мобильное приложение).
    • Откройте Сервисы (9 точек) > многократно нажмите на надпись Сервисы > в системном меню выберите Home Screen > три точки > Логи.

Серверные логи ботов и 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). В таком случае потребуются логи обоих этих контейнеров SmartApp.
  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/.

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

Администратору: уровни логирования
CTS
ETS
eCTS

Есть следующие уровни логирования серверных сервисов:

Уровень Описание
error Выводит только ошибки. Рекомендуется для систем с более чем 10 тыс. пользователей.
warning Оптимален для постоянной работы.
info Уровень по умолчанию для базовой диагностики.
debug Максимальная детализация. Не используйте постоянно: может вызывать зависание системы.

Как задать уровень логирования

Пример для сервиса интеграции с Active Directory (установка уровня debug):

Архитектура Команда
Docker docker exec -it cts-ad_integration-1 bin/ad_integration rpc "Logger.configure(level: :debug)" Где cts-ad_integration-1 — имя контейнера, ad_integration — имя бинарного файла.
Kubernetes kubectl exec -it {ad-integration} -- bin/ad_integration rpc "Logger.configure(level: :debug)" Где {ad-integration} — имя или ID пода.

Ожидаемый ответ: ok.


Уровень логирования можно задать только для сервисов на Elixir (ad_int, messaging, trusts и др.). Сервисы nginx, Kafka и подобные не поддерживают эту функцию.

Постоянное изменение уровня логирования

Архитектура Команды/шаги
Docker

Для конкретного контейнера (например, trusts) в файл /opt/express/settings.yaml добавьте:

trusts_env_override: LOGGER_LEVEL: debug

Где trusts_env_override — уникальная директива (должна быть единственной в файле). После изменений пересоберите контейнеры:

dpl -d trusts

Для изменения уровня логирования всех контейнеров добавьте в settings.yaml:

logger_level: debug
Kubernetes Изменение не рекомендуется.
Для постоянной работы используйте уровень warning, а не debug.
Администратору: логи Docker-контейнеров корпоративного сервера
CTS
ETS
eCTS

Чтобы собрать логи через панель администратора:

  1. Перейдите в раздел Контейнеры.
  2. Нажмите >_логи у нужного контейнера.
  3. Укажите дату и количество строк, снимите флажок follow (чтобы не получать сообщения в режиме реального времени) и нажмите show.

При переполнении буфера обмена старые логи перезаписываются. Логи очищаются при обновлении контейнера.

Сбор логов через консоль

Ключ tail выполняет вывод последних строк:

cd /opt/express && DPL_PULL_POLICY=never dpl --dc logs --tail=1000 ad_integration > logs.txt

Примеры для других сервисов:

cd /opt/express && DPL_PULL_POLICY=never dpl --dc logs --tail=1000 messaging > logs.txt cd /opt/express-voice && DPL_PULL_POLICY=never dpl --dc logs --tail=1000 coturn > logs.txt

Ключи since и until выводят логи за период:

cd /opt/express && DPL_PULL_POLICY=never dpl --dc logs --since=1h messaging cd /opt/express && DPL_PULL_POLICY=never dpl --dc logs --since=2025-01-27T07:10:00Z --until=2025-01-28T07:50:00Z messaging

Подробнее: документация Docker.

Администратору: логи контейнеров в подах Kubernetes
CTS
ETS
eCTS

Базовая информация: Kubernetes. Подробнее: kubectl logs.

  1. Получите список подов: kubectl get pods -n <namespace>

    Если подов с искомым контейнером несколько, следующие команды придётся выполнить для каждого из них.

  2. Включите режим INFO для контейнера внутри пода: kubectl -n <namespace> exec -ti <pod_id> -- bin/<service_name> rpc "Logger.configure(level: :info)"
  3. Воспроизведите проблему.
  4. Соберите логи: kubectl logs --tail=2000 -n <namespace> <pod_id> > pod_id.log
  5. Верните режим ERROR: kubectl -n <namespace> exec -ti <pod_id> -- bin/<service_name> rpc "Logger.configure(level: :error)"
  6. Передайте логи технической поддержке eXpress.
Администратору: диагностика сертификатов SSL
CTS
ETS
eCTS
⚠️ Некоторые инструменты могут быть недоступны из корпоративной сети.

Способы проверки:

Способ Шаги
Через браузер Откройте https://FQDN_сервера/system/settings/version и проверьте сведения о сертификате.
В браузерах Yandex Browser, Chromium GOST, «Атом» вшиты сертификаты российских УЦ, в том числе Минцифры, поэтому с их помощью нельзя проверить, установлены ли эти сертификаты в системе. Кроме того, если на ПК установлен антивирус Касперского или иное защитное ПО, может отображаться их сертификат вместо сертификата сервера.
С помощью онлайн-инструментов
  • SSL Server Test
    • В поле Hostname введите адрес сервера.
    • Чтобы просмотреть корневой центр сертификации сервера, наведите указатель на поле Issuer и в значении O= просмотрите организацию, выдавшую сертификат.
    • На этой странице сертификат оценивается по множеству критериев.
      ⚠️ Если сертификат имеет рейтинг ниже A+, с подключением к корпоративному серверу на мобильных устройствах могут наблюдаться проблемы.
  • SSL Checker
    • В поле Server Hostname введите адрес сервера и нажмите Enter.
    Данные ресурсы не могут использоваться для анализа сертификатов от российских УЦ или сертификатов серверов, доступ к которым закрыт для зарубежных IP-адресов.
Используя CURL В командной строке или терминале введите curl -vI https://адрес_сервера и нажмите Enter.

Версия и логи надстройки для Outlook

Версия MS Outlook

Чтобы просмотреть версию настольного приложения Outlook:

Версия Путь
Outlook для Windows В меню Файл откройте раздел Учетная запись Office.
Outlook для macOS Откройте меню Outlook и выберите О программе.

Версия надстройки

Чтобы просмотреть номер версии надстройки:

Версия Путь
Надстройка Outlook для Windows Чтобы просмотреть версию надстройки, наведите указатель мыши на кнопку надстройки.
OWA-версия надстройки (macOS) В главном представлении Outlook для Mac (список писем) нажмите кнопку Получить надстройки. На портале OWA войдите в свой аккаунт и в разделе Управление надстройками выберите надстройку.
Серверная часть надстройки Версию серверной части можно уточнить у системного администратора или специалиста технической поддержки/внедрения eXpress, установившего надстройку.
Администратору: просмотр версии серверного ПО надстройки Если есть доступ к серверу: http://адрес_сервера:порт/api/meetings/check
Обычно: http://адрес_сервера:7100/api/meetings/check
⚠️ Если клиентская и серверная части не совпадают по версии, отстающую часть необходимо обновить! Обратитесь в поддержку eXpress для получения помощи с обновлением.

Логи надстройки для Windows

Локальный лог надстройки, установленной через пакет MSI, находится здесь: C:\Logs\ExpressMeetingAddIn<дата>.log.


Уровень логирования настраивается в файле serilogSettings.json в папке установки надстройки. Если нужен полный подробный лог для отладки, задайте значение Verbose атрибутам MinimumLevel.Default и MinimumLevel.Override.Default в файле (не рекомендуется для постоянного использования: сильно увеличивает размер лога и может замедлить работу).


Также потребуется файл конфигурации ExpressMeeting.dll.config из папки установки надстройки (например, C:\Program Files\eXpress\ExpressMeeting).

Если используется брендированное приложение, вместо Express может быть другое название.


Логи надстройки для Outlook Web Access (macOS)

Клиентские логи надстройки для OWA отсутствуют. Для диагностики используются серверные логи.

Серверные логи надстройки Outlook

Администратору: сбор серверных логов надстройки

Логи серверной части надстройки, использующей аутентификацию AD, по умолчанию хранятся в следующей папке сервера:

C:/logs/core-service/

Путь к папке указывается в конфигурационном файле appsettings.Production.json в ключе:

Serilog.WriteTo[Name ="Logger"].Args.configureLogger.WriteTo[Name="File"]. Args.path

См. руководство по установке надстройки для администратора.

Чтобы собрать лог серверной части надстройки с аутентификацией Keycloak, выполните следующие команды:

docker logs express-meeting-core-service-main &> /tmp/core.log
docker logs express-meeting-template-service-main &> /tmp/template.log

Сведения о системе и логи установки приложения

Файлы с информацией о системе или процессе установки помогают сузить круг возможных причин технических неполадок. Собранную информацию о системе вы можете передать в поддержку eXpress.

С версии 3.25 в собранной через веб/десктоп диагностической информации будут отображаться оперативная память, разрешения монитора, процессор ПК. В логах звонков из инженерного меню будет та же информация, но она будет доступна только в скачанном логе звонка.

Сведения о системе MSInfo (Windows)

  1. Нажмите сочетание клавиш Windows + R.
  2. В окне «Выполнить» введите MSInfo32 и нажмите Enter.
  3. В окне «Информация о системе» нажмите на Сведения о системе, откройте меню Файл и выберите Экспорт.
  4. В появившемся окне «Экспортировать как» выберите Рабочий стол.
  5. Назовите файл MSInfo и нажмите Сохранить.

Чтобы уменьшить размер файла:

  1. Откройте сохранённый файл MSInfo в блокноте.
  2. Нажмите Ctrl + F и найдите [Windows Error Reporting] (Отчеты об ошибках Windows).
  3. Удалите весь текст, который идёт после первых десяти строк раздела [Windows Error Reporting].
  4. Сохраните файл.

Средство диагностики DirectX (Windows)

  1. Нажмите сочетание клавиш Windows + R.
  2. В окне «Выполнить» введите dxdiag и нажмите Enter.
  3. В окне «Средство диагностики DirectX» нажмите Сохранить все сведения.
  4. Назовите файл dxdiag и нажмите Сохранить.

Отчёт о системе (macOS)

  1. Откройте меню Apple и выберите Об этом Mac.
  2. Нажмите кнопку Отчет о системе или нажмите Подробнее и в окне настроек выберите Отчет о системе.
  3. Выберите Файл > Сохранить и сохраните файл на рабочий стол.

Информация о системе Linux (утилита inxi)

  1. Откройте терминал.
  2. Установите утилиту inxi командой sudo apt install inxi или sudo yum install inxi.
  3. Выполните команду inxi -Fxz.
  4. Сохраните вывод терминала в файл.

Логи установки пакета MSI на Windows

Чтобы собрать диагностику для процесса установки через установщик Windows, используйте следующую командную строку:

msiexec /i "installer.msi" /l*v "log.log"

Здесь installer.msi — путь к пакету MSI, log.log — путь создаваемого файла лога.