> ## 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 run の初期化やアップロードが遅いのはなぜですか？

`wandb.init()` の実行やメトリクスのアップロードが遅い場合、主な原因として、ネットワークのレイテンシー、メディアのペイロードサイズが大きいこと、ログする頻度が高いこと、W\&B の service プロセスの起動に時間がかかっていることなどが考えられます。

## wandb.init() が遅い

`wandb.init()` は W\&B API に接続して run を作成し、認証情報を検証します。数秒以上応答がない場合は、次の点を確認してください。

* **接続性を確認する**: `curl -I https://api.wandb.ai` を実行して、マシンから W\&B API に到達できることを確認します。よくある原因は、クラスター上のファイアウォールルールやプロキシ設定です。

* **init のタイムアウトを延長する**: 接続が不安定な場合は、`wandb.init()` がタイムアウトするまでの時間を延ばします。

  ```python theme={"system"}
  import os
  os.environ["WANDB_INIT_TIMEOUT"] = "120"   # 秒
  ```

* **テスト中はオフラインモードを使用する**: 試行錯誤の段階でリアルタイムの同期が不要な場合は、オフラインで実行して後から同期します。`[TIMESTAMP]` と `[ID]` は、対象の run のタイムスタンプと ID に置き換えてください。

  ```bash theme={"system"}
  WANDB_MODE=offline python train.py
  wandb sync wandb/run-[TIMESTAMP]-[ID]
  ```

## トレーニング中のメトリクスのアップロードが遅い

Weights & Biases はメトリクスをバックグラウンドスレッドで非同期にアップロードするため、トレーニングループがブロックされることはありません。ただし、次のような場合にはアップロードが追いつかなくなることがあります。

* **ログする頻度が高すぎる**: 高速な GPU で毎ステップ `wandb.log()` を呼び出すと、バックグラウンドスレッドでアップロードしきれない量のデータが生成されることがあります。N ステップごとにログするようにしてください。

  ```python theme={"system"}
  if step % 50 == 0:
      wandb.log({"loss": loss}, step=step)
  ```

* **毎ステップ大きなメディアをログしている**: `wandb.Image`、`wandb.Table`、`wandb.Video` オブジェクトは、スカラーのメトリクスに比べてサイズがはるかに大きくなります。リッチメディアは毎ステップではなく、エポックごとまたは N ステップごとにログしてください。

* **レート制限**: `429 Rate limit exceeded` エラーが発生した場合は、[レート制限超過エラーを解決するにはどうすればよいですか](https://docs.coreweave.com/ja/support/models/articles/rate-limit-exceeded-on-metric-logging)を参照してください。

## run の終了処理が遅い

スクリプトが `wandb.finish()` を呼び出した後 (またはスクリプトが終了した後) 、Weights & Biases はバッファに残っているデータをフラッシュします。トレーニング中に大量の未送信データが溜まっていると、この処理に時間がかかることがあります。最後にすべてをまとめてログするのではなく、トレーニング全体を通して適度な頻度でログするようにしてください。

## デバッグログを使用した診断

デバッグログを有効にすると、どこで時間がかかっているかを確認できます。

```bash theme={"system"}
WANDB_DEBUG=true python train.py
```

これにより、詳細なタイミング情報が `wandb/debug.log` と `wandb/debug-internal.log` に書き込まれます。

詳しくは、[Experiments の制限とパフォーマンス](https://docs.coreweave.com/ja/products/wandb/track/limits.md) および [ネットワークの問題にはどう対処すればよいですか？](https://docs.coreweave.com/ja/support/models/articles/how-do-i-deal-with-network-issues) を参照してください。

***

[Runs](https://docs.coreweave.com/ja/support/models/tags/runs.md)[Experiments](https://docs.coreweave.com/ja/support/models/tags/experiments.md)[接続性](https://docs.coreweave.com/ja/support/models/tags/connectivity.md)
