管理追踪

从追踪视图中，您可以并排比较两个追踪、公开共享追踪以及查看与追踪执行相关的服务器日志。

​

比较追踪

您可以从 UI 中的两个区域开始比较追踪：

1. 从 Tracing 项目视图的 Runs 选项卡中，选择您想要比较的追踪旁边的复选框。然后，选择页面底部的 Compare Runs 以打开并排比较视图。
2. 当您正在查看某个追踪时，选择更多 菜单以导航至 Compare。这将打开追踪运行表。选择您想要与原始追踪进行比较的追踪。侧面板将打开，其中两个追踪都已选中并处于并排比较视图中。

要停止比较，请关闭面板或点击面板右上角的 Stop comparing。

​

共享追踪

要公开共享追踪：

1. 在 UI 中打开任意追踪。
2. 点击追踪视图顶部更多 菜单中的 Share 按钮。
3. 在出现的对话框中，复制公共链接。

共享的追踪对任何拥有链接的人都可访问，即使没有 LangSmith 帐户。他们可以查看追踪但不能编辑它。 要取消共享追踪，请使用以下任一方法：

1. 打开共享的追踪，点击追踪视图顶部工具栏中的 Public，然后在对话框中点击 Unshare。
2. 转到 Settings → Shared URLs 以查看所选工作区中所有公开共享的追踪。点击您想要取消共享的追踪旁边的 Unshare。

​

查看服务器日志

当查看由 LangSmith 中的运行生成的追踪时，您可以直接从追踪视图访问相关的服务器日志。 在追踪视图中，使用右上角的 See Logs 按钮，该按钮位于 Run in Studio 按钮旁边。 点击此按钮将带您前往 LangSmith 中相关部署的服务器日志视图。 服务器日志视图显示来自以下两方面的日志：

• Agent Server 自身的操作日志：内部服务器操作、API 调用和系统事件
• 用户应用程序日志：在您的图中编写的日志，使用：
  • Python：使用 logging 或 structlog 库。
  • JavaScript：使用从 @langchain/langgraph-sdk/logging 重新导出的 Winston 日志记录器：
    import { getLogger } from "@langchain/langgraph-sdk/logging";
    
    const logger = getLogger();
    logger.info("Your log message");
    

当您从追踪视图导航时，Filters 框将自动预填充您刚刚查看的追踪的 Trace ID，因此您可以快速过滤日志，仅查看与您特定追踪执行相关的日志。

​

删除追踪

如果您需要在追踪到期前从 LangSmith 中移除追踪，您可以删除整个项目或删除特定追踪。

​

删除整个项目

• 在 LangSmith UI 中，选择项目溢出菜单上的 Delete 选项。
• 使用 delete_tracer_sessions API 端点。
• 使用 LangSmith SDK 中的 delete_project() (Python) 或 deleteProject() (JS/TS)。

​

删除特定追踪：

使用 delete_runs API 端点通过追踪 ID 或元数据键值对删除运行。请求体接受：

• session_id：将删除范围限定到特定项目。
• trace_ids：要删除的追踪 ID 列表。
• metadata：删除与给定元数据键值对匹配的所有运行。

有关完整的 API 用法，包括代码示例、每个请求 1000 条追踪的限制、删除时间线和元数据匹配行为，请参阅用于合规性的数据清除。

---