流媒体与实时通信 / 系统课时

把一次通话串成完整日志

把一次通话串成完整日志

一次 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 后可直接运行;时间戳是动态值,实际结果会不同。

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" });

预期输出

text
{"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 波动。若任一关键事件缺少这些关联键,后续再多日志也难以稳定拼接。

当日志模型能同时回答“哪场通话、哪个端、哪条轨道、走哪条路径、当时用什么编码”时,一次通话才真正从分散记录变成可检索、可复现的完整证据链。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

把一次通话串成完整日志

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通