Weave 환경 변수 구성

환경 변수를 사용해 런타임 시 Weave의 동작을 구성합니다

Weave는 동작을 구성하고 최적화할 수 있는 여러 환경 변수를 제공합니다. 셸이나 스크립트에서 이러한 변수를 설정하여 특정 기능을 제어할 수 있습니다.

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

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

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

​

사용 가능한 환경 변수

Variable	Type	Default	Description
WANDB_API_KEY	string	None	설정되어 있으면 API 키를 입력하라는 프롬프트 없이 자동으로 W&B Weave에 로그인합니다. API 키를 생성하려면 W&B 계정에 로그인한 뒤 User Settings로 이동하세요.
WEAVE_DISABLED	bool	false	true로 설정하면 모든 Weave 트레이싱을 비활성화합니다. Weave op는 일반 함수처럼 동작합니다.
WEAVE_PRINT_CALL_LINK	bool	true	Weave op를 호출할 때 Weave 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	evaluation에서 병렬로 평가할 예제 개수를 제어합니다. 1로 설정하면 예제가 순차적으로 실행됩니다.
WEAVE_TRACE_LANGCHAIN	bool	true	LangChain에 대한 전역 트레이싱을 제어합니다. LangChain 트레이싱을 명시적으로 비활성화하려면 false로 설정하세요.
WEAVE_USE_SERVER_CACHE	bool	true	서버 응답 캐싱을 활성화합니다. 활성화되면 서버 응답이 디스크에 캐시되어 반복되는 쿼리의 성능이 향상됩니다.
WEAVE_SERVER_CACHE_SIZE_LIMIT	int	1000000000	서버 캐시의 최대 크기(바이트 단위)를 설정합니다. 캐시가 이 크기에 도달하면 새로운 항목을 위한 공간을 만들기 위해 오래된 항목이 자동으로 제거됩니다. 중요: 내부 구현은 SQLite를 사용하며, SQLite의 Write Ahead Log(WAL)는 이 설정과 관계없이 4MB까지 증가합니다. 이 WAL은 프로그램이 종료되면 제거됩니다.
WEAVE_SERVER_CACHE_DIR	str	None	캐시 파일을 저장할 디렉터리를 지정합니다. 설정하지 않으면 임시 디렉터리가 사용됩니다.
WEAVE_MAX_CALLS_QUEUE_SIZE	int	100000	calls 큐의 최대 크기를 설정합니다. 기본값은 100_000입니다. 값을 0으로 설정하면 큐가 무한정 커질 수 있습니다.
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, 1, yes, on → True로 처리됨
• false, 0, no, off → False로 처리됨