> ## Documentation Index
> Fetch the complete documentation index at: https://wb-21fd5541-mintlify-8476678c.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Run の状態

> W&B run が取りうるさまざまな状態について説明します。

[Run state](/ja/models/runs/run-states#run-states) は、W\&B run の現在のステータスを示します。run の[状態を確認](/ja/models/runs/run-states#view-the-state-of-a-run)するには、W\&B App を使用するか、W\&B Python SDK を使ってプログラムから確認します。

<div id="run-states">
  ## run の状態
</div>

次の表は、run が取り得る状態を示しています。

| 状態         | 説明                                                          |
| ---------- | ----------------------------------------------------------- |
| `Crashed`  | 内部プロセスで run からのハートビート送信が止まった状態です。これは、マシンがクラッシュした場合などに発生します。 |
| `Failed`   | run が非ゼロの終了ステータスで終了した状態です。                                  |
| `Finished` | run が終了し、データの Sync が完了したか、`wandb.Run.finish()` が呼び出された状態です。 |
| `Killed`   | run が完了する前に強制的に停止された状態です。                                   |
| `Running`  | run は現在も実行中で、直近でハートビートを送信しています。                             |
| `Pending`  | run はスケジュール済みですが、まだ開始されていません (sweep や Launch ジョブでよく見られます) 。 |

<div id="run-states-in-sweeps">
  ### sweep における run の状態
</div>

run が [sweep](/ja/models/sweeps/) の一部である場合でも、その状態は sweep のステータスとは独立しています。

* **個々の run の状態** は、各 run の実行ステータス (Running、Finished、Failed など) を反映します
* **sweep のステータス** は新しい run を作成するかどうかを制御するもので、既存の run の実行方法を制御するものではありません
* sweep を一時停止または停止しても、すでに実行中の run には影響しません
* 実行中の run を強制終了できるのは sweep をキャンセルした場合のみです (状態は `Killed` に変わります)

sweep のステータスと run のステータスがどのように関係するかについて詳しくは、[sweep と run のステータスの関係を理解する](/ja/models/sweeps/pause-resume-and-cancel-sweeps#understanding-sweep-and-run-statuses)を参照してください。

<div id="view-the-state-of-a-run">
  ## run の状態を表示する
</div>

Python SDK または W\&B App を使用して、run の状態をプログラムまたはインタラクティブに表示できます。

<Tabs>
  <Tab title="Python SDK">
    [`wandb.Api.Run`](/ja/models/ref/python/public-api/runs) オブジェクトの `state` プロパティを使用して、run の現在の状態にアクセスします。

    次のコード例は、指定したプロジェクト内のすべての run の状態を取得して出力します。次のコード例を Python 環境にコピー＆ペーストしてください。山かっこ (`< >`) で囲まれた値は、ご自身の値に置き換えてください。

    ```python theme={null}
    import wandb

    api = wandb.Api()

    runs = api.runs(path="<entity>/<project>")

    # run オブジェクトのプロパティにアクセス
    for run in runs:
        print(f"Run: {run.name}")
        print(f"Run state: {run.state}")
        print()
    ```

    さまざまな条件に基づいて、プロジェクトから run を取得するための異なるフィルターを適用できます。run をプログラムからフィルタリングする方法の詳細については、[Filter runs](/ja/models/runs/filter-runs) を参照してください。
  </Tab>

  <Tab title="W&B App">
    W\&B App で run の状態を表示するには、次の手順に従います。

    1. W\&B のプロジェクトにアクセスします。
    2. プロジェクトのサイドバーから **Workspace** または **Runs** タブを選択します。
    3. 表示したい run を検索するか、スクロールして探します。
    4. run を選択して、run の概要ページを開きます。
    5. **Overview** タブを選択します。

    **State** フィールドの横で、run の現在の状態を確認できます。
  </Tab>
</Tabs>
