Weave 환경 변수 설정

Weave는 동작을 설정하고 최적화할 수 있는 다양한 환경 변수를 제공합니다. 이 페이지는 애플리케이션 코드를 수정하지 않고 트레이싱, 로깅, 캐싱, 재시도 등의 런타임 동작을 조정하려는 Weave SDK 사용 개발자를 위한 문서입니다. 이러한 변수를 셸이나 스크립트에서 설정하여 특정 기능을 제어할 수 있습니다. 다음 예시에서는 Weave 환경 변수를 설정하는 일반적인 두 가지 방법을 보여줍니다. 세션 전체에 Weave 설정을 적용하려면 셸 방식을, 스크립트 내에서 값을 설정하려면 Python 방식을 사용하세요.

# 셸에서 환경 변수를 설정하는 예시
export WEAVE_PARALLELISM=10  # 병렬 워커 수를 설정합니다
export WEAVE_PRINT_CALL_LINK=false  # call 링크 출력을 비활성화합니다

# Python에서 환경 변수를 설정하는 예시
import os

os.environ["WEAVE_PARALLELISM"] = "10"
os.environ["WEAVE_PRINT_CALL_LINK"] = "false"

사용 가능한 환경 변수

다음 표에는 지원되는 각 환경 변수의 유형, 기본값, 그리고 해당 변수가 제어하는 동작이 나와 있습니다. boolean 변수에 설정할 수 있는 값은 boolean 값에 대한 참고 사항을 확인하세요.

변수	유형	기본값	설명
`WANDB_API_KEY`	`string`	`None`	설정하면 API 키 입력 없이 Weights & Biases에 자동으로 로그인합니다. API 키를 생성하려면 CoreWeave Forge 계정에 로그인한 후 User Settings로 이동하세요.
`WEAVE_DISABLED`	`bool`	`false`	`true`로 설정하면 모든 Weave 트레이싱이 비활성화됩니다. Weave Op는 일반 함수처럼 동작합니다.
`WEAVE_PRINT_CALL_LINK`	`bool`	`true`	Weave Op를 호출할 때 Weights & Biases UI 링크를 출력할지 여부를 제어합니다. 다음과 같이 `weave.init()`의 `settings` 인수를 구성하여 코드에서 직접 설정할 수도 있습니다. `weave.init("your-project-name", settings={"print_call_link": False})`
`WEAVE_LOG_LEVEL`	`str`	`INFO`	Weave 로거의 로그 수준을 제어합니다.
`WEAVE_CAPTURE_CODE`	`bool`	`true`	나중에 다시 불러와 사용할 수 있도록 Op의 코드를 저장할지 여부를 제어합니다.
`WEAVE_DEBUG_HTTP`	`bool`	`false`	`true`로 설정하면 디버깅용 HTTP 요청 및 응답 로깅이 켜집니다.
`WEAVE_PARALLELISM`	`int`	`20`	평가 시 병렬로 평가할 예시 수를 제어합니다. 예시를 순차적으로 실행하려면 `1`로 설정하세요.
`WEAVE_TRACE_LANGCHAIN`	`bool`	`true`	LangChain의 전역 트레이싱을 제어합니다. LangChain 트레이싱을 명시적으로 비활성화하려면 `false`로 설정하세요.
`WEAVE_USE_SERVER_CACHE`	`bool`	`true`	서버 응답 캐싱을 활성화합니다. 활성화하면 Weave가 서버 응답을 디스크에 캐시하므로, 반복되는 쿼리는 서버에서 다시 가져오지 않고 캐시에서 제공됩니다.
`WEAVE_SERVER_CACHE_SIZE_LIMIT`	`int`	`1,000,000,000`	서버 캐시의 최대 크기를 바이트 단위로 설정합니다. 캐시가 이 크기에 도달하면 Weave는 새 항목을 저장할 공간을 확보하기 위해 오래된 항목을 자동으로 제거합니다. 중요: 내부적으로 SQLite를 사용하며, SQLite의 쓰기 전 로그(WAL)는 이 설정과 관계없이 최대 4 MB까지 커집니다. Weave는 프로그램이 종료될 때 이 WAL을 제거합니다.
`WEAVE_SERVER_CACHE_DIR`	`str`	`None`	Weave가 캐시 파일을 저장할 디렉터리를 지정합니다. 설정하지 않으면 임시 디렉터리를 사용합니다.
`WEAVE_MAX_CALLS_QUEUE_SIZE`	`int`	`100000`	Call 큐의 최대 크기를 설정합니다. 기본값은 `100000`입니다. `0`으로 설정하면 큐 크기가 제한 없이 늘어날 수 있습니다.
`WEAVE_ENABLE_WAL`	`bool`	`false`	Weave 쓰기 전 로그(WAL)를 활성화합니다. `true`로 설정하면 Weave는 API 요청을 서버로 보내기 전에 디스크에 기록하므로, 요청을 전송하기 전에 프로세스가 종료되더라도 요청을 복구할 수 있습니다.
`WEAVE_DISABLE_WAL_SENDER`	`bool`	`false`	Weave 쓰기 전 로그(WAL) 전송기를 비활성화합니다. `true`로 설정하면 Weave는 요청을 디스크에 기록하지만 서버로 플러시하지는 않습니다. 디버깅할 때 유용합니다.
`WEAVE_RETRY_MAX_ATTEMPTS`	`int`	`3`	실패한 요청의 최대 재시도 횟수를 설정합니다.
`WEAVE_RETRY_MAX_INTERVAL`	`float`	`300.0`	재시도 간 최대 간격을 초 단위로 설정합니다.
`WANDB_BASE_URL`	`string`	`None`	Weave 호스트 URL을 설정합니다. `wandb.login()`이 호스트 URL을 요청할 때 입력하는 것과 같습니다. `weave.init()`을 사용하기 전에 `WANDB_BASE_URL`과 `WANDB_API_KEY`를 지정하면 Weave에 자동으로 로그인하고 인증할 수 있습니다.

모든 boolean 환경 변수는 다음 값을 허용합니다(대소문자 구분 안 함).

True: true, 1, yes, on
False: false, 0, no, off

Weights & Biases

가이드

인테그레이션

레퍼런스

지원

Weave 환경 변수 설정

사용 가능한 환경 변수

​사용 가능한 환경 변수

사용 가능한 환경 변수