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

# ライトアヘッドログ

> ライトアヘッドログを使用して、W&B Weave のトレースデータ取得の耐障害性を向上させます

ライトアヘッドログ (WAL) は、API リクエストをサーバーに送信する前にディスクに永続化します。デフォルトでは、クライアントはリクエストをメモリ上にバッファします。プロセスが予期せず終了すると、バッファされたデータは失われます。Weave の WAL は、リクエストを送信前にディスクへ書き込むことでこの問題に対処します。

WAL を有効にすると、クライアントは各 API リクエストをまずローカルの JSONL ファイルに書き込み、その後ファイルの内容をサーバーへフラッシュします。プロセスがクラッシュした場合やサーバーに到達できない場合でも、データはディスク上に残り、クライアントが次回実行されたときに Weave が自動的に送信します。

WAL は、プロセスが中断される可能性がある環境や、サーバーが一時的に利用できなくなる可能性がある環境で特に有用です。

* **コンテナーオーケストレーション**: バックグラウンドスレッドがトレースのアップロードを完了する前に、Pod が退避 (evict) されたり OOM によって強制終了されたりする可能性がある場合。
* **分散トレーニング**: 複数のプロセスが並列にトレースを書き込み、いずれかのプロセスが失敗する可能性がある場合。
* **不安定なネットワーク**: Weave サーバーへの接続性が断続的な環境。
* **バッチジョブ**: クラッシュによってトレースデータが失われると損害が大きい、長時間実行されるジョブ。

サーバーレス関数のような短命な環境では、すべてのデータを確実にアップロードするために、プロセスの終了前に `weave.flush()` または `weave.finish()` を呼び出すことも検討してください。詳細については、[ワーカープロセスにおけるトレースデータの損失](/ja/support/weave/articles/trace-data-loss-in-worker-processes)を参照してください。

<Note>
  ライトアヘッドログはオプトイン方式です。今後のリリースでデフォルトで有効になる予定です。
</Note>

<h2 id="enable-the-write-ahead-log">
  ライトアヘッドログを有効にする
</h2>

Weave クライアントで WAL を有効にするには、環境変数 `WEAVE_ENABLE_WAL` を `true` に設定します。

```bash theme={"system"}
export WEAVE_ENABLE_WAL=true
```

`weave.init()` を呼び出す前に、Python で設定することもできます。

```python theme={"system"}
import os
os.environ["WEAVE_ENABLE_WAL"] = "true"
```

ほかにコードの変更は必要ありません。WAL は、既存の Weave トレースコードで透過的に動作します。

<h2 id="how-it-works">
  仕組み
</h2>

WAL が有効な場合:

1. Weave は、Weave API への各呼び出し (オブジェクトの作成、呼び出しの開始、呼び出しの終了など) を、メモリ内だけに保持するのではなく、ディスク上の JSONL ファイルに追記します。
2. 各プロセスは独自のログファイルに書き込むため、並列プロセス間で競合しません。
3. バックグラウンドの送信プロセスがログファイルを読み取り、その内容を Weave サーバーにフラッシュします。
4. データの送信に成功すると、Weave はログファイルを削除します。

ログファイルは、作業ディレクトリ内の `.weave/wal/` に、entity と project ごとに整理して保存されます。各ファイルには、生の API リクエストが JSON オブジェクトとして 1 行に 1 件ずつ格納されます。

クライアントは起動時に、以前の run のログファイルが残っていないかを確認します。見つかった場合、送信プロセスは新しいデータとともにそれらをフラッシュします。これにより、クラッシュしたプロセスが書き込んだデータは、次回クライアントが実行されたときに Weave によって自動的に復元されます。

<h2 id="environment-variables">
  環境変数
</h2>

以下の環境変数は、ライトアヘッドログの動作を制御します。

| 変数 | タイプ | デフォルト | 説明 |
| - | - | - | - |
| `WEAVE_ENABLE_WAL` | `bool` | `false` | ライトアヘッドログを有効にします。`true` に設定すると、Weave は API リクエストをサーバーに送信する前にローカルのディスクに書き込みます。 |
| `WEAVE_DISABLE_WAL_SENDER` | `bool` | `false` | WAL 送信プロセスを無効にします。`true` に設定すると、Weave はリクエストをローカルのディスクに書き込みますが、サーバーにはフラッシュしません。これはデバッグに役立ちます。 |

Weave の利用可能なすべての環境変数の一覧については、[環境変数](/ja/products/wandb/weave/guides/core-types/env-vars) のリファレンスページを参照してください。


## Related topics

- [サーバー応答のキャッシュ](/ja/products/wandb/weave/guides/platform/server-caching.md)