サンドボックスのログ

このガイドでは、実行中のサンドボックスからコンテナーログを取得して、メインプロセスを監視したり障害をデバッグしたりする方法を説明します。ログは、サンドボックスを停止する前に取得してください。コンテナーログとは、サンドボックスのメインプロセスの stdout と stderr です。stream_logs() を使用してストリーミングできます。この関数は、Sandbox.run() に渡したコマンドの出力を取得します。exec() コマンドの出力は含まれないため、その出力には Process.stdout または Process.stderr を使用してください。 stream_logs() は、ログ行を順に返す StreamReader を返します。同期と非同期のどちらでも反復処理できます。

コマンドを指定せずに Sandbox.run() を呼び出した場合、サンドボックスのデフォルトコマンドは stdout にも stderr にも書き込まないため、stream_logs() は何も出力しません。stdout または stderr に書き込むコマンドを渡してください。

認証を選択する

CKS が指定されているセクションを除き、これらの例はサーバーレスキャパシティ上で実行されます。サンドボックスを所有するアカウントの認証情報を選択してください。キーまたはトークンの取得方法については、認証情報の選択と取得を参照してください。インストールコマンドは、有効化した Python 仮想環境で実行してください。使用する認証情報のタブにある Python コードを、このページで実行する Python スクリプトと同じディレクトリに sandbox_auth.py として保存します。このファイルに保存されるのは認証方式の選択であり、認証情報そのものではありません。各例ではこのファイルから AUTH をインポートし、新しいサンドボックスやセッションを作成するたびに明示的に渡します。

Forge API キー
CoreWeave API アクセストークン

SDK の W&B 認証方式を使って Forge APIキーを使用します。

uv pip install 'cwsandbox[wandb]>=1.14.2'
export WANDB_API_KEY="[WANDB-API-KEY]"

sandbox_auth.py

from cwsandbox import AuthStrategy

AUTH = AuthStrategy.WANDB

CoreWeave 組織のトークンを使用します。

uv pip install 'cwsandbox>=1.14.2'
export CWSANDBOX_API_KEY="[API-ACCESS-TOKEN]"

sandbox_auth.py

from cwsandbox import AuthStrategy

AUTH = AuthStrategy.COREWEAVE_API_KEY

CKS に配置する場合は、CoreWeave トークンを選択してランナーを有効化し、サンドボックスの作成時または SandboxDefaults で placement_mode="cks" を設定します。auth=AUTH を指定してセッションを作成すると、そのセッションが所有するサンドボックスも認証されます。サンドボックスへの再接続、一覧表示、クリーンアップを行う際も、同じ認証情報を使用してください。

最近のログを取得する

tail_lines を使用して、履歴全体をストリーミングせずに最新のログ行を取得します。これは実行中のサンドボックスを素早く確認するのに役立ちます。

for line in sandbox.stream_logs(tail_lines=100):
    print(line, end="")

フォローモード

ログを継続的にストリーミングします。tail -f のように動作します。新しいデータが到着するまでイテレーターはブロックします。

for line in sandbox.stream_logs(follow=True):
    print(line, end="")

フォローモードで反復処理を行う際は Ctrl+C を押して停止してください。

時間でフィルター

since_time を渡すと、特定のタイムスタンプ以降のログのみを取得できます。これにより、出力を関心のあるウィンドウに絞り込めます。たとえば、デプロイメントやインシデント以降のログなどです。

from datetime import datetime, timezone

since = datetime(2026, 2, 20, 14, 0, 0, tzinfo=timezone.utc)
for line in sandbox.stream_logs(since_time=since):
    print(line, end="")

タイムスタンプ

timestamps=True を設定すると、各行の先頭にサーバーからの ISO 8601 タイムスタンプが付加されます。サーバー側タイムスタンプは、サンドボックスイベントを他のシステムと関連付けるのに役立ちます。

for line in sandbox.stream_logs(tail_lines=10, timestamps=True):
    print(line, end="")
# 出力: 2026-02-20T14:30:00Z ログ行の例

Async 反復処理

アプリケーションで asyncio を使用している場合は、イベントループをブロックしないように、同じ StreamReader を async for で反復処理してください。

async for line in sandbox.stream_logs(follow=True):
    print(line, end="")

停止する前にログを取得する

ログを取得するには、サンドボックスが実行中である必要があります。必要なログは、サンドボックスを停止する前に取得してください。サンドボックスの停止後は、Python SDK と CLI のいずれでもログの取得は拒否されます。