跳到主要内容
本节仅适用于 Kubernetes 部署。
自托管 LangSmith 实例以日志、指标和跟踪的形式生成遥测数据。本节将向您展示如何访问这些数据并将其导出到可观测性收集器或后端。 本节假设您已经设置了监控基础设施,或者您将设置此基础设施并希望了解如何配置 LangSmith 以从中收集数据。 基础设施包括:

日志:OTel 示例

所有作为 LangSmith 自托管部署一部分的服务都会将日志写入其节点的 文件系统和 stdout。为了访问这些日志,您需要设置收集器以从文件系统或 stdout 读取。大多数流行的收集器都支持从文件系统读取日志。

指标:OTel 示例

LangSmith 服务

以下 LangSmith 服务在端点处公开指标,采用 Prometheus 指标格式。前端目前不公开指标。
  • 后端http://<langsmith_release_name>-backend.<namespace>.svc.cluster.local:1984/metrics
  • 平台后端http://<langsmith_release_name>-platform-backend.<namespace>.svc.cluster.local:1986/metrics
  • Playgroundhttp://<langsmith_release_name>-playground.<namespace>.svc.cluster.local:1988/metrics
  • (仅限 LangSmith 控制平面)主机后端http://<langsmith_release_name>-host-backend.<namespace>.svc.cluster.local:1985/metrics
您可以使用 PrometheusOpenTelemetry 收集器来抓取端点,并将指标导出到您选择的后端。

前端 Nginx

前端服务在以下端点公开其 Nginx 指标:langsmith-frontend.langsmith.svc.cluster.local:80/nginx_status。您可以自行抓取它们,或者使用 LangSmith 可观测性 Helm Chart 启动 Prometheus Nginx 导出器
以下部分仅适用于集群内数据库。如果您使用的是外部数据库,则需要配置公开和获取指标。

Postgres + Redis

如果您使用的是集群内 Postgres/Redis 实例,您可以使用 Prometheus 导出器从您的实例公开指标。您可以自行部署,或者如果您愿意,可以使用 LangSmith 可观测性 Helm Chart 为您部署导出器。

Clickhouse

集群内 Clickhouse 已配置为无需导出器即可公开指标。您可以使用收集器在 http://<langsmith_release_name>-clickhouse.<namespace>.svc.cluster.local:9363/metrics 处抓取指标

跟踪:OTel 示例

LangSmith 后端、平台后端、Playground 和 LangSmith 队列部署已进行检测,以发出 Otel 跟踪。跟踪默认关闭,可以通过在您的 langsmith_config.yaml(或等效文件)中添加以下内容,为所有 LangSmith 服务启用跟踪
config:
  tracing:
    enabled: true
    endpoint: "<your_collector_endpoint>"
    useTls: true # / false
    env: "ls_self_hosted" # This value will be set as an "env" attribute in your spans
    exporter: "http" # must be either http or grpc

以编程方式连接这些文档到 Claude、VSCode 等,通过 MCP 获取实时答案。
© . This site is unofficial and not affiliated with LangChain, Inc.