サンドボックスのログ

以下の例では、CWSANDBOX_API_KEY に設定した CoreWeave API アクセストークンを使用します。Forge APIキーによる認証については、はじめにを参照してください。CKS の要件については、配置モードを参照してください。このガイドでは、サンドボックスからコンテナーログを取得する方法を説明します。コンテナーログを使用すると、メインプロセスの動作を監視したり、障害をデバッグしたり、サンドボックスの停止後に出力を確認したりできます。コンテナーログとは、サンドボックスのメインプロセスの stdout と stderr です。stream_logs() を使用してストリーミングできます。この関数は、Sandbox.run() に渡したコマンドの出力を取得します。exec() コマンドの出力は含まれないため、その出力には Process.stdout または Process.stderr を使用してください。 stream_logs() は、ログ行を順に返す StreamReader を返します。同期と非同期のどちらでも反復処理できます。

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

最近のログを取得する

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="")

停止したサンドボックスからログを取得する

ログはサンドボックスが停止した後も利用可能なままなので、失敗を調査したり、完了した作業の出力を確認したりできます。完了、失敗、または終了したサンドボックスから過去のログを取得します：

sb = Sandbox.from_id("sbx-abc123").result()
for line in sb.stream_logs(tail_lines=50):
    print(line, end="")

停止したサンドボックスでは、follow=False (デフォルト) のみがサポートされます。