Agent Server 指标

Agent Server 通过 OpenTelemetry (OTel) 客户端发出指标。指标默认使用 lg_api_ 名称前缀（可通过 METRIC_PREFIX 覆盖）。在自托管部署中，可使用此页面选择抓取或推送后端、启用所需的指标集，并在构建仪表板或警报时查询 Prometheus 名称。

指标后端

Agent Server 将指标分为两组：

部署界面指标：在 LangSmith 部署界面中展示，并默认暴露在 Agent Server 的 Prometheus 抓取端点（GET /metrics，format=prometheus）。
内部指标：供 LangChain 运维人员使用的运维和调试指标。配置后发送到 Datadog。在 Prometheus 上，内部指标仅在您选择启用时才会出现。

后端	指标集	启用方式
Prometheus (抓取 `GET /metrics`)	默认包含部署界面指标。设置 `EXPOSE_INTERNAL_METRICS_PROMETHEUS=true` 可在同一端点上同时暴露内部指标。	当安装了 OTel Prometheus 导出器时可用
Datadog (OTLP 推送)	仅内部指标	设置 `LSD_DD_API_KEY`（或 `CUSTOM_LSD_DD_API_KEY`）。指标会推送到 `https://{LSD_DD_ENDPOINT}/v1/metrics`（默认端点：`otlp.us5.datadoghq.com`）。

Prometheus 和 Datadog 可以同时运行。Datadog 仅接收内部指标，因此界面指标不会在两个后端中重复。

指标层级

每个指标都被分配了一个层级，用于控制内部指标是否被记录：

层级	值	目的
CRITICAL	`1`	核心健康和故障信号。当内部指标启用时（包括在 `dev` / `dev_free` 部署中）始终记录。
INFO	`2`	生产环境监控的操作细节。生产环境中的默认上限（`METRIC_MAX_EMITTING_TIER=2`）。
DEBUG	`3`	用于故障排除的深度诊断。除非您提高 `METRIC_MAX_EMITTING_TIER`，否则将被忽略。
DEEP_DEBUG	`4`	详细诊断。除非您提高 `METRIC_MAX_EMITTING_TIER`，否则将被忽略。

将 METRIC_MAX_EMITTING_TIER 设置为您希望为内部指标记录的最高层级。部署界面指标会忽略此设置并始终发出。

配置导出

Prometheus

要抓取部署界面指标：

将您的 Prometheus 收集器指向 Agent Server 的 /metrics 端点（例如，https://<agent-server-host>/metrics）。
使用默认的 format=prometheus 查询参数（或省略它）。

要在同一端点上同时暴露内部指标，请设置：

EXPOSE_INTERNAL_METRICS_PROMETHEUS=true

Datadog

要将内部指标推送到 Datadog 而不是（或同时）Prometheus：

将 LSD_DD_API_KEY 设置为您的 Datadog API 密钥。当该密钥存在时，DATADOG_METRICS_ENABLED 会自动开启。
（可选）设置 LSD_DD_ENDPOINT（默认值：otlp.us5.datadoghq.com）或旧别名 CUSTOM_LSD_DD_API_KEY / CUSTOM_LSD_DD_ENDPOINT。

Datadog 仅接收内部指标。请继续在 Prometheus 或 Grafana 中抓取 /metrics 以获取部署界面指标。

部署界面指标

这些指标带有 lsd_web_metric=true 标志。它们默认出现在 Prometheus 的 /metrics 抓取结果中，并为 LangSmith 部署界面提供数据。列出层级值仅供参考；这些指标无论 METRIC_MAX_EMITTING_TIER 设置如何都会始终发出。

名称	类型	层级	描述
`lg_api_http_requests_total`	计数器	INFO	到达 Agent Server 的 HTTP 请求总数。
`lg_api_http_requests_latency`	直方图 (毫秒)	INFO	HTTP 请求延迟。
`lg_api_run_queue_wait_time_1st_attempt`	直方图 (毫秒)	INFO	作业在首次处理前在队列中等待的时间。
`lg_api_num_pending_runs`	仪表	INFO	当前待处理的运行数。在 Postgres 后端上，Go 核心是数据源；在内存后端上，Python 收集器发出此仪表。
`lg_api_num_running_runs`	仪表	INFO	当前正在运行的运行数。运行时划分与 `lg_api_num_pending_runs` 相同。
`lg_api_workers_max`	仪表	CRITICAL	最大工作线程容量。在内存运行时上由 Python 收集器发出；在 Postgres 上由 Go 核心发出。
`lg_api_workers_active`	仪表	CRITICAL	当前正在执行运行的工作线程数。
`lg_api_workers_available`	仪表	CRITICAL	可用于接受新运行的工作线程数。
`lg_api_pg_pool_max`	仪表	CRITICAL	最大 Postgres 连接池大小。
`lg_api_pg_pool_size`	仪表	CRITICAL	Postgres 池当前管理的连接数（空闲、正在使用或正在准备）。
`lg_api_pg_pool_available`	仪表	INFO	Postgres 池中的空闲连接数。
`lg_api_pg_pool_requests_queued_total`	计数器	CRITICAL	因连接无法立即使用而排队的 Postgres 连接请求数。OTel Prometheus 导出器会在计数器名称后追加 `_total`。
`lg_api_pg_pool_requests_errors_total`	计数器	CRITICAL	Postgres 连接请求错误（超时、队列满及类似故障）。
`lg_api_redis_pool_max`	仪表	INFO	最大 Redis 连接池大小。
`lg_api_redis_pool_size`	仪表	INFO	Redis 当前正在使用的连接数。
`lg_api_redis_pool_available`	仪表	INFO	Redis 池中的空闲连接数。

内部指标

这些指标带有 lsd_web_metric=false 标志。默认情况下，当设置了 LSD_DD_API_KEY 时，它们会被导出到 Datadog。设置 EXPOSE_INTERNAL_METRICS_PROMETHEUS=true 可将它们包含在 Prometheus 的 /metrics 抓取结果中。层级等于或低于 METRIC_MAX_EMITTING_TIER 的内部指标会被记录；更高层级的指标将被忽略。

运行生命周期

名称	类型	层级	描述
`lg_api_run_attempt_started_counter`	计数器	CRITICAL	开始的运行执行尝试次数。
`lg_api_run_success_counter`	计数器	CRITICAL	成功完成的运行次数。
`lg_api_run_canceled_by_request_counter`	计数器	CRITICAL	被显式取消请求取消的运行次数。
`lg_api_run_failed_retriable_counter`	计数器	CRITICAL	因可重试错误而失败的运行次数。
`lg_api_run_failed_after_retry_counter`	计数器	CRITICAL	在耗尽重试次数后失败的运行次数。
`lg_api_run_exceed_max_attempts_at_start_counter`	计数器	CRITICAL	因在开始时已超过最大尝试次数而被拒绝的运行次数。
`lg_api_run_abandoned_by_shutdown_counter`	计数器	CRITICAL	在服务器关闭期间被放弃的运行次数。
`lg_api_run_set_status_error_counter`	计数器	CRITICAL	更新运行状态时发生的错误次数。
`lg_api_failed_to_fetch_runs_counter`	计数器	CRITICAL	从队列中获取运行失败的次数。
`lg_api_run_execution_latency`	直方图 (毫秒)	INFO	端到端的运行执行延迟。
`lg_api_run_queue_wait_time_retry_attempt`	直方图 (毫秒)	INFO	重试尝试（首次之后）的队列等待时间。

流式传输与协议 v2

名称	类型	层级	描述
`lg_api_streaming_data_loss_counter`	计数器	CRITICAL	流式传输数据丢失事件次数。
`lg_api_stream_publish_latency`	直方图 (毫秒)	INFO	发布流式数据块的延迟。
`lg_api_stream_data_size_bytes`	直方图	DEBUG	已发布流式数据有效负载的大小（字节）。
`lg_api_protocol_v2_buffer_evicted_counter`	计数器	INFO	Event Streaming v2 重放缓冲区被逐出的次数。
`lg_api_protocol_v2_event_emitted_counter`	计数器	DEBUG	Event Streaming v2 发出的事件数。
`lg_api_protocol_v2_resume_gap_counter`	计数器	INFO	在重放期间检测到的 Event Streaming v2 恢复间隔数。
`lg_api_protocol_v2_transport_send_failure_counter`	计数器	INFO	Event Streaming v2 传输发送失败的次数。
`lg_api_protocol_v2_buffer_size`	仪表	DEBUG	每次运行当前 Event Streaming v2 重放缓冲区占用情况。当此值接近限制时，请调整 `LSD_PROTOCOL_V2_BUFFER_SIZE`。
`lg_api_protocol_v2_replayed_events`	直方图	DEBUG	在 Event Streaming v2 重连时重放的事件数量。

服务器与基础设施

名称	类型	层级	描述
`lg_api_server_started_counter`	计数器	INFO	服务器启动事件次数。
`lg_api_server_requested_to_stop_counter`	计数器	INFO	收到的优雅关闭请求数。
`lg_api_server_stopped_counter`	计数器	INFO	服务器停止事件次数。
`lg_api_graph_recursion_limit_error_counter`	计数器	INFO	图递归限制错误次数。
`lg_api_publish_queue_availability`	仪表	CRITICAL	Redis 发布队列可用性信号。

另请参阅

Connect these docs to Claude, VSCode, and more via MCP for real-time answers.

Edit this page on GitHub or file an issue.

Configure

Reference

指标后端

指标层级

配置导出

Prometheus

Datadog

部署界面指标

内部指标

运行生命周期

流式传输与协议 v2

服务器与基础设施

另请参阅

​指标后端

​指标层级

​配置导出

​Prometheus

​Datadog

​部署界面指标

​内部指标

​运行生命周期

​流式传输与协议 v2

​服务器与基础设施

​另请参阅

指标后端

指标层级

配置导出

Prometheus

Datadog

部署界面指标

内部指标

运行生命周期

流式传输与协议 v2

服务器与基础设施

另请参阅