管理追踪

公开分享追踪，并从 LangSmith 的 Details 视图查看服务器日志。

你可以公开分享追踪，并查看服务器日志，这些日志与追踪执行相关联。

分享追踪

WARNING

公开分享追踪会使任何拥有链接的人都能访问它。请确保你没有分享敏感信息。

如果你的自托管 LangSmith 部署位于 VPC 内，那么公开链接仅对在你的 VPC 内通过身份验证的成员可访问。为增强安全性，我们建议将实例配置为私有 URL，仅允许有权访问你网络的用户访问。

要公开分享追踪：

1. 在 UI 中打开任意追踪。
2. 点击 Share 按钮，它位于更多

•

菜单中，该菜单位于 Details 视图顶部。 3. 在出现的对话框中，复制公开链接。

共享追踪可供任何拥有链接的人访问，即使对方没有 LangSmith 账户。他们可以查看追踪，但不能编辑。

要取消分享追踪，请使用以下任一方法：

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

查看服务器日志

NOTE

查看追踪的服务器日志仅适用于 Cloud SaaS 和完全自托管部署选项。

当你查看由 LangSmith 中的运行生成的追踪时，可以直接从 Details 视图访问关联的服务器日志。

在 Details 视图中，使用右上角、Run in Studio 按钮旁边的 See Logs 按钮。

点击此按钮将带你进入 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");

当你从 Details 视图导航时，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 条追踪的限制、删除时间线和元数据匹配行为），请参阅为合规而清除数据。

---