文档 / 数据保留(Data Retention)

数据保留(Data Retention)

数据保留在 Pro、Enterprise 计划中可用,自托管版本为企业版功能;Hobby 和 Core 计划不可用。

借助 Langfuse 的数据保留功能,你可以控制事件数据(Traces、Observations、Scores 和 Media Assets)在 Langfuse 中存储多长时间。

配置

数据保留在项目级别配置,我们接受的天数最少为 3 天。项目所有者和管理员可以在 Project Settings 视图中更改数据保留设置。

如果没有保留策略,Langfuse 不会自动删除事件数据(Traces、Observations、Scores 和 Media Assets)。在自托管实例上,数据默认无限期存储。在 Langfuse Cloud 上,每个计划都包含一个数据访问窗口(Hobby:30 天,Core:90 天,Pro 和 Enterprise:3 年);详见定价。

在 Langfuse 中配置数据保留

数据保留也可以通过 projects API 配置。

细节

Langfuse 每晚选择早于配置保留期的 traces、observations、scores 和 media assets 并删除它们。我们使用每个实体的以下属性来判断它们是否在保留窗口之外:

Traces:timestamp
Observations:start_time
Scores:timestamp
Media Assets:created_at

已删除的资产无法恢复。如果你需要在保留窗口之外保留数据,可以设置 Blob 存储导出,按重复计划自动将 traces、observations 和 scores 同步到 S3、GCS 或 Azure。

保留策略适用于相应数据,独立于任何引用。例如,如果数据集引用了一个 trace,但该 trace 在 30 天后被删除,数据集运行条目将指向一个不存在的 trace。

自托管实例

要在自托管环境中使用数据保留功能,你需要在所有存储桶上向 Langfuse IAM 角色授予 s3:DeleteObject(参见 Blob Storage (S3) 文档)。请注意,Langfuse 仅在 API 上发出删除语句。如果你使用版本化存储桶,删除标记和非当前版本需要手动或通过生命周期规则移除。