Оперативная миграция с Microsoft Teams и Skype for Business

Блог

Вернуться

Какие логи необходимы при оформлении заявки в отдел технической поддержки

27.04.2023
Димитрий Зуйков

Димитрий Зуйков

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

TrueConf Server

Файлы логов сохраняются в рабочей директории сервера (по умолчанию С:\TrueConf) на ОС Windows или по пути /opt/trueconf/server/var/log на ОС семейства Linux.

Общие проблемы

Перед сбором и отправкой логов убедитесь, что на сервере включено подробное логирование.

Возможная проблема, с которой вы могли бы столкнуться – невозможность запустить TrueConf Server. Одна из возможных причин описана в нашем блоге. Общая информация о работе сервера (запуск, перезапуск, остановка и др.) сохраняется в файле Stdout.log в рабочей директории на ОС Windows, или /opt/trueconf/server/var/log/vcs/stdout.log на ОС семейства Linux. Эти данные могут быть полезны для анализа таких проблем, как:

Проблемы с SMTP рассылкой

Перед сбором и отправкой логов убедитесь, что на сервере включено подробное логирование.

При возникновении проблем с подключением к SMTP-серверу и рассылкой email-приглашений в конференцию, необходимую информацию можно получить в папке web_logs в рабочей директории сервера на ОС Windows или /opt/trueconf/server/var/log/webmanager на ОС семейства Linux.

Проблемы во время видеоконференций

Перед сбором и отправкой логов убедитесь, что на сервере включено подробное логирование.

В ходе проведения видеоконференций также могут возникать трудности:

В заявке для отдела технической поддержки укажите:

  1. Точное время воспроизведения проблемы.
  2. TrueConf ID пользователей, у которых наблюдалась проблема.
  3. Информацию о конференции:
    • тип конференции;
    • режим запуска конференции;
    • количество приглашённых/подключенных участников.
  4. Способ подключения пользователей к конференции: через клиентское приложение TrueConf или с помощью WebRTC.

В качестве вложения приложите:

  • Stdout.log и папку svc_logs из рабочей директории на ОС Windows, или папку /opt/trueconf/server/var/log/vcs/svc_logs на ОС Linux. Она содержит логи о проведённых видеозвонках и видеоконференциях.
  • папку transceiver_logs из рабочей директории на ОС Windows, или папку /opt/trueconf/server/var/log/vcs/transceiver_logs на ОС Linux. В ней находятся логи о транскодировании, микшировании и пересылке медиаданных в связке с WebRTC, SIP/H.323/RTSP терминалами, RTSP-вещании.

В случае аварийного завершения работы служб TrueConf также предоставьте архив с файлами дампов из папки dumps из рабочей директории на ОС Windows, или из папки /opt/trueconf/server/var/dump на ОС Linux.

Проблемы во время вызова SIP/H.323/RTSP устройств

Перед сбором и отправкой логов убедитесь, что на сервере включено подробное логирование.

Выявление и анализ проблем, связанных с трудностями вызова SIP/H.323/RTSP устройств, может потребовать установки дополнительного программного обеспечения WireShark для захвата трафика.

Возможными проблемами могут оказаться:

  • прерывание вызова по протоколу SIP/H.323/RTSP;
  • невозможность вызова SIP/H.323/RTSP устройства;
  • пониженное качество аудио/видео потока;
  • прерывание/пропадание аудио/видео потока;
  • невозможность показа контента на SIP/H.323 устройства;
  • проблемы с использованием SIP/H.323 шлюза.

В этом случае требуется дополнительно собрать TCP-дампы.

Сбор TCP-дампов на Windows

  1. На компьютере, где установлен TrueConf Server, установите Wireshark.
  2. Запустите Wireshark с правами администратора.
  3. Начните захват пакетов и воспроизведите указываемую проблему.

wireshark

  1. Как только проблема будет воспроизведена, остановите сбор данных и сохраните их комбинацией клавиш Ctrl+Shift+S.

Сбор TCP-дампов на ОС семейства Linux
На Linux рекомендуется использовать консольную утилиту tcpdump.

  1. Откройте терминал (консоль).
  2. Установите tcpdump. Для большинства ОС он доступен прямо из репозиториев, например, на Debian устанавливается с помощью команды:
  3. От имени администратора запустите сбор сетевого трафика с помощью одной из команд:
    • проходящего через все сетевые устройства

      где /path/dump.pcap – название файла для сохранения дампов и полный путь к нему, если надо чтобы он сохранялся не в текущей папке;
    • проходящего через конкретное сетевое устройство

      где eth0 – название сетевой карты в ОС. Получить список устройств и их статус можно с помощью команды ip address.
  4. Находясь в консоли, нажмите комбинацию клавиш Ctrl + C, чтобы завершить процесс сбора дампов и сохранить их в указанном выше файле.

При оформлении заявки в отдел технической поддержки приложите набор логов:

  • сохранённый на предыдущем шаге файл TCP-дампов с разрешением .pcapng (в случае использования Wireshark) или .pcap (в случае работы с утилитой tcpdump);
  • Stdout.log;
  • gateway.pcap;
  • папку svc_logs из рабочей директории на ОС Windows, или папку /opt/trueconf/server/var/log/vcs/svc_logs на ОС Linux;
  • папку transceiver_logs из рабочей директории на ОС Windows, или папку /opt/trueconf/server/var/log/vcs/transceiver_logs на ОС Linux.

В заявке также укажите перечень данных:

  • точную дату и время воспроизведения проблемы;
  • TrueConf ID и/или IP адрес терминала, с которым наблюдаются проблемы.

Панель управления и личный кабинет

Некоторые ошибки могут быть связаны с отображением веб-страниц TrueConf Server, например:

  • некорректное отображение данных или ошибки при сохранении изменений в панели управления;
  • проблемы в работе личного кабинета;
  • некорректное отображение гостевой страницы или страницы конференций.

Такие ошибки могут быть связаны с обработкой API запросов. В решении неисправности может помочь сбор логов формата .har, с их помощью можно увидеть какие именно запросы вызывают ошибку. Для сбора логов в формате .har существует встроенный в браузер инструмент, покажем на примере браузера Google Chrome.

  1. Нажатием клавиши F12 перейдите в инструмент разработчика.
  2. Перейдите во вкладку Сеть.
  3. Очистите сетевой журнал нажав на кнопку Какие логи необходимы при оформлении заявки в отдел технической поддержки 1.
  4. Отметьте флажки Сохранить журнал и Отключить кэш.
  5. Воспроизведите условия при которых возникает проблема.
  6. Нажмите правой кнопкой мыши на любой файл в списке, выберите вариант Сохранить все как HAR с содержимым.
  7. Выберите путь для сохранения .har архива.

С примерами сбора .har логов в других браузерах можно ознакомиться на сайте «Лаборатории Касперского».

Неполадки при работе клиентских приложений

Возможные проблемы:

  • некорректный запуск приложения;
  • мгновенное или незапланированное завершение приложения;
  • проблемы, связанные с аппаратной частью работы приложения.
При аварийном завершении работы десктопного приложения (для Windows, macOS, Linux) отправьте автоматически созданное письмо.
Иначе для сбора логов выполните следующие шаги в зависимости от используемой ОС.

Клиентское приложение TrueConf для Windows

Подготовьте лог-файл конфигурации клиентского приложения TrueConf:

  1. Откройте командную строку (cmd).
  2. Введите "C:\Program Files\TrueConf\Client\TrueConf.exe" -hwtest
  3. В папке текущего пользователя (по умолчанию C:\Users\<имя_пользователя>) по пути \AppData\Local\TrueConf\Client будет сформирован конфигурационный файл tc_configuration.txt

Лог-файлы клиентское приложение формирует автоматически. Вы можете найти их по пути:

C:\Users\<имя_пользователя>\AppData\Local\TrueConf\Client\logs

Для быстрого перехода в папку C:\Users\<имя_пользователя>\AppData\Local\ введите %localappdata% в адресное поле проводника и нажмите клавишу Enter.

Клиентское приложение TrueConf для macOS

Подготовьте лог-файл конфигурации клиентского приложения TrueConf:

  1. Перейдите в папку /Applications/Utilities и запустите Terminal.app.
  2. Откройте папку /Applications и найдите TrueConf Client.app.
  3. Вызовите контекстное меню и выберите пункт Показать содержание пакета.
  4. Перенесите TrueConf Client.app в окно терминала.
  5. Введите параметр /hwtest в конце команды и нажмите Enter.
    Стоит иметь в виду, что во время формирования файла конфигурации в терминал будет выводиться служебная информация – это нормальное поведение.
  6. В поисковой строке проводника введите tc_configuration.txt для извлечения файла.

Лог-файлы клиентское приложение формирует автоматически. Вы можете найти их по пути:

Users/<имя_пользователя>/Library/Containers/org.trueconf.client/Data/Library/Application Support/TrueConf/Logs

Обратите внимание, что директория /Library/ по умолчанию скрыта. Для перехода в неё откройте приложение Finder и выберите пункт меню Переход → Переход к папке. В появившемся окне введите ~/Library и нажмите Перейти.

Клиентское приложение TrueConf для Linux

Подготовьте лог-файл конфигурации клиентского приложения TrueConf

Для этого откройте терминал, введите строку trueconf -hwtest и нажмите Enter. В каталоге ~/ будет сформирован конфигурационный файл tc_configuration.txt

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

Во время работы клиентское приложение автоматически формирует лог-файлы по пути:

~/.config/trueconf/logs

Учтите, что директория ~/.config по умолчанию может быть скрытой и не показываться в файловом менеджере, тогда в его настройках потребуется включить отображение скрытых файлов.

Проблемы с аудиопотоками

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

К примеру, эта опция будет полезна при возникновении следующих проблем:

  • Вы или ваш собеседник слышите эхо во время разговора.
  • Речь передаётся прерывисто, часть фраз пропадает.
  • Видео и звук не синхронизированы.
  • Речь передаётся с заиканием.
  • Речь вообще не передаётся, хотя динамик/микрофон включен.
Аудиодампы начнут формироваться сразу же после активации опции. Данный функционал доступен с версии клиентского приложения 8.2.

Какие логи необходимы при оформлении заявки в отдел технической поддержки 2

Файлы дампов памяти будут сохраняться:

  • на ОС Windows – в папке текущего пользователя (по умолчанию C:\Users\<имя_пользователя>) по пути \AppData\Local\TrueConf\Client
  • на ОС семейства Linux – в каталоге ~/.config/trueconf/logs
  • на macOS – в папку Users/<имя_пользователя>/Library/Containers/org.trueconf.client/Data/.

Данные файлы будут иметь расширение .pcm. Также в ту же папку добавится один файл с расширением .log, в котором будут содержаться подробные логи о работе аудиоустройств.

Если проблема с аудио носит регулярный характер, требуется собрать более детальные файлы дампов. Для этого запустите приложение с параметром --log=1 и активированным флажком Создавать файлы дампа для диагностики аудио. Пользуйтесь приложением до воспроизведения проблем и приложите к обращению в поддержку собранные файлы .pcm и .log.

Проблемы с трансляцией видеофайлов

Если возникла проблема с трансляцией видеофайла в конференцию, то при обращении в поддержку обязательно необходимо приложить соответствующие логи. В ОС Windows логи видеотрансляции по умолчанию располагаются в папке текущего пользователя (C:\Users\<имя_пользователя>) по пути:

\AppData\Local\TrueConf\Client\winExtensionsUWPlogs

Приложения для других ОС на данный момент не поддерживают генерацию логов трансляции видеофайла.

При оформлении заявки в техническую поддержку приложите архив указанной выше папки.

TrueConf MCU

Для скачивания архива со всеми системными логами нажмите на вкладку Администрирование панели управления TrueConf MCU и выберите пункт Импорт/Экспорт. Далее выберите вкладку Логи сервера и нажмите кнопку Экспортировать. В открывшемся окне укажите место, куда вам удобно сохранить архив.

Дополнительно при обращении в техподдержку следует указать:

  • Зарегистрирован ли MCU на SIP-сервере или H.323-гейткипере.
  • Протокол, использовавшийся при вызове.
  • В каком направлении совершался звонок, когда вы собирали информацию.
  • Битрейт.
  • Модели и IP-адреса устройств, участвовавших в звонке.

TrueConf Room

Во время работы TrueConf Room лог-файлы формируются автоматически по пути:

  • на ОС Windows C:\Users\<имя_пользователя>\AppData\Local\TrueConf\Room\logs
  • на ОС Linux /home/$USER/.config/trueconf/room/logs

В случае аварийного завершения работы программы дополнительно создаются логи в каталоге:

  • на ОС Windows C:\Users\<имя_пользователя>\AppData\Local\TrueConf\Room\crashlogs
  • на ОС Linux /home/$USER/.config/trueconf/room/crashlogs

TrueConf Group

Скачивание консольных логов и записей трафика терминала осуществляется через его веб-интерфейс.

Для сбора консольных логов:

  1. Перезагрузите терминал, чтобы очистить файлы логов от ненужной информации.
  2. Воспроизведите возникшую неполадку.
  3. Нажмите кнопку Настройки в правом верхнем углу веб-интерфейса и выберите Диагностика в левой боковой панели.
  4. В подразделе Системный журнал сохраните файлы syslog, user.log и vita.log, используя контекстное меню браузера.

Какие логи необходимы при оформлении заявки в отдел технической поддержки 3

Сбор записей трафика происходит на этой же странице ниже:

  1. В подразделе Журнал сетевых пакетов нажмите кнопку Начать.
  2. На самом терминале позвоните нужному абоненту, либо ответьте на звонок.
  3. После завершения звонка нажмите на кнопку Остановить.

Какие логи необходимы при оформлении заявки в отдел технической поддержки 4

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

Скачайте запись, нажав на кнопку Какие логи необходимы при оформлении заявки в отдел технической поддержки 5 справа от нужного файла. Чтобы сохранить несколько записей, отметьте их флажками слева от их порядкового номера и нажмите на кнопку Скачать выбранные записи трафика.

Также при оформлении заявки в отдел технической поддержки необходимо указать:

  • Зарегистрирован ли терминал на TrueConf Server или MCU.
  • Протокол, использовавшийся при вызове.
  • В каком направлении совершался звонок, когда вы собирали информацию.
  • Битрейт.
  • Модели и IP-адреса устройств, участвовавших в звонке.

TrueConf Kiosk

Лог-файлы для TrueConf Kiosk также формируются автоматически при каждом запуске.

Адрес, по которому можно найти лог-файлы:

C:\Users\<имя_пользователя>\AppData\Roaming\TrueConf\TrueConf SDK for Windows

TrueConf Tracker

Для формирования логов во время работы TrueConf Tracker выполните следующее:

  1. Запустите TrueConf Tracker.
  2. В Панели Инструментов выберите Инструменты (Tools) – Показать лог (Show log).
  3. Воспроизведите проблему.
  4. После воспроизведения проблемы нажмите Сохранить (Save) и укажите папку для сохранения файла.

TrueConf для Android

В приложении для Android сбор логов осуществляется автоматически в ходе работы приложения. Если вы хотите скачать или же отправить их напрямую нашим специалистам вам необходимо сделать следующее:

  1. Откройте главное меню с помощью кнопки Какие логи необходимы при оформлении заявки в отдел технической поддержки 6.
  2. В открывшемся меню выберите пункт Настройки.
  3. Какие логи необходимы при оформлении заявки в отдел технической поддержки 7

  4. В конце списка в пункте Расширенные настройки нажмите кнопку Еще.
  5. Пролистайте появившийся список до пункта Системный лог.
  6. Для анализа проблем со звуком активируйте флажок Проверка эхоподавления. Тогда к основному отчету будут добавлены логи работы эхоподавления.
  7. Нажмите кнопку Сбор лога.
  8. В появившемся окне выберите тот пункт, что вам необходим – загрузить логи в память телефона для последующей отправки (Скопировать на SD), либо отправить сразу через предлагаемые методы (Отправить).

TrueConf для iOS/iPadOS

Отправка логов работы приложения

  1. На вашем устройстве откройте приложение TrueConf.
  2. Перейдите в Настройки → О нас.
  3. Нажмите кнопку Поделиться логами.
  4. Выберите имеющийся на устройстве почтовый клиент, например, Почта или Gmail.
  5. Обязательно своими словами в тексте письма опишите последовательность действий, которая привела к проблеме и отправьте заявку на crash@trueconf.com.
Сбор логов приложения недоступен для гостевых подключений, то есть при участии в мероприятии без авторизации на сервере видеосвязи.

Отправка crash логов 

Для отправки crash логов:

  1. Перейдите в Настройки → Конфиденциальность → Аналитика и улучшения → Данные  аналитики.
  2. В поиске введите trueconf. Список обновится.
    Имена файлов crash логов будут иметь вид TrueConf-дата-время.ips, например:
  3. Выберите необходимый файл, нажмите кнопку Какие логи необходимы при оформлении заявки в отдел технической поддержки 8 в верхнем правом углу экрана.
  4. Обязательно своими словами в тексте письма опишите последовательность действий, которая привела к проблеме и отправьте заявку на crash@trueconf.com.

Чтобы в дальнейшем crash логи отправлялись автоматически:

  1. Перейдите в Настройки → Конфиденциальность → Аналитика и улучшения.
  2. Активируйте переключатель Делиться для iPhone (также может иметь название Делиться для iPhone и часов).

 


Не нашли ответ на свой вопрос? Напишите нам в онлайн-чате, мы будем рады помочь.

Подписка на новости