数据删除
可能存在你想从 Langfuse 中移除选定数据的用例,例如在开发流程中错误创建的 traces、涉及 PII 的用户数据,或你的整个项目。 如果你只想保留最近的数据,可以使用我们的数据保留功能。
你可以通过以下方式从 Langfuse 删除不需要的数据:
- 删除单个 trace;
- 删除一批 traces;
- 删除匹配查询过滤器的所有 traces;
- 删除一个项目;
- 删除一个组织;或
- 删除一个用户账户。
下面,我们将逐一介绍每个选项及其保证。
删除 Traces
请注意,所有 trace 删除都会删除所有数据存储中的相关实体,如 scores 和 observations。
单个 Trace
要删除单个 trace,打开其详情视图并点击 Delete 按钮。
确认你要删除给定的 trace。
DELETE /api/public/traces/{traceId}
参见 reference。
一批 Traces
要删除一批 traces,在 trace 列表中选择它们,然后在 Actions 下拉菜单中选择 Delete。
DELETE /api/public/traces
参见 reference。
按查询删除
要删除匹配查询过滤器的所有 traces,在 traces 列表中配置你想要的过滤器。
选择当前页面上的所有条目,并在顶栏中将其更改为所有条目。
然后在 Actions 下拉菜单中选择 Delete。
限制
Langfuse 中的大多数删除会立即发生,但追踪数据的删除不会。 从我们的数据仓库中移除这些记录是一项资源密集型操作,因此我们对任意时间点处理的删除数量进行速率限制。 通常,追踪数据会在删除调用后 15 分钟内从我们的系统中删除。 没有删除确认或通知;要验证你的数据已被删除,请再次查询它。
如果你需要定期清理旧数据,请考虑改用数据保留,它会自动删除早于配置天数的 traces、observations、scores 和 media assets。
删除项目
要删除项目,导航到项目设置并滚动到 General 部分内的 Danger Zone。
确认你要删除你的项目。
此操作会立即撤销所有 API 密钥,并将项目安排删除。
在接下来的几分钟内,所有相关数据将从我们的系统中不可逆地移除。
删除项目是不可逆的,所有数据都将被移除。执行此操作时请谨慎。确认删除后,项目最多需要 5 分钟才能被删除。
删除组织
如果组织中没有剩余项目,你可以在组织设置中删除该组织。
导航到组织设置并滚动到 General 部分内的 Danger Zone。
确认你要删除你的组织。
该组织及所有关联的用户信息将从我们的系统中移除。
删除用户账户(Cloud)
用户可以从账户设置页面删除自己的账户。从右下角的用户菜单导航到 Account Settings。
如果你是某个组织的唯一所有者,你必须先将所有权转移给另一个用户或删除该组织,然后才能删除你的账户。
删除用户账户(自托管)
从 users 表中移除相应的用户记录,并使用 cascade 删除所有指向它的外键。