Сбор отчетов об ошибках¶

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

Формирование отладочных логов и дампа трафика¶

Включите вывод отладочной информации в лог, добавив параметр в файл настроек /usr/local/FlashphonerWebCallServer/conf/flashphoner.properties
```
client_log_level=DEBUG
```
Перезапустите WCS командой
```
sudo systemctl restart webcallserver
```
Запустите сбор дампа трафика командой
```
sudo tcpdump -i any -s 0 -B 10240 -w log.pcap
```
Воспроизведите зафиксированную Вами ошибку
Остановите сбор дампа трафика нажатием Ctrl+C в окне терминала, где был запущен tcpdump.

Сбор отладочных логов при помощи скрипта report.sh (предпочтительый способ)¶

Начиная с версии 5.2.241, имеется возможность собрать логи, выполнив следующие команды

cd /usr/local/FlashphonerWebCallServer/tools
sudo ./report.sh --sysinfo --conf --tar

Скрипт соберет текущие логи и отобразит результат:

Scheduled report:

* logs
* netstat
* lsof
* pmap
* jstack
* sysinfo
* conf
* tar

Progress:

[DONE] logs
[DONE] netstat
[DONE] lsof
[DONE] pmap
[DONE] jstack
[DONE] sysinfo
[DONE] conf
[DONE] tar
Report complete in 15 seconds. Check /usr/local/FlashphonerWebCallServer/report/report-2019-07-17-10-28-35

В данном примере, архив с собранными логами располагается по следующему пути

/usr/local/FlashphonerWebCallServer/report/report-2019-07-17-10-28-35.tar.gz

Сбор статистики работы WCS¶

Начиная со сборки 5.2.967, в отчет может быть включена текущая статистика работы сервера:

cd /usr/local/FlashphonerWebCallServer/tools
sudo ./report.sh --sysinfo --conf --stats --tar

Сбор отладочных логов в ручном режиме¶

Если WCS сервер не запущен, скрипт report.sh не будет работать. В этом случае необходимо вручную найти и скопировать логи:

Перейдите к расположению сегодняшних логов, например
```
cd /usr/local/FlashphonerWebCallServer/logs/client_logs/2018-04-19
```

Выведите список логов на экран, отсортировав его по времени модификации командой

ls -lt

Примерный результат:

├── 13i19gto2ob34utrfs6v2er1it-11-11-11
│ ├── client-13i19gto2ob34utrfs6v2er1it-2018.04.19.12.16.08-1524118568678.report
│ └── flashphoner.log
├── 7g2hq7ah5sda3r108917v15k4c-11-10-46
│ ├── client-7g2hq7ah5sda3r108917v15k4c-2018.04.19.12.16.07-1524118567482.report
│ ├── flashphoner.log
│ └── flashphoner.log.2018-04-19-11

Здесь

13i19gto2ob34utrfs6v2er1it-11-11-11 - каталог с отладочным логом для первого клиентского соединения.
7g2hq7ah5sda3r108917v15k4c-11-10-46 - каталог с отладочным логом для второго клиентского соединения

Сбор отчета с профилированием памяти¶

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

Переключить WCS на использование нативных библиотек с отладочной информацией
```
sudo ./webcallserver use-debug-libs enable
```
Переключить WCS на использование библиотеки jemalloc в режиме профилирования памяти
```
sudo ./webcallserver use-jemalloc profile
```
Перезапустить WCS
```
sudo ./webcallserver restart
```
и воспроизвести проблему
Остановить WCS
```
sudo ./webcallserver stop
```

Переключить WCS в обычный режим запуска

sudo ./webcallserver use-jemalloc disable
sudo ./webcallserver use-debug-libs disable

Запустить WCS
```
sudo ./webcallserver start
```

Собрать отчет

cd /usr/local/FlashphonerWebCallServer/tools
sudo ./report.sh --sysinfo --conf --tar

Затем необходимо отправить отчет, как описано ниже.

Формирование отчета об ошибке¶

Отчет об ошибке должен включать:

Если отчет был собран при помощи скрипта report.sh:
архив, созданный скриптом report.sh
дамп трафика
Если отчет был собран в ручном режиме:
Клиентские отладочные логи
Файл /usr/local/FlashphonerWebCallServer/logs/server\_logs/flashphoner.log
Каталог /usr/local/FlashphonerWebCallServer/conf
Результат выполнения команды ifconfig на Вашем сервере
Результат выполнения команды iptables -L на Вашем сервере
дамп трафика

Отправка отчета¶

Архив отчета должен быть отправлен в техническую поддержку. Если размер архива превышает 30 M, поместите архив в облачное хранилище и пришлите ссылку на него.