流媒体与实时通信 / 系统课时
把一次通话串成完整日志
把一次通话串成完整日志
一次 WebRTC 通话会同时产生信令、ICE、媒体轨道、编解码与 Stats 数据。要让故障能够沿时间线追踪,关键不是“多打日志”,而是让所有事件共享稳定的关联键,并保留会随通话阶段变化的网络与媒体快照。
学习目标
- 设计 session、peer、track、candidate 和 codec 的统一关联字段
- 区分稳定身份字段与会变化的运行时快照
- 用结构化日志把信令、ICE、媒体与 Stats 串成同一条时间线
先确定一组不会漂移的关联键
建议把 session_id 作为一次通话的根标识,peer_id 标识参与端,track_id 标识某条音频轨道。候选对和编解码器会在协商或网络切换时变化,因此应记录当前 candidate_pair_id 与 codec 快照,而不要把它们当成整场通话永远不变的主键。
| 字段 | 作用 | 生命周期 |
|---|---|---|
session_id |
串起整场通话 | 通话开始到结束保持不变 |
peer_id |
区分本端或远端参与者 | 对端实例存续期间稳定 |
track_id |
定位具体音频轨道 | 轨道创建到停止 |
candidate_pair_id |
指向当前选中的 ICE 路径 | 网络切换时可能变化 |
codec |
记录当前媒体编码 | 重新协商时可能变化 |

统一事件外壳,变化内容放进属性
每条日志都应带时间、事件名和核心关联键,再把状态、方向、网络类型等放进 attrs。这样查询某个 session_id 时可以按时间排序,也能继续按 track_id 或 candidate_pair_id 缩小范围。
下面的 Node.js 示例演示一个最小结构化日志器。保存为 log-demo.js 后可直接运行;时间戳是动态值,实际结果会不同。
const context = {
session_id: "session-001",
peer_id: "peer-a",
track_id: "audio-001",
candidate_pair_id: "cp-001",
codec: "opus/48000/2"
};
function writeLog(event, attrs = {}) {
const record = {
ts: new Date().toISOString(),
event,
...context,
attrs
};
console.log(JSON.stringify(record));
}
writeLog("peer_connected", { ice_state: "connected" });
writeLog("audio_track_active", { direction: "outbound" });
writeLog("candidate_pair_selected", { network_type: "wifi" });预期输出
{"ts":"<TIME>","event":"peer_connected","session_id":"session-001","peer_id":"peer-a","track_id":"audio-001","candidate_pair_id":"cp-001","codec":"opus/48000/2","attrs":{"ice_state":"connected"}}
{"ts":"<TIME>","event":"audio_track_active","session_id":"session-001","peer_id":"peer-a","track_id":"audio-001","candidate_pair_id":"cp-001","codec":"opus/48000/2","attrs":{"direction":"outbound"}}
{"ts":"<TIME>","event":"candidate_pair_selected","session_id":"session-001","peer_id":"peer-a","track_id":"audio-001","candidate_pair_id":"cp-001","codec":"opus/48000/2","attrs":{"network_type":"wifi"}}把信令、ICE、媒体和 Stats 放到同一时间轴
信令层记录 offer、answer、ICE candidate 收发与协商结果;连接层记录 iceConnectionState、选中候选对和网络切换;媒体层记录 track 创建、静音、结束与 codec;Stats 则按固定采样周期记录 RTT、抖动、丢包、字节数等指标。
真正有用的顺序是“状态变化优先、周期快照补充”。例如先看到 candidate_pair_selected,随后 RTT 升高,再出现音频卡顿告警,就能把现象定位到同一条网络路径,而不是在几份互不关联的日志里猜时间。
用三类查询验收关联设计
第一类按 session_id 拉出整场通话,检查事件是否能按时间还原;第二类按 track_id 只看音频轨道,确认媒体生命周期完整;第三类按 candidate_pair_id 对齐 ICE 切换与 Stats 波动。若任一关键事件缺少这些关联键,后续再多日志也难以稳定拼接。
当日志模型能同时回答“哪场通话、哪个端、哪条轨道、走哪条路径、当时用什么编码”时,一次通话才真正从分散记录变成可检索、可复现的完整证据链。