BG_JOB_ISOLATED_LOOPS
서빙 API 이벤트 루프와 분리된 독립적인 이벤트 루프에서 백그라운드 실행을 수행하려면 BG_JOB_ISOLATED_LOOPS를 True로 설정하세요.
그래프/노드 구현에 동기 코드가 포함되어 있는 경우 이 환경 변수를 True로 설정해야 합니다. 이러한 상황에서는 동기 코드가 서빙 API 이벤트 루프를 차단하여 API를 사용할 수 없게 만들 수 있습니다. API를 사용할 수 없게 되는 증상으로는 헬스 체크 실패로 인한 애플리케이션의 지속적인 재시작이 있습니다.
기본값은 False입니다.
BG_JOB_SHUTDOWN_GRACE_PERIOD_SECS
큐가 종료 신호를 받은 후 서버가 백그라운드 작업이 완료될 때까지 대기하는 시간을 초 단위로 지정합니다. 이 기간이 지나면 서버는 강제로 종료됩니다. 기본값은 180초입니다. 종료 중에 작업이 완전히 완료될 수 있도록 충분한 시간을 확보하려면 이 값을 설정하세요. langgraph-api==0.2.16에서 추가되었습니다.
BG_JOB_TIMEOUT_SECS
백그라운드 실행의 타임아웃은 증가시킬 수 있습니다. 하지만 Cloud 배포의 인프라는 API 요청에 대해 1시간 타임아웃 제한을 적용합니다. 이는 클라이언트와 서버 간의 연결이 1시간 후에 타임아웃된다는 것을 의미합니다. 이는 구성할 수 없습니다.
백그라운드 실행은 1시간보다 오래 실행될 수 있지만, 실행이 1시간보다 오래 걸리는 경우 실행에서 출력을 검색하려면 클라이언트가 서버에 다시 연결해야 합니다(예: POST /threads/{thread_id}/runs/{run_id}/stream을 통해 스트림에 참여).
기본값은 3600입니다.
DD_API_KEY
배포에 대한 Datadog 추적을 자동으로 활성화하려면 DD_API_KEY(Datadog API 키)를 지정하세요. 추적 계측을 구성하려면 다른 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)을 재정의하거나 간섭할 수 있습니다.LANGCHAIN_TRACING_SAMPLING_RATE
LangSmith로 전송되는 추적의 샘플링 비율입니다. 유효한 값: 0과 1 사이의 모든 부동 소수점 수.
자세한 내용은 추적에 대한 샘플링 비율 설정을 참조하세요.
LANGGRAPH_AUTH_TYPE
LangGraph Server 배포에 대한 인증 유형입니다. 유효한 값: langsmith, noop.
LangSmith에 배포하는 경우 이 환경 변수는 자동으로 설정됩니다. 로컬 개발 또는 인증이 외부에서 처리되는 배포(예: 자체 호스팅)의 경우 이 환경 변수를 noop으로 설정하세요.
LANGGRAPH_POSTGRES_POOL_MAX_SIZE
langgraph-api 버전 0.2.12부터 Postgres 연결 풀의 최대 크기(복제본당)는 LANGGRAPH_POSTGRES_POOL_MAX_SIZE 환경 변수를 사용하여 제어할 수 있습니다. 이 변수를 설정하면 서버가 Postgres 데이터베이스와 설정할 동시 연결 수의 상한을 결정할 수 있습니다.
예를 들어, 배포가 10개의 복제본으로 확장되고 LANGGRAPH_POSTGRES_POOL_MAX_SIZE가 150으로 구성된 경우, Postgres에 대해 최대 1500개의 연결이 설정될 수 있습니다. 이는 데이터베이스 리소스가 제한적이거나(또는 더 많이 사용 가능하거나) 성능 또는 확장 이유로 연결 동작을 조정해야 하는 배포에 특히 유용합니다.
기본값은 150 연결입니다.
LANGSMITH_API_KEY
자체 호스팅 LangSmith 배포에만 해당됩니다.
자체 호스팅 LangSmith 인스턴스로 추적을 전송하려면 자체 호스팅 인스턴스에서 생성된 API 키로 LANGSMITH_API_KEY를 설정하세요.
LANGSMITH_ENDPOINT
자체 호스팅 LangSmith 배포에만 해당됩니다.
자체 호스팅 LangSmith 인스턴스로 추적을 전송하려면 자체 호스팅 인스턴스의 호스트 이름으로 LANGSMITH_ENDPOINT를 설정하세요.
LANGSMITH_TRACING
LangSmith로의 추적을 비활성화하려면 LANGSMITH_TRACING을 false로 설정하세요.
기본값은 true입니다.
LOG_COLOR
이는 주로 langgraph dev 명령을 통해 개발 서버를 사용하는 컨텍스트에서 관련이 있습니다. 기본 콘솔 렌더러를 사용할 때 ANSI 색상이 지정된 콘솔 출력을 활성화하려면 LOG_COLOR를 true로 설정하세요. 이 변수를 false로 설정하여 색상 출력을 비활성화하면 모노크롬 로그가 생성됩니다. 기본값은 true입니다.
LOG_LEVEL
로그 수준을 구성합니다. 기본값은 INFO입니다.
LOG_JSON
구성된 JSONRenderer를 사용하여 모든 로그 메시지를 JSON 객체로 렌더링하려면 LOG_JSON을 true로 설정하세요. 이는 로그 관리 시스템에서 쉽게 구문 분석하거나 수집할 수 있는 구조화된 로그를 생성합니다. 기본값은 false입니다.
MOUNT_PREFIX
자체 호스팅 배포에서만 허용됨
MOUNT_PREFIX 환경 변수는 자체 호스팅 배포 모델에서만 허용되며, LangSmith SaaS는 이 환경 변수를 허용하지 않습니다.MOUNT_PREFIX를 설정하세요. 이는 특정 경로 접두사가 필요한 리버스 프록시 또는 로드 밸런서 뒤에 서버가 있는 배포에 유용합니다.
예를 들어, 서버가 https://example.com/langgraph 아래에서 제공되어야 하는 경우 MOUNT_PREFIX를 /langgraph로 설정하세요.
N_JOBS_PER_WORKER
LangGraph Server 작업 큐의 워커당 작업 수입니다. 기본값은 10입니다.
POSTGRES_URI_CUSTOM
사용자 정의 Postgres 인스턴스를 사용하려면 POSTGRES_URI_CUSTOM을 지정하세요. POSTGRES_URI_CUSTOM의 값은 유효한 Postgres 연결 URI여야 합니다.
Postgres:
- 버전 15.8 이상.
- 초기 데이터베이스가 있어야 하며 연결 URI는 데이터베이스를 참조해야 합니다.
POSTGRES_URI_CUSTOM이 지정되면 Control Plane은 서버에 대한 데이터베이스를 프로비저닝하지 않습니다.POSTGRES_URI_CUSTOM이 제거되면 Control Plane은 서버에 대한 데이터베이스를 프로비저닝하지 않으며 외부에서 관리되는 Postgres 인스턴스를 삭제하지 않습니다.POSTGRES_URI_CUSTOM이 제거되면 개정판 배포가 성공하지 않습니다.POSTGRES_URI_CUSTOM이 한 번 지정되면 배포의 수명 주기 동안 항상 설정되어야 합니다.- 배포가 삭제되면 Control Plane은 외부에서 관리되는 Postgres 인스턴스를 삭제하지 않습니다.
POSTGRES_URI_CUSTOM의 값은 업데이트할 수 있습니다. 예를 들어, URI의 비밀번호를 업데이트할 수 있습니다.
- 사용자 정의 Postgres 인스턴스는 LangGraph Server에서 액세스할 수 있어야 합니다. 사용자가 연결성을 보장할 책임이 있습니다.
REDIS_CLUSTER
이 기능은 알파 버전입니다.
자체 호스팅 배포에서만 허용됨
Redis Cluster 모드는 자체 호스팅 배포 모델에서만 사용할 수 있으며, LangSmith SaaS는 기본적으로 Redis 인스턴스를 프로비저닝합니다.
REDIS_CLUSTER를 True로 설정하세요. 활성화되면 시스템은 클러스터 모드를 사용하여 Redis에 연결합니다. 이는 Redis Cluster 배포에 연결할 때 유용합니다.
기본값은 False입니다.
REDIS_KEY_PREFIX
API Server 버전 0.1.9+ 이상에서 사용 가능
이 환경 변수는 API Server 버전 0.1.9 이상에서 지원됩니다.
''입니다.
REDIS_URI_CUSTOM
사용자 정의 Redis 인스턴스를 사용하려면 REDIS_URI_CUSTOM을 지정하세요. REDIS_URI_CUSTOM의 값은 유효한 Redis 연결 URI여야 합니다.
RESUMABLE_STREAM_TTL_SECONDS
Redis에 있는 재개 가능한 스트림 데이터의 초 단위 수명(time-to-live)입니다.
실행이 생성되고 출력이 스트리밍될 때 스트림을 재개 가능하도록 구성할 수 있습니다(예: stream_resumable=True). 스트림이 재개 가능한 경우 스트림의 출력은 Redis에 임시로 저장됩니다. 이 데이터에 대한 TTL은 RESUMABLE_STREAM_TTL_SECONDS를 설정하여 구성할 수 있습니다.
재개 가능한 스트림을 구현하는 방법에 대한 자세한 내용은 Python 및 JS/TS SDK를 참조하세요.
기본값은 120초입니다.
Connect these docs programmatically to Claude, VSCode, and more via MCP for real-time answers.