コンソールログ - CoreWeave Docs

実験を実行すると、コンソールにメッセージが出力されることがあります。W&B はコンソールログを取得し、W&B アプリに表示します。これらのメッセージを使用して、実験の動作をデバッグしたり監視したりできます。以下のセクションでは、run のコンソールログの表示、設定、検索、フィルター、ダウンロード、コピーの方法について説明します。

コンソールログを表示する

W&B アプリで run のコンソールログを表示すると、run の実行中に生成されたメッセージを確認できます。

W&B アプリで対象の project にアクセスします。
Runs 表から run を選択します。
Run page で Logs タブを選択します。
オプション: ログをストリーミング中の実行中 run で上にスクロールした場合は、Jump to bottom を選択すると最新のログに戻れます。

ログのストリーミング中は、右上に省略記号アイコン () が表示されます。ログのポーリングが完了すると、このアイコンはダウンロードボタン () に切り替わります。

コンソールログのタイプ

W&B は 3 つのタイプのコンソールログを取得し、各ログの重大度を示す接頭辞を付加します。接頭辞があることで、ログをすばやく確認し、デバッグに特に関係するメッセージを見つけやすくなります。次の表は、各タイプを重大度の高い順にまとめたものです。

重大度	接頭辞	説明	例
Error	`ERROR`	run の正常な完了を妨げるおそれのある深刻な問題。	`ERROR Failed to save notebook.`
Warning	`WARNING`	実行は停止しないものの、問題につながる可能性がある事象。	`WARNING Found .wandb file, not streaming tensorboard metrics.`
Info	`wandb:`	run の進行状況とステータスに関する更新情報。	`wandb: Starting Run: abc123`

コンソールログの設定

W&B が取得して表示するコンソール出力のタイプを制御するには、run の初期化時に wandb.Settings オブジェクトを wandb.init() に渡します。関連するパラメーターには show_errors、show_warnings、show_info、silent などがあります。すべてのパラメーターは Settings referenceに記載されています。このリファレンスは SDK から自動生成されるため、新しいオプションが追加されても常に最新の状態に保たれます。次の例では、W&B からの情報メッセージ、警告、エラーを Logs タブに表示するかどうかを切り替えます。W&B のコンソール出力をすべて抑制するには、silent=True を設定します (トレーニングスクリプトの出力を最小限に抑えたい場合に便利です) 。

import wandb

settings = wandb.Settings(
    show_errors=True,
    silent=False,
    show_warnings=True,
)

with wandb.init(settings=settings) as run:
    run.log({"accuracy": 0.95})

stdout と stderr の取得 (console) 、マルチパートアップロード (console_multipart、console_chunk_max_bytes、console_chunk_max_seconds) 、およびトラブルシューティングについては、以下のセクションと Settings reference を参照してください。分散トレーニングやその他のエッジケースについては、run のコンソール出力が取得されないのはなぜですか？を参照してください。

マルチパートのコンソールログ

デフォルトでは、W&B はスクリプトの stdout と stderr を単一の output.log ファイルとして保存し、run の終了時にアップロードします。run の実行中も Logs タブで出力をストリーミング表示できますが、output.log は run が完了するまで Files タブに表示されません。 run の実行中にログをダウンロードしたい場合、run が終了前にクラッシュする可能性がある場合、または run を再開する際に以前のセッションのログ出力を残しておきたい場合は、マルチパートのコンソールログを有効にします。console_multipart=True (SDK v0.22.3 以降) を設定すると、SDK はタイムスタンプ付きのチャンクを logs/ 配下に書き込み、各チャンクを閉じた時点でアップロードします。ロールオーバーのタイミングは console_chunk_max_bytes と console_chunk_max_seconds で制御できます。デフォルト値と、両方を 0 にした場合の動作については、Settings reference を参照してください。

アップロード済みのチャンクは不変です。前の行を書き換えるターミナル制御シーケンス (キャリッジリターンを使用するプログレスバーなど) は、現在のチャンクにのみ反映されます。

import wandb

with wandb.init(
    project="my-project",
    settings=wandb.Settings(
        console_multipart=True,
        console_chunk_max_bytes=1_000_000,  # 約 1 MB ごとにローテーション
        console_chunk_max_seconds=60,     # または 60 秒ごと（いずれか早い方）
    ),
) as run:
    print("Logs upload in chunks while this run is active.")

console_multipart は wandb.init の時点で設定する必要があります。run の開始後にアップロード頻度を変更することはできません。トラブルシューティング (コンソールの取得が無効になっている場合、分散トレーニング、再開した run、表示の制限など) については、run のコンソール出力が取得されないのはなぜですか？およびrun からコンソールログファイルをダウンロードするにはどうすればよいですか？を参照してください。

カスタムログ

独自のログ設定がすでにある場合は、W&B と併用して引き続き使用できます。W&B はアプリケーションのコンソールログを取得しますが、独自のログ設定には干渉しません。メッセージをログするには、Python の組み込み print() 関数または logging モジュールを使用できます。

import wandb

with wandb.init(project="my-project") as run:
    for i in range(100, 1000, 100):
        # W&B にログし、コンソールにも出力します
        run.log({"epoch": i, "loss": 0.1 * i})
        print(f"epoch: {i} loss: {0.1 * i}")

コンソールログは次のようになります。

epoch:  100 loss: 1.3191105127334595
epoch:  200 loss: 0.8664389848709106
epoch:  300 loss: 0.6157898902893066
epoch:  400 loss: 0.4961796700954437
epoch:  500 loss: 0.42592573165893555
epoch:  600 loss: 0.3771176040172577
epoch:  700 loss: 0.3393910825252533
epoch:  800 loss: 0.3082585036754608
epoch:  900 loss: 0.28154927492141724

タイムスタンプ

W&B は、コンソールログの各エントリにタイムスタンプを自動的に付与します。これにより、各ログメッセージがいつ生成されたかをトラッキングできます。コンソールログのタイムスタンプの表示と非表示を切り替えるには、コンソールログページで Timestamp visible ドロップダウンリストを選択します。

コンソールログを検索する

コンソールログページの検索バーを使用して、ラベル、キーワード、エラーメッセージなどの特定のテキストを検索します。新しいログがストリーミングされるたびに、W&B は一致件数を更新します。

カスタムラベルでフィルターする

接頭辞 x_ が付いたパラメーター (x_label など) はパブリックプレビュー段階です。フィードバックは、W&B リポジトリの GitHub issue からお寄せください。

wandb.Settings の x_label に引数として渡したラベルを使って、コンソールログをフィルターできます。コンソールログページの検索バーにラベルを入力します。

import wandb

# プライマリノードで run を初期化します
with wandb.init(
    entity="[ENTITY-NAME]",
    project="[PROJECT-NAME]",
    settings=wandb.Settings(
        x_label="[CUSTOM-LABEL]"  # （オプション）ログのフィルタリングに使用するカスタムラベル
    )
) as run:
    # ここにコードを記述します

コンソールログをダウンロードする

ログをローカルに保存してオフラインで分析したり共有したりするには、W&B アプリで run のコンソールログをダウンロードします。

W&B アプリで対象の project にアクセスします。
Runs 表で run を選択します。
プロジェクトのサイドバーで Logs タブをクリックします。
コンソールログページで、ログファイルのダウンロードボタン () をクリックします。

run がログをストリーミングしている間は、一時的にログをダウンロードできない場合があります。ストリーミング中は、ダウンロードボタンの代わりに省略記号アイコン () が表示されます。run が終了するか、ストリーミングが停止するまで待ってから、もう一度お試しください。

コンソールログをコピーする

ログを別のツールやメッセージに貼り付けるには、W&B アプリで run のコンソールログをコピーします。

W&B アプリで対象の project にアクセスします。
Runs 表で run を選択します。
プロジェクトのサイドバーにある Logs タブをクリックします。
コンソールログページでコピーボタンをクリックします。

​コンソールログを表示する

​コンソールログのタイプ

​コンソールログの設定

​マルチパートのコンソールログ

​カスタムログ

​タイムスタンプ

​コンソールログを検索する

​カスタムラベルでフィルターする

​コンソールログをダウンロードする

​コンソールログをコピーする

コンソールログを表示する

コンソールログのタイプ

コンソールログの設定

マルチパートのコンソールログ

カスタムログ

タイムスタンプ

コンソールログを検索する

カスタムラベルでフィルターする

コンソールログをダウンロードする

コンソールログをコピーする