Skip to main content
在继续本指南之前，请阅读 LangSmith 架构概述 和 连接外部 ClickHouse 的指南。
LangSmith 使用 ClickHouse 作为 跟踪 和 反馈 的主要存储引擎。为了便于管理和扩展，建议将自托管的 LangSmith 实例连接到外部 ClickHouse 实例。LangSmith 托管的 ClickHouse 是一个选项，允许您使用由 LangSmith 团队监控和维护的全托管 ClickHouse 实例。

​
架构概述

将 LangSmith 托管的 ClickHouse 与您的自托管 LangSmith 实例一起使用的架构，与使用完全自托管的 ClickHouse 实例类似，但有几个关键区别：
  • 您需要在您的 LangSmith 实例和 LangSmith 托管的 ClickHouse 实例之间建立私有网络连接。这是为了确保您的数据安全，并且您可以从自托管的 LangSmith 实例连接到 ClickHouse 实例。
  • 使用此选项时，您跟踪的敏感信息（输入和输出）将存储在您云内的云对象存储（S3 或 GCS）中，而不是 ClickHouse 中，以确保敏感信息不会离开您的 VPC。有关特定数据字段存储位置的更多详细信息，请参阅 数据存储。
  • LangSmith 团队将监控您的 ClickHouse 实例并确保其平稳运行。这使我们能够跟踪诸如运行摄取延迟和查询性能等指标。
整体架构如下所示： LangSmith 托管的 ClickHouse 架构。

​
要求

  • 您必须使用受支持的 Blob 存储选项。 阅读 Blob 存储指南 了解更多信息。
  • 要使用私有端点，请确保您的 VPC 位于 ClickHouse Cloud 支持的 区域。否则，您将需要使用我们将通过防火墙规则保护的公共端点。您的 VPC 需要有一个 NAT 网关，以便我们能够将您的流量加入白名单。
  • 您必须拥有一个可以连接到 LangSmith 托管的 ClickHouse 服务的 VPC。您需要与我们的团队合作设置必要的网络。
  • 您必须有一个正在运行的 LangSmith 自托管实例。您可以将我们的托管 ClickHouse 服务与 Kubernetes 安装一起使用。

​
数据存储

ClickHouse 存储 运行 和 反馈 数据，具体包括：
  • 所有反馈数据字段。
  • 部分运行数据字段。
有关字段列表，请参阅 存储的运行数据字段 和 存储的反馈数据字段。 LangChain 将敏感应用数据定义为运行的 inputs、outputs、errors、manifests、extras 和 events，因为这些字段可能包含 LLM 提示和补全。使用 LangSmith 托管的 ClickHouse 时，这些敏感字段存储在您云内的云对象存储（S3 或 GCS）中，而其余的运行数据存储在 ClickHouse 中，确保敏感信息永远不会离开您的 VPC。

​
存储的反馈数据字段

由于所有反馈数据都存储在 ClickHouse 中，请勿在反馈（分数和注释/评论）或 存储的运行数据字段 中提到的任何其他运行字段中发送敏感信息。
使用 LangSmith 托管的 ClickHouse 设置，所有反馈数据字段都存储在 ClickHouse 中： 此 参考文档 解释了存储的反馈格式，这是 LangSmith 表示运行评估分数和注释的方式。

​
存储的运行数据字段

运行数据字段分布在托管的 ClickHouse 数据库和您的云对象存储（例如 S3 或 GCS）之间。
对于存储在对象存储中的运行字段，ClickHouse 中仅保留引用或指针。例如，inputs 和 outputs 内容被卸载到 S3/GCS，ClickHouse 记录在 inputs_s3_urls 和 outputs_s3_urls 字段中存储相应的 S3 URL。
下表详细说明了每个运行字段及其存储位置： 此 参考文档 解释了存储的运行（跨度）的格式，它们是跟踪的构建块。
通过 MCP 将这些文档 连接到 Claude、VSCode 等，以获取实时答案。
在 GitHub 上编辑此页面 或 提交问题。