Weave 환경 변수 구성 - Weights & Biases Documentation

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

​사용 가능한 환경 변수

사용 가능한 환경 변수