诊断页
侧栏的「诊断」用来排查问题,手机上在「更多」里。它分六个子页:「日志」「信令」「AT 终端」「VoLTE 排查」「审计」「前端记录」。「信令」「AT 终端」「VoLTE 排查」作用于页面上选中的那台设备。
nSIM 的运行日志,实时滚动。
| 控件 | 作用 |
|---|---|
| 日志级别 | 「全部级别」「DEBUG 及以上」「INFO 及以上」「WARN 及以上」「ERROR」 |
| 按设备筛选 | 只看某台设备的日志 |
| 「搜索内容、来源…」 | 按关键字筛选 |
| 「跟随」 | 打开时自动滚到最新一条 |
| 「暂停」「继续」 | 暂停或恢复接收新日志 |
| 「进来时载入」 | 打开页面时先载入多少条历史 |
| 「最多往回翻」 | 页面上最多保留多少条 |
| 「复制」 | 把当前列表复制到剪贴板 |
| 「导出」 | 把当前列表下载成 logs-<日期>.txt |
| 「清空」 | 只清空页面上的列表,不删日志文件 |
| 「调试域」 | 展开调试域开关,见调试域 |
主机上也能看日志:Docker 部署时是 compose 目录下的 logs/app.log,按天轮转;也可以用 docker compose logs。
调试域是 VoWiFi 与 VoLTE 协议栈的详细日志开关,平时全关。在「日志」子页点「调试域」展开,点一个域开启,再点一次关闭。
| 域 | 记什么 | 什么时候开 |
|---|---|---|
ike |
隧道协商、重协商、保活 | VoWiFi 隧道建不起来或频繁断开 |
esp |
隧道里加密数据包的封装与解封 | 同上 |
sip |
SIP 信令的收发 | 来电、去电、短信失败 |
reg |
IMS 注册与鉴权 | IMS 注册失败 |
sms |
短信的编解码与投递状态 | VoWiFi 或 VoLTE 短信收发异常 |
call |
呼叫状态与媒体协商 | 通话建立或挂断异常 |
rtp |
逐个语音数据包,约每 20 毫秒一条 | 接通但没声音、单向通话 |
media |
转码、重排、抖动与桥接 | 同上 |
tcp |
协议栈内部的 TCP 连接 | 被要求时开 |
wire |
原始字节,最吵的一个 | 被要求时开,通常与别的域一起开 |
- 「当前生效」写着正在开着的域,全关时写「全部停用」。
- nSIM 重启后,调试域全部停用。
- 开着
rtp或media时,日志量会暴涨,页面会提示用完停用。复现完问题马上关掉。
要排查 nSIM 刚启动时的问题,界面那时还打不开,可以在配置文件的 server.debug_domains 里预先写上,例如 "ike,esp"。排查完清空。见配置文件。
「IMS 信令流」显示所选设备 VoWiFi 或 VoLTE 的 SIP 信令,包括注册、呼叫和短信。每条标「收到」或「发出」。
- 用「筛选方法、摘要…」按方法或摘要筛选。
- 点一条看「完整报文」,点「复制报文」复制原文。
信令里有本机号码、对方号码和 IMSI。
向所选模组直接发 AT 命令并查看回复。只对模组有效,读卡器没有 AT 口。用法见给模组发 AT 命令。
VoLTE 排查
Section titled “VoLTE 排查”所选模组 VoLTE 各阶段的状态,用来判断 VoLTE 卡在哪一步。读卡器没有蜂窝射频,不适用。见开启 VoLTE。
「审计日志」记录所有写操作:谁在什么时间做了什么。
- 「来源」分「网页登录」「API Key」「系统」「鉴权失败」四类。「系统」是自动化脚本、定时短信等 nSIM 自己发起的动作;「鉴权失败」是凭据不对、被拒绝的请求。
- 点一条看是哪把 API Key 或哪个自动化脚本做的。
- 打开「只看危险操作」,只列会产生费用、作用到真实网络或不能撤销的操作。
- 详情里有:时间、来源、操作者、动作、请求、状态码、IP、IMEI、ICCID、请求 ID。
- 「设备 ID 改名记录」列出设备 ID 的改名历史。
审计日志的保留期在「设置 › 数据与备份」里改,默认值见数据保留。
当前这个浏览器里最近的页面跳转、接口错误、前端错误与登录事件。用来排查「点了没反应」这类界面问题。
- 「复制到剪贴板」「导出为文件」把记录交给别人看。导出的文件名形如
debug-<时间>.json。 - 打开「出错时自动打开」后,界面一出错就弹出这份记录。
- 在任何页面上按
Ctrl+Shift+D都能打开它。
这些记录只存在这个浏览器里,每台设备各一份。手机上的问题要在那部手机上导出。
导出前抹掉的信息
Section titled “导出前抹掉的信息”日志、信令和审计记录里可能有这些信息。发给别人之前逐行检查,替换成占位值:
| 信息 | 常见位置 |
|---|---|
| 手机号码、短信正文 | 日志、信令 |
| IMSI、ICCID、EID、IMEI | 日志、信令、审计 |
| 公网 IP 地址 | 日志、审计 |
| API Key、通知渠道的 token 与密钥 | 日志、你自己的脚本与配置 |
| SIP 报文里的鉴权信息 | 信令 |
- 「设置 › 外观」里的「隐藏号码与卡号」只改界面显示,对导出的文字不起作用。截图前打开它。
- 前端记录导出时会遮掉登录凭据和中国大陆格式的手机号,其他格式的号码不处理。
- 不要把备份包或配置文件当诊断材料发出去。它们包含全部数据和登录凭据。
求助前要准备哪些材料,见求助前收集信息。