故障排查

没有用量或字段不完整

检查所选用户、日期范围及统计时区。在数据源中核对启用、发现路径、真实非空记录、记录版本和诊断。空会话没有可采集的用量，已知模型也不能补齐缺失的 token 字段。

客户端比矩阵已核验版本更新时，兼容解析可能保留有效观测并标注版本未核验。报告时保留精确版本及记录格式，不因一项字段缺失就将整个产品标为不支持。

更新到最新 Release，刷新并查看采集进度。大量历史记录可能需要多轮扫描才能回填；读取器优先访问尚未处理的文件，以便采集今天的记录。请保留已有数据库。问题持续时参阅恢复说明。

适配器不限定 Community 或按年份的安装目录。检查进程/用户 TMP、TEMP traces 位置，并使用客户端指南中的只读 vswhere 核查工具。 TEMP traces 可能在采集前已被清理。

受查 VS 2022/旧扩展制品不含已核验的 VS 18 JSONL exporter。这需要另行核验记录格式，不能靠猜测 Enterprise 或 2022 路径模式解决。报告精确安装、产品、组件版本和 trace 文件是否存在，不分享会话正文或凭据。

不要手工相加原生和补充 OTel 总量。应用选择符合条件的贡献并保留原生历史。升级可以重新读取已有记录，修正解析，无须清除数据库。如果数值仍有差异，请检查冲突、字段质量和来源修订；内容冲突仍保留在历史中。

检查自动间隔、独立来源规则、省电暂停和取消。关闭自动采集时手动刷新仍可用。 Windows 上比较保存意图与实际任务定义、可执行路径。休眠/注销、进程退出和隐藏窗口是不同状态。

包含应用版本、OS、精确客户端版本、记录类型、查询范围、预期/实测数值、来源状态及只含相关用量字段的最小脱敏记录。首次失败和后续重试分开记录，不包含凭据、完整聊天日志或账户报表。通过 GitHub issues反馈。