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

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

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

Общие логи на iOS/iPadOS пишутся в файл, только пока включена запись логов. Включите её до того, как воспроизводить проблему:

1. Откройте инженерное меню: Настройки > О программе > многократно нажмите на логотип.
2. Включите переключатель Файловая запись логов.
3. Воспроизведите проблему.
4. Вернитесь в инженерное меню. В папке Логи нажмите кнопку «Поделиться» и выберите тип лога:

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

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

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

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

Диагностическая информация — база знаний, откроется в новой вкладке

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

1. Откройте консоль разработчика:

   Платформа	Путь
   Chromium-браузеры и десктоп-приложение	Нажмите F12. На Mac нажмите Cmd+Opt+I или выберите Консоль в меню приложения.
   Safari (macOS)	Нажмите Option + Cmd + C или щёлкните правой кнопкой мыши в любом месте страницы и выберите Проверить элемент. Если консоль не открылась, включите функции разработчика: Safari > Настройки > Дополнения > Показывать функции для разработчиков. Название и состав меню разработчика отличаются в разных версиях Safari.

2. Нажмите кнопку-шестерёнку в верхнем углу консоли и включите Отображать временные метки (Show timestamps)
3. Очистите консоль (Clear console) > воспроизведите ошибку
4. Сохраните логи через Сохранить как (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. Экспортируйте логи кнопкой со стрелкой вниз на панели вкладки Network — экспорт HAR. В старых версиях Chromium вместо неё пункт Сохранить все как HAR с содержимым (Save all as HAR with content) в контекстном меню списка запросов. В Safari — кнопка Экспортировать.

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

Можно добавить в контекстное меню сообщений и звонков пункт с HUID отправителя, ID сообщения и другими данными для диагностики:

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

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

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

ОС	С версии 3.74.41	До версии 3.74.41
Windows	%USERPROFILE%\AppData\Roaming\eXpress\logs\main.log	%USERPROFILE%\AppData\Roaming\eXpress\log.log
macOS	~/Library/Logs/eXpress/main.log	~/Library/Logs/eXpress/log.log
Linux	~/.config/eXpress/logs/main.log	~/.config/eXpress/log.log

На macOS откройте папку в Finder: Переход > Переход к папке. На Linux путь целиком начинается с /home/ИМЯ_ПОЛЬЗОВАТЕЛЯ/.config/eXpress/, для доступа могут потребоваться права администратора.

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

Логи запуска помогают разобрать проблемы с запуском десктоп-приложения (белый экран, зависания) и его взаимодействием с операционной системой. Чтобы собрать их:

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

   ОС	Шаги
   Windows	Откройте командную строку: Win+R > введите cmd > Enter. Щёлкните ярлык приложения правой кнопкой мыши > Свойства > скопируйте путь к файлу .exe из поля Объект. В командную строку введите "скопированный_путь_к_eXpress.exe" --enable-logging > "%USERPROFILE%\express-launch.log" 2>&1 и нажмите Enter. ⚠️ Если путь содержит пробелы, он должен быть в двойных кавычках.
   macOS	Откройте приложение «Терминал». В терминал введите: open -a eXpress --stderr ~/express-launch.log --args --enable-logging и нажмите Enter.
   Linux	Откройте приложение терминала. Щёлкните ярлык приложения правой кнопкой мыши > Свойства > скопируйте путь к нему. На Astra Linux путь указан в поле Команда. Либо скопируйте путь к директории с приложением и допишите в конце имя исполняемого файла. В терминал введите: "путь_к_приложению" --enable-logging > ~/express-launch.log 2>&1 и нажмите Enter. ⚠️ Если путь содержит пробелы, он должен быть в двойных кавычках.

3. Воспроизведите проблему с приложением.
4. Закройте приложение и отправьте в поддержку файл express-launch.log из папки пользователя.