跳转到内容

诊断页

侧栏的「诊断」用来排查问题,手机上在「更多」里。它分六个子页:「日志」「信令」「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 各阶段的状态,用来判断 VoLTE 卡在哪一步。读卡器没有蜂窝射频,不适用。见开启 VoLTE。

「审计日志」记录所有写操作:谁在什么时间做了什么。

  • 「来源」分「网页登录」「API Key」「系统」「鉴权失败」四类。「系统」是自动化脚本、定时短信等 nSIM 自己发起的动作;「鉴权失败」是凭据不对、被拒绝的请求。
  • 点一条看是哪把 API Key 或哪个自动化脚本做的。
  • 打开「只看危险操作」,只列会产生费用、作用到真实网络或不能撤销的操作。
  • 详情里有:时间、来源、操作者、动作、请求、状态码、IP、IMEI、ICCID、请求 ID。
  • 「设备 ID 改名记录」列出设备 ID 的改名历史。

审计日志的保留期在「设置 › 数据与备份」里改,默认值见数据保留。

当前这个浏览器里最近的页面跳转、接口错误、前端错误与登录事件。用来排查「点了没反应」这类界面问题。

  • 「复制到剪贴板」「导出为文件」把记录交给别人看。导出的文件名形如 debug-<时间>.json。
  • 打开「出错时自动打开」后,界面一出错就弹出这份记录。
  • 在任何页面上按 Ctrl+Shift+D 都能打开它。

这些记录只存在这个浏览器里,每台设备各一份。手机上的问题要在那部手机上导出。

日志、信令和审计记录里可能有这些信息。发给别人之前逐行检查,替换成占位值:

信息 常见位置
手机号码、短信正文 日志、信令
IMSI、ICCID、EID、IMEI 日志、信令、审计
公网 IP 地址 日志、审计
API Key、通知渠道的 token 与密钥 日志、你自己的脚本与配置
SIP 报文里的鉴权信息 信令
  • 「设置 › 外观」里的「隐藏号码与卡号」只改界面显示,对导出的文字不起作用。截图前打开它。
  • 前端记录导出时会遮掉登录凭据和中国大陆格式的手机号,其他格式的号码不处理。
  • 不要把备份包或配置文件当诊断材料发出去。它们包含全部数据和登录凭据。

求助前要准备哪些材料,见求助前收集信息。