HowTo文档

如何在 XSwitch 中下载日志

在使用XSwitch过程中，难免会遇到一些棘手的问题，请先参考在安装或使用XSwitch时遇到问题我改怎么办？中思路解决问题。若问题仍然无法得到解决，一份XSwitch的日志以及清晰的问题描述，将对我们解决问题起到至关重要的作用。

取XSwitch的呼叫日志通常有两种办法，若问题可重复出现，则可选择控制台下载的方式获取日志；若问题发生在过去，且无法人工模拟重复出现，则可选择调取原始日志方式获取日志。

控制台下载日志

若您的问题可复现，则选择此方式较为简便。

使用浏览器打开Xswitch管理界面，依次打开【高级】⇨【扩展功能】⇨【终端】，如下图所示：

download-logs-terminal

若您是运营商或其他形式的SIP呼叫，请点击上图中的【SIP Flow】选项，并在输入框内输入sofia global siptrace on同时回车确认。

若您是通过浏览器或其他形式的WebRTC呼叫，请在输入框内输入verto debug 7同时回车确认。

一切准备就绪后，请发起呼叫，直至复现您遇到的问题（在这期间请勿点击【暂停】或【清屏】按钮），点击上图中的【下载】按钮，XSwitch的呼叫日志即可下载到您本地电脑上，请将此日志发给我们的工程师。

待一切完成后，若您当时在输入框内输入的为sofia global siptrace on，那么请再次在输入框内输入sofia global siptrace off以及回车，以关闭SIP日志；若您当时在输入框输入的为verto debug 7，那么请再次在输入框内输入verto debug 0以及回车，以关闭Verto日志。

调取原始日志

若您的问题复现难度较大，则选择此方式较为稳妥。

使用ssh登录您的XSwitch所在服务器，并执行如下命令查看XSwitch容器：

[root@MiWiFi-RA80-srv xswitch-community-6.0.7]# docker ps
CONTAINER ID   IMAGE                                                          COMMAND                  CREATED       STATUS         PORTS     NAMES
07bb6bb8cc06   ccr.ccs.tencentyun.com/free/xswitch-community:6.1.2-bookworm   "/docker-entrypoint.…"   2 weeks ago   Up 4 seconds             xswitch
6a35a2242b80   ccr.ccs.tencentyun.com/free/xswitch-pg:15.2                    "docker-entrypoint.s…"   2 weeks ago   Up 9 seconds             xswitch-pg

并执行如下命令进入XSwitch容器的log目录下：

docker exec -it xswitch bash
cd /usr/local/freeswitch/log/

在当前目录下，您可看到多个以freeswitch.log开头的日志文件，如freeswitch.log.2024-07-01-16-29-37.1，它表示的意思是此日志文件最后写入时间为2024年07月01日16点29分37秒。

请确认您的问题发生时间，拿着时间去当前目录下查找日志。假设目标日志文件名为freeswitch.log.2024-07-04-11-57-45.1，在宿主机上执行如下命令即可将日志文件拷贝到宿主机上：

docker cp xswitch:/usr/local/freeswitch/log/freeswitch.log.2024-07-04-11-57-45.1 /tmp/

此时目标日志文件位于宿主机的/tmp/文件夹下，请将其发给我们的工程师。

问题描述

无论以何种方式获取到XSwitch日志文件后，请用简短的话描述您遇到的问题，并尽可能多的提供呼叫相关信息，如UUID、主叫号码、被叫号码、呼叫流程、呼叫时间等，相信必将事半功倍。若您不清楚如何描述问题，请参考如何提问。

如何在XSwitch中使用mod_unimrcp