本节仅适用于 Kubernetes 部署。
- 收集器,例如 OpenTelemetry、FluentBit 或 Prometheus。
- 可观测性后端,例如 Datadog 或 Grafana 生态系统。
日志:OTel 示例
所有作为 LangSmith 自托管部署一部分的服务都会将日志写入其节点的 文件系统和 stdout。为了访问这些日志,您需要设置收集器以从文件系统或 stdout 读取。大多数流行的收集器都支持从文件系统读取日志。- OpenTelemetry:文件日志接收器
- FluentBit:Tail 输入
- Datadog:Kubernetes 日志收集
指标: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 - Playground:
http://<langsmith_release_name>-playground.<namespace>.svc.cluster.local:1988/metrics - (仅限 LangSmith 控制平面)主机后端:
http://<langsmith_release_name>-host-backend.<namespace>.svc.cluster.local:1985/metrics
前端 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 服务启用跟踪
以编程方式连接这些文档到 Claude、VSCode 等,通过 MCP 获取实时答案。