在 SigNoz 中配置 LLM 观测时，如何解决 API 200 但面板空白的问题

最近在给项目搭建 LLM 观测链路，用了开源的 SigNoz。在配置过程中我踩了一个非常典型的坑：后端 API 响应全是 200 OK，日志显示数据已经传进去了，但前端 Dashboard 却是一片空白，或者直接把我重定向回了首页。这种“假成功”的状态最让人抓狂，因为你找不到任何明确的 Error Log。

经过深挖，我发现 SigNoz 的 AI 观测功能并不是简单的“安装即用”，它隐藏了三层逻辑依赖，如果没对齐，面板永远出不来数据。

首先是环境变量的“死锁”问题。很多用户（包括我最初）在看文档时，可能只关注到了 AI 观测的开关。但实际上，SigNoz 的 AI 观测面板依赖于 V2 版本的 Dashboard 架构。如果你只开启了 AI 观测，而没有同步开启 V2 面板，系统虽然不会报错，但前端界面无法正确渲染 LLM 相关的指标。

要彻底激活，必须在部署的环境变量中同时强制开启这两个 Flag，缺一不可：
SIGNOZ_FLAGGER_CONFIG_BOOLEAN_ENABLE__AI__OBSERVABILITY=true
SIGNOZ_FLAGGER_CONFIG_BOOLEAN_USE__DASHBOARD__V2=true
只有这两个开关成对出现，前端才能正确识别并加载 AI 观测的专用组件。

其次是注册表数据的缺失。即便开关打开了，你可能会发现面板依然没有数据。这是因为 SigNoz 的 LLM 观测逻辑中包含一个映射层。在初始安装后，系统内部的 llm_pricing_rules（模型价格表）和 span_mapper_groups（供应商映射预设）这两个注册表默认是空的。

这意味着什么？这意味着即使你的应用成功发送了带有 gen_ai.* 属性的 Span 数据，由于后台缺乏对应的映射定义，系统无法将这些原始数据解析为可读的 Token 消耗或模型调用统计。如果你在面板上看不到任何 Token 计数，建议优先检查这两个注册表是否已经正确配置了供应商映射关系。

最后，我想提醒大家注意 OpenInference 的埋点兼容性问题。很多开发者习惯使用 OpenInference 标准进行埋点，但这里有一个细节：OpenInference 发出的属性名称与 SigNoz 预期的 gen_ai.* 标准并不完全一致。如果属性名对不上，映射层就会失效，导致数据虽然进入了数据库，但无法被 AI 观测面板捕捉。

总结这次实战经验，在使用 SigNoz 观测 LLM 时，不要被 API 的 200 状态码给骗了。真正的跑通需要满足：环境变量双开关同步开启 → 注册表映射数据补齐 → 埋点属性符合 gen_ai.* 规范。只要这三点对齐，这套开源的观测链路其实非常硬核，能极大缓解 LLM 调试时的“黑盒”焦虑。