> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wandb.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Weave 환경 변수 구성

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

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

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

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

```python lines theme={null}
# Python에서 환경 변수를 설정하는 예시
import os

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

<div id="available-environment-variables">
  ## 사용 가능한 환경 변수
</div>

다음 표에는 지원되는 각 환경 변수와 해당 유형, 기본값, 그리고 제어하는 동작이 나와 있습니다. 불리언 변수 설정 시 허용되는 값은 불리언 값에 대한 참고를 확인하세요.

| Variable                        | Type     | Default         | Description                                                                                                                                                                                            |
| ------------------------------- | -------- | --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `WANDB_API_KEY`                 | `string` | `None`          | 설정하면 API 키를 묻지 않고 자동으로 W\&B Weave에 로그인합니다. API 키를 생성하려면 W\&B 계정에 로그인한 다음 [User Settings](https://wandb.ai/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)](/ko/weave/guides/tracking/write-ahead-log)를 활성화합니다. `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에 인증할 수 있습니다.                              |

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

  * `true`, `1`, `yes`, `on`은 `True`
  * `false`, `0`, `no`, `off`는 `False`
</Note>