API 与参考导出到 Blob 存储

通过对象存储集成导出

Where is this feature available?
  • Hobby
  • Core
  • Pro
    (Team)
  • Enterprise
  • Self Hosted

你可以为 tracesobservations、enriched observations 和 scores 创建到对象存储(例如 S3、GCS 或 Azure Blob Storage)的计划导出任务。

这些导出可以按 hourlydailyweekly 计划运行。 进入项目设置并选择 Integrations > Blob Storage 即可创建新的导出。 选择你要使用的存储类型:S3、S3 兼容存储、Google Cloud Storage 或 Azure Blob Storage。

开始通过对象存储导出

要设置导出,请进入 Your Project > Settings > Integrations > Blob Storage

填写设置项以完成厂商认证、启用集成,然后点击保存。 一小时之内会启动初始导出,之后将按你选择的计划继续运行。 导出支持 CSV、JSON 和 JSONL 文件格式。 请阅读 对象存储文档 了解如何获取你具体厂商的凭据。

对象存储集成设置

导出来源(Litefuse v4)

对象存储集成现在新增了 Export Source 选择器。新建集成默认采用 Enriched observations (recommended)(trace 属性直接设置在 observation 上)。

该来源使用包含 trace 属性的 enriched observations,导出性能显著更好。无论选择哪种来源,Scores 都会始终包含在导出中。

可选项:

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

Traces and observations (legacy) 来源未来可能会被弃用。所有新的导出任务都应使用 Enriched observations (recommended),强烈建议现有的 legacy 任务升级。

现有配置的升级路径

现有集成在更改之前会继续使用 Traces and observations (legacy)

要安全迁移:

  1. 切换到 Traces and observations (legacy) and enriched observations
  2. 在两种来源都被导出时验证下游任务和数据消费方(该模式按设计会产生重复记录)。
  3. 验证完成后切换到 Enriched observations (recommended)

发布详情请查看 Simplify for Scale 更新日志。

其他方式

你也可以通过以下方式导出数据:

  • UI —— 从 Litefuse UI 手动批量导出
  • SDKs/API —— 通过 Langfuse SDK 或 API 进行编程式访问
这个页面对你有帮助吗?