Weave 환경 변수 구성

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

Weave는 동작을 구성하고 최적화할 수 있도록 다양한 환경 변수를 제공합니다. 이 페이지는 애플리케이션 코드를 수정하지 않고 트레이싱, 로깅, 캐싱, 재시도와 같은 런타임 동작을 조정하려는 Weave SDK 사용자 개발자를 위한 페이지입니다. 셸이나 스크립트에서 이러한 변수를 설정해 특정 기능을 제어할 수 있습니다.

다음 예시에서는 Weave 환경 변수를 설정하는 일반적인 두 가지 방법을 보여줍니다. 전체 Session에 대해 Weave를 구성하려면 셸 방식을 사용하고, 스크립트 내부에서 값을 설정하려면 Python 방식을 사용하세요.

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

# 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	평가에서 예시를 병렬로 몇 개 평가할지 제어합니다. 예시를 순차적으로 실행하려면 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를 사용하며, 여기에는 이 설정과 관계없이 4 MB까지 커지는 쓰기 전 로그(WAL)가 있습니다. 프로그램이 종료되면 Weave가 이 WAL을 제거합니다.
WEAVE_SERVER_CACHE_DIR	str	None	Weave가 캐시 파일을 저장하는 디렉터리를 지정합니다. 설정하지 않으면 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에 인증할 수 있습니다.

모든 불리언 환경 변수는 다음 값을 허용합니다(대소문자 구분 없음):

• true, 1, yes, on은 True
• false, 0, no, off는 False