PostHog 集成

PostHog 是常见的开源产品分析工具。Litefuse 自带 分析 能力，但不少用户希望能 把通过 Litefuse 捕获的 LLM 相关指标整合到自己的 PostHog 仪表盘里。

我们做了这个集成，让回答下列问题变得简单：

• “我最活跃的用户也是与我的 LLM 内容互动最深的吗？”
• “与 LLM 功能交互是否带来更高的留存率？”
• “LLM 功能对转化率有什么影响？”
• “我在 Litefuse 中收集的用户反馈，与我在 PostHog 中看到的用户行为是否相关？”

快速开始

导出来源（Litefuse v4）

PostHog 集成现在包含 Export Source 选择器。新集成默认使用 Enriched observations (recommended)（trace 属性会直接设置在 observation 上）。

这种来源使用带 trace 属性的 enriched observation，导出性能显著更优。无论选择哪个来源，Scores 都始终包含。

可选项：

• Traces and observations (legacy)
• Traces and observations (legacy) and enriched observations
• Enriched observations (recommended)

现有配置的升级路径

存量集成会一直使用 Traces and observations (legacy)，直到你修改它。

安全迁移的步骤：

1. 切到 Traces and observations (legacy) and enriched observations。
2. 在两种来源同时导出期间，验证下游仪表盘、变换和告警（这种模式会按设计产生重复记录）。
3. 验证完毕后切到 Enriched observations (recommended)。

发布详情见 Simplify for Scale changelog。

PostHog 仪表盘示例

集成细节

Litefuse 会按小时把聚合后的事件和指标批量发送到你的 PostHog 实例。

Metadata 匹配

Metadata 匹配可以把 Litefuse 中的数据与 PostHog 中的数据关联起来：

用户属性

我们通过 '$set' 发送以下用户属性：

• langfuse_user_url：Litefuse 中 用户主页 的深链。

事件

集成会向 PostHog 发送以下事件。

还有什么额外信息有帮助？可以在 这里 提交更多事件或属性的请求。

事件：langfuse trace

• timestamp：事件发生时间。
• langfuse_trace_name：trace 的名称。
• langfuse_url：trace 的 URL。
• langfuse_id：trace 的唯一标识。
• langfuse_cost_usd：trace 的总成本。
• langfuse_count_observations：trace 中 observation 的数量。
• langfuse_session_id：与该事件相关的 session ID。
• langfuse_project_id：与该事件相关项目的 ID。
• langfuse_user_id：与该事件相关的 user ID。如果为空，会被标记为 litefuse_unknown_user。
• langfuse_latency：该事件的延迟。
• langfuse_release：与该事件 release 相关的信息。
• langfuse_version：该事件的版本。
• langfuse_tags：与该事件关联的所有标签。
• langfuse_environment：与该 trace 相关的环境。
• langfuse_event_version：Litefuse 集成版本号。

事件：langfuse generation

• timestamp：generation 的开始时间。
• langfuse_generation_name：generation 的名称。
• langfuse_trace_name：与 generation 相关 trace 的名称。
• langfuse_trace_id：与 generation 相关 trace 的唯一标识。
• langfuse_url：宿主平台上 generation 的 URL。
• langfuse_id：generation 的唯一标识。
• langfuse_cost_usd：计算得到的 generation 总成本。
• langfuse_input_units：用于发起 generation 的 token 数量。
• langfuse_output_units：generation 产出的 token 数量。
• langfuse_total_units：generation 过程中消耗的总 token 数。
• langfuse_session_id：与 generation 所在 trace 关联的 session ID。
• langfuse_project_id：generation 发生所在的项目标识。
• langfuse_user_id：发起与 generation 关联 trace 的 user ID。如不可用，默认为 langfuse_unknown_user。
• langfuse_latency：观察到的 generation 延迟。
• langfuse_time_to_first_token：streaming 时生成第一个 token 所用时间。
• langfuse_release：与 generation 关联 trace 的 release 信息。
• langfuse_version：该 generation 的版本信息。
• langfuse_model：本次 generation 使用的模型。
• langfuse_level：与 generation 关联的 level。
• langfuse_tags：附在 generation 所在 trace 上的标签。
• langfuse_environment：与该 generation 关联的环境。
• langfuse_event_version：与 Litefuse 的集成版本号。

事件 langfuse score

• timestamp：score 事件发生的时间。
• langfuse_score_name：与该 score 关联的名称。
• langfuse_score_value：该 score 的值。
• langfuse_score_string_value：score 的字符串值。对于 BOOLEAN 和 CATEGORICAL 类型，这是值的字符串表示。
• langfuse_score_data_type：score 的数据类型（NUMERIC、BOOLEAN、CATEGORICAL）。
• langfuse_score_comment：附在 score 上的评论。
• langfuse_score_metadata：附在 score 上的 metadata。
• langfuse_trace_name：与该 score 关联 trace 的名称。
• langfuse_trace_id：与该 score 关联 trace 的唯一标识。
• langfuse_id：该 score 的唯一标识。
• langfuse_session_id：与该 score 所在 trace 关联的 session ID。
• langfuse_project_id：与该 score 所在 trace 关联的项目标识。
• langfuse_user_id：触发与 score 绑定 trace 的 user ID。如不可用，默认为 langfuse_unknown_user。
• langfuse_release：与该 score 关联 trace 的 release 信息。
• langfuse_tags：与该 score 所在 trace 相关的标签。
• langfuse_environment：与该 score 关联的环境。
• langfuse_event_version：与 Litefuse 的集成版本号。

故障排查

PostHog 中数据缺失？ 请检查你是否在 Litefuse 项目设置中正确填入了 PostHog hostname 和 API Key。如果你使用 PostHog 免费版，也请确认没有超出事件配额，否则 PostHog 在达到上限时会丢弃事件。如果遇到其他集成相关问题，欢迎联系我们。