BG_JOB_ISOLATED_LOOPS
将 BG_JOB_ISOLATED_LOOPS 设置为 True，以便在与服务 API 事件循环分离的独立事件循环中执行后台运行。
如果图/节点的实现包含同步代码，则应将此环境变量设置为 True。在这种情况下，同步代码会阻塞服务 API 事件循环，可能导致 API 不可用。API 不可用的一个症状是由于健康检查失败而导致应用程序持续重启。
默认值为 False。
BG_JOB_MAX_RETRIES
后台运行在发生可重试失败（例如，瞬时数据库错误、服务器关闭取消）后将被重试的最大次数。当运行因可重试错误而失败时，它会被放回队列并从最后一个检查点步骤恢复。如果运行超过最大重试次数，则标记为失败。
默认值为 3。
BG_JOB_SHUTDOWN_GRACE_PERIOD_SECS
指定服务器在队列收到关闭信号后等待后台作业完成的秒数。超过此期限后，服务器将强制终止。默认值为 180 秒。最大值为 3600 秒。设置此值以确保作业在关闭期间有足够的时间干净地完成。在 langgraph-api==0.2.16 中添加。
BG_JOB_TIMEOUT_SECS
可以增加后台运行的超时时间。但是，云部署的基础设施对 API 请求强制执行 1 小时的超时限制。这意味着客户端和服务器之间的连接将在 1 小时后超时。这是不可配置的。
后台运行可以执行超过 1 小时，但如果运行时间超过 1 小时，客户端必须重新连接到服务器（例如，通过 POST /threads/{thread_id}/runs/{run_id}/stream 加入流）以检索运行的输出。
默认值为 86400。
CORS_ALLOW_ORIGINS
设置 CORS_ALLOW_ORIGINS 以指定允许的来源。
- 允许单个来源的示例：
CORS_ALLOW_ORIGINS=https://example.com - 允许多个来源的示例：
CORS_ALLOW_ORIGINS=https://example.com,https://app.example.com
*（所有来源）。
DD_API_KEY
指定 DD_API_KEY（您的 Datadog API 密钥）以自动为部署启用 Datadog 追踪。指定其他 DD_* 环境变量 以配置追踪检测。
如果指定了 DD_API_KEY，应用程序进程将包装在 ddtrace-run 命令 中。通常需要其他 DD_* 环境变量（例如 DD_SITE、DD_ENV、DD_SERVICE、DD_TRACE_ENABLED）来正确配置追踪检测。有关更多详细信息，请参阅 DD_* 环境变量。您可以启用 DD_TRACE_DEBUG=true 并设置 DD_LOG_LEVEL=debug 进行故障排除。
启用
DD_API_KEY（从而启用 ddtrace-run）可能会覆盖或干扰您可能已检测到应用程序代码中的其他自动检测解决方案（例如 OpenTelemetry）。LANGGRAPH_POSTGRES_POOL_MAX_SIZE
从 langgraph-api 版本 0.2.12 开始，可以使用 LANGGRAPH_POSTGRES_POOL_MAX_SIZE 环境变量控制 Postgres 连接池（每个副本）的最大大小。通过设置此变量，您可以确定服务器将与 Postgres 数据库建立的同时连接数的上限。
例如，如果部署扩展到 10 个副本，并且 LANGGRAPH_POSTGRES_POOL_MAX_SIZE 配置为 150，则最多可以建立 1500 个到 Postgres 的连接。这对于数据库资源有限（或更充足）的部署，或者需要为性能或扩展原因调整连接行为的部署特别有用。
当启用 BG_JOB_ISOLATED_LOOPS 时，池不共享。相反，每个后台工作线程创建自己的池，最大大小为 LANGGRAPH_POSTGRES_POOL_MAX_SIZE / N_JOBS_PER_WORKER。在降低池大小时请记住这一点。对于共享池运行良好的值，在隔离循环下可能导致每个工作线程的池非常小。
默认值为 150 个连接。
LS_DEFAULT_CHECKPOINTER_BACKEND
为未在 langgraph.json 中指定检查点后端的代理服务器设置默认的检查点后端。接受的值："default" (PostgreSQL)、"mongo"、"custom"。
如果应用程序的 langgraph.json 包含 checkpointer.backend 值，则该值优先于此变量。
当设置为 "mongo" 时，您还必须通过 LS_MONGODB_URI 提供 MongoDB 连接 URI。
LANGSMITH_API_KEY
仅适用于自托管 LangSmith 的部署。
要将追踪发送到自托管的 LangSmith 实例，请将 LANGSMITH_API_KEY 设置为从自托管实例创建的 API 密钥。
LANGSMITH_ENDPOINT
仅适用于自托管 LangSmith 的部署。
要将追踪发送到自托管的 LangSmith 实例，请将 LANGSMITH_ENDPOINT 设置为自托管实例的主机名。
LANGSMITH_TRACING
将 LANGSMITH_TRACING 设置为 false 以禁用向 LangSmith 发送追踪。
有关基于运行时条件（例如每个客户端要求或数据敏感性）的选择性追踪控制，请参阅条件追踪。
true。
LOG_COLOR
这主要在使用 langgraph dev 命令通过开发服务器时相关。将 LOG_COLOR 设置为 true 以在使用默认控制台渲染器时启用 ANSI 彩色控制台输出。通过将此变量设置为 false 来禁用彩色输出会产生单色日志。默认值为 true。
LOG_LEVEL
配置日志级别。默认值为 INFO。
LOG_JSON
将 LOG_JSON 设置为 true，以使用配置的 JSONRenderer 将所有日志消息渲染为 JSON 对象。这会生成结构化日志，可以轻松地被日志管理系统解析或摄取。默认值为 false。
MOUNT_PREFIX
仅允许在自托管部署中使用
MOUNT_PREFIX 环境变量仅允许在自托管部署模型中使用，LangSmith SaaS 不允许此环境变量。MOUNT_PREFIX 以在特定路径前缀下提供 Agent Server 服务。这对于服务器位于需要特定路径前缀的反向代理或负载均衡器后面的部署非常有用。
例如，如果服务器要在 https://example.com/langgraph 下提供服务，请将 MOUNT_PREFIX 设置为 /langgraph。
N_JOBS_PER_WORKER
Agent Server 任务队列的每个工作线程的作业数。默认值为 10。
LS_APM_OTEL_ENABLED
要为部署配置 OpenTelemetry APM 追踪，请将 LS_APM_OTEL_ENABLED 设置为 true，并将 OTEL_EXPORTER_OTLP_TRACES_ENDPOINT 或 OTEL_EXPORTER_OTLP_ENDPOINT 设置为目标追踪摄取端点。请注意，在 0.7.17 之后的服务器版本中，需要同时设置 LS_APM_OTEL_ENABLED 和另外两个导出端点之一才能激活 OpenTelemetry APM 追踪。
指定其他 OTEL_* 环境变量 以配置追踪、日志记录和其他检测。
OTel APM 追踪在 Agent Server 版本
0.5.32 中添加，目前处于 Alpha 阶段。LS_MONGODB_URI
用于 MongoDB 检查点后端的 MongoDB 连接 URI。
URI 必须指向副本集成员或 mongos 路由器，并且必须在路径中包含数据库名称。
有关详细信息，请参阅配置检查点后端。
POSTGRES_URI_CUSTOM
指定 POSTGRES_URI_CUSTOM 以使用自定义 Postgres 实例。POSTGRES_URI_CUSTOM 的值必须是有效的 Postgres 连接 URI。
Postgres 要求：
- 版本 15.8 或更高。
- 必须存在初始数据库，并且连接 URI 必须引用该数据库。
- 如果指定了
POSTGRES_URI_CUSTOM，控制平面将不会为服务器配置数据库。 - 如果删除了
POSTGRES_URI_CUSTOM，控制平面将不会为服务器配置数据库，也不会删除外部管理的 Postgres 实例。 - 如果删除了
POSTGRES_URI_CUSTOM，修订版的部署将不会成功。一旦指定了POSTGRES_URI_CUSTOM，在部署的整个生命周期中必须始终设置它。 - 如果删除部署，控制平面不会删除外部管理的 Postgres 实例。
POSTGRES_URI_CUSTOM的值可以更新。例如，可以更新 URI 中的密码。
- 自定义 Postgres 实例必须可被 Agent Server 访问。用户负责确保连接性。
REDIS_CLUSTER
仅允许在自托管部署中使用
Redis 集群模式仅在自托管部署模型中可用，LangSmith SaaS 将默认为您配置一个 redis 实例。
REDIS_CLUSTER 设置为 True 以启用 Redis 集群模式。启用后，系统将使用集群模式连接到 Redis。这在连接到 Redis 集群部署时非常有用。
默认值为 False。
REDIS_KEY_PREFIX
在 API Server 版本 0.1.9+ 中可用
此环境变量在 API Server 版本 0.1.9 及更高版本中受支持。
''。
REDIS_URI_CUSTOM
指定 REDIS_URI_CUSTOM 以使用自定义 Redis 实例。REDIS_URI_CUSTOM 的值必须是有效的 Redis 连接 URI。
REDIS_MAX_CONNECTIONS
可以使用 REDIS_MAX_CONNECTIONS 环境变量控制 Redis 连接池（每个副本）的最大大小。通过设置此变量，您可以确定服务器将与 Redis 实例建立的同时连接数的上限。
例如，如果部署扩展到 10 个副本，并且 REDIS_MAX_CONNECTIONS 配置为 150，则最多可以建立 1500 个到 Redis 的连接。
默认值为 2000。
RESUMABLE_STREAM_TTL_SECONDS
Redis 中可恢复流数据的生存时间（秒）。
当创建运行并流式传输输出时，可以将流配置为可恢复（例如 stream_resumable=True）。如果流是可恢复的，流的输出会临时存储在 Redis 中。此数据的 TTL 可以通过设置 RESUMABLE_STREAM_TTL_SECONDS 来配置。
有关如何实现可恢复流的更多详细信息，请参阅 Python 和 JS/TS SDK。
默认值为 120 秒。
为
RESUMABLE_STREAM_TTL_SECONDS 设置非常高的值，当有许多并发运行且具有大量或频繁的流输出时，可能导致大量的 Redis 内存使用。请将此值设置为最小值以在网络中断期间启用恢复，并优先使用检查点来实现长期持久性和执行快照。Connect these docs to Claude, VSCode, and more via MCP for real-time answers.