此部分仅适用于 Kubernetes 部署。
LangSmith 应用程序公开可以发送到您选择的后端的遥测数据。如果您还没有可观测性堆栈，或者希望将 LangSmith 遥测与主应用程序分开，您可以使用 LangSmith Observability Helm 图表来部署基本的可观测性堆栈。

​
第 1 部分：Prometheus 导出器

如果您只想为自托管部署中的组件部署指标导出器，然后可以使用遥测来抓取这些指标，请使用此部分。如果您希望为您部署完整的可观测性堆栈，请转到端到端部署部分。 Helm 图表提供了一组 Prometheus 导出器，用于从 Redis、Postgres、Nginx 和 Kube state metrics 公开指标。
  1. 创建一个名为 langsmith_obs_config.yaml 的本地文件
  2. 将此文件中的值复制到 langsmith_obs_config.yaml，确保修改值以匹配您的 LangSmith 部署。
  3. 通过运行 helm search repo langchain/langsmith-observability --versions 查找图表的最新版本。
  4. 获取最新版本号，然后运行 helm install langsmith-observability langchain/langsmith-observability --values langsmith_obs_config.yaml --version <version> -n <namespace> --wait --debug
这将允许您在以下服务端点抓取指标：
  • Postgres: langsmith-observability-postgres-exporter:9187/metrics
  • Redis: langsmith-observability-redis-exporter:9121/metrics
  • Nginx: langsmith-observability-nginx-exporter:9113/metrics
  • KubeStateMetrics: langsmith-observability-kube-state-metrics:8080/metrics
如果安装成功，您应该看到以下内容： 
Release "langsmith-observability" has been installed. Happy Helming!NAME: langsmith-observabilityLAST DEPLOYED: Wed Jun 25 11:17:34 2025NAMESPACE: langsmith-observabilitySTATUS: deployedREVISION: 1
如果您运行 kubectl get pods -n langsmith-observability，您应该看到： 
langsmith-observability-kube-state-metrics-b58bb8db4-bm4g5        1/1     Running   0          2m22slangsmith-observability-nginx-exporter-6d686d9d4b-5qw9v           1/1     Running   0          2m22slangsmith-observability-postgres-exporter-67d5db5684-tffbm        1/1     Running   0          2m22slangsmith-observability-redis-exporter-846c4d65cb-vbtwd           1/1     Running   0          2m22s

​
第 2 部分：完整可观测性堆栈

这不是生产可观测性堆栈。使用此堆栈可以快速了解部署的日志、指标和跟踪。此堆栈仅用于每天处理几十 GB 的数据。
本节将向您展示如何使用 Helm 图表为 LangSmith 部署端到端可观测性堆栈。 此图表基于 Grafana 的开源 LGTM 堆栈构建。它包含： 以及用于收集遥测数据的 OpenTelemetry Collectors。

​
先决条件

​
1. 计算资源

堆栈每个部分的资源请求和限制可以在 helm 图表中修改。以下是当前的分配（请求/限制）：
  • Loki: 2vCPU/3vCPU + 2Gi/4Gi
  • Mimir: 1vCPU/2vCPU + 2Gi/4Gi
  • Tempo: 1vCPU/2vCPU + 4Gi/6Gi
在启动 helm 图表之前，请确保已分配这些资源，或在 helm 配置文件中修改资源值。

​
2. Cert-Manager

Helm 图表使用 OpenTelemetry Operator 来配置收集器。该操作符要求您在 Kubernetes 集群中安装 cert-manager。 如果您尚未安装，可以运行以下命令： 
helm repo add jetstack https://charts.jetstack.iohelm repo updatehelm install cert-manager jetstack/cert-manager -n cert-manager --create-namespace

​
3. OpenTelemetry Operator

使用以下命令安装 OpenTelemetry Operator： 
helm repo add open-telemetry https://open-telemetry.github.io/opentelemetry-helm-chartshelm repo updatehelm install opentelemetry-operator open-telemetry/opentelemetry-operator -n <namespace>

​
安装

以下说明将启动 OTel 收集器、LGTM 堆栈、Grafana 和 Prometheus 导出器。
  1. 创建一个名为 langsmith_obs_config.yaml 的本地文件
  2. 将此文件中的值复制到 langsmith_obs_config.yaml，确保修改值以匹配您的 LangSmith 部署。
  3. 通过运行 helm search repo langchain/langsmith-observability --versions 查找图表的最新版本。
  4. 获取最新版本号，然后运行 helm install langsmith-observability langchain/langsmith-observability --values langsmith_obs_config.yaml --version <version> -n <namespace> --wait --debug
您可以通过修改配置文件中 otelCollector 下的布尔值来选择性地收集日志、指标或跟踪。您还可以选择性地启动后端的各个部分（Loki、Mimir、Tempo）。
如果安装成功，您应该看到以下内容： 
Release "langsmith-observability" has been installed. Happy Helming!NAME: langsmith-observabilityLAST DEPLOYED: Wed Jun 25 11:17:34 2025NAMESPACE: langsmith-observabilitySTATUS: deployedREVISION: 1
如果您运行 kubectl get pods -n langsmith-observability，您应该看到： 
langsmith-observability-collector-gateway-collector-7746fb8pzbg   1/1     Running   0          5m26slangsmith-observability-grafana-7c6fc976f9-cdbvr                  1/1     Running   0          2m49slangsmith-observability-kube-state-metrics-b58bb8db4-bm4g5        1/1     Running   0          5m27slangsmith-observability-loki-0                                    2/2     Running   0          5m27slangsmith-observability-loki-chunks-cache-0                       2/2     Running   0          5m27slangsmith-observability-loki-gateway-769fb6fff8-zjsn5             1/1     Running   0          5m27slangsmith-observability-loki-results-cache-0                      2/2     Running   0          5m27slangsmith-observability-mimir-0                                   1/1     Running   0          5m26slangsmith-observability-nginx-exporter-6d686d9d4b-5qw9v           1/1     Running   0          5m27slangsmith-observability-postgres-exporter-67d5db5684-tffbm        1/1     Running   0          5m27slangsmith-observability-redis-exporter-846c4d65cb-vbtwd           1/1     Running   0          5m27slangsmith-observability-tempo-0                                   1/1     Running   0          5m27sopentelemetry-operator-756dff697-vblbn                            2/2     Running   0          12m

​
安装后

​
在 LangSmith 中启用日志和跟踪

安装可观测性 helm 图表后，您需要在 LangSmith helm 配置文件中设置以下值以启用日志和跟踪的收集。 
commonPodAnnotations:
  # 例如："langsmith-observability/langsmith-observability-collector-sidecar"
  sidecar.opentelemetry.io/inject: "${LANGSMITH_OBS_NAMESPACE}/${LANGSMITH_OTEL_CRD_NAME}"
observability:
  tracing:
    enabled: true
    # 将其替换为您的跟踪收集器端点。
    # 例如："http://langsmith-observability-collector-gateway-collector.langsmith-observability.svc.cluster.local:4318/v1/traces"
    endpoint: "http://${GATEWAY_COLLECTOR_SERVICE_NAME}.${LANGSMITH_OBS_NAMESPACE}.svc.cluster.local:4318/v1/traces"
  1. 要获取 ${LANGSMITH_OTEL_CRD_NAME}，您可以运行 kubectl get opentelemetrycollectors -n ${LANGSMITH_OBS_NAMESPACE} 并选择 MODE = sidecar 的那个名称
  2. 要获取 ${GATEWAY_COLLECTOR_SERVICE_NAME} 名称，请运行 kubectl get services -n ${LANGSMITH_OBS_NAMESPACE} 并选择具有端口 4317/4318 且设置了 ClusterIP 的服务。它应该类似于 langsmith-observability-collector-gateway-collector
现在运行 helm upgrade langsmith langchain/langsmith --values langsmith_config.yaml -n <langsmith-namespace> --wait --debug 升级后，如果您运行 kubectl get pods -n <langsmith-namespace>，您应该看到以下内容（注意 sidecar 收集器的 2/2）： 
langsmith-ace-backend-7dc85f7dff-xjbkj         2/2     Running     0               7m53slangsmith-backend-566b66979c-rgcfh             2/2     Running     1               7m53slangsmith-clickhouse-0                         2/2     Running     0               7m49slangsmith-frontend-7cf8549885-vpkns            2/2     Running     0               7m53slangsmith-platform-backend-5d46db7d9d-f6gh7    2/2     Running     0               7m52slangsmith-platform-backend-5d46db7d9d-lrr4d    2/2     Running     1               7m41slangsmith-platform-backend-5d46db7d9d-pcp27    2/2     Running     0               7m28slangsmith-playground-65d4c9699c-h656r          2/2     Running     0               7m52slangsmith-postgres-0                           2/2     Running     0               7m51slangsmith-queue-bdcd45bd6-htssd                2/2     Running     0               7m52slangsmith-queue-bdcd45bd6-pwdx4                2/2     Running     0               6m31slangsmith-queue-bdcd45bd6-xqrb8                2/2     Running     0               5m11slangsmith-redis-0                              2/2     Running     0               7m51s

​
Grafana 使用

安装完所有内容后，执行以下操作以获取您的 Grafana 密码： 
kubectl get secret langsmith-observability-grafana -n <langsmith_observability_namespace> -o jsonpath="{.data.admin-password}" | base64 --decode
然后将端口转发到端口 3000 的 langsmith-observability-grafana 容器，并在浏览器中打开 localhost:3000。使用用户名 admin 和上面密钥中的密码登录 Grafana。 进入 Grafana 后，您可以使用 UI 监控日志、指标和跟踪。Grafana 还预装了用于监控部署主要组件的仪表板集。 LangSmith Grafana Dashboards
Edit the source of this page on GitHub.
Connect these docs programmatically to Claude, VSCode, and more via MCP for real-time answers.