> ## 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.

# Run 상태

> W&B run이 가질 수 있는 다양한 상태를 알아보세요.

[Run 상태](/ko/products/wandb/runs/run-states#run-states)는 W\&B run의 현재 상태를 나타냅니다. run의 [상태는 W\&B App에서 확인](/ko/products/wandb/runs/run-states#view-the-state-of-a-run)하거나 W\&B Python SDK를 사용해 프로그래밍 방식으로 확인할 수 있습니다.

<h2 id="run-states">
  run 상태
</h2>

다음 표는 run이 가질 수 있는 상태를 설명합니다.

| 상태 | 설명 |
| - | - |
| `Crashed` | run이 내부 프로세스에서 하트비트 전송을 중단했습니다. 머신에 크래시가 발생하면 이 상태가 될 수 있습니다. |
| `Failed` | run이 0이 아닌 종료 상태 코드로 종료되었습니다. |
| `Finished` | run이 종료되고 데이터가 모두 동기화되었거나, `wandb.Run.finish()`가 호출되었습니다. |
| `Killed` | run이 완료되기 전에 강제로 중단되었습니다. |
| `Running` | run이 아직 실행 중이며 최근에 하트비트를 전송했습니다. |
| `Pending` | run이 예약되었지만 아직 시작되지 않았습니다(스윕 및 Launch 작업에서 흔히 나타남). |

<h3 id="run-states-in-sweeps">
  스윕의 run 상태
</h3>

run이 [스윕](/ko/products/wandb/sweeps)에 속한 경우, run의 상태는 스윕의 상태와 별개로 동작합니다.

* **개별 run 상태**는 각 run의 실행 상태(Running, Finished, Failed 등)를 나타냅니다.
* **스윕 상태**는 새 run의 생성 여부를 제어하며, 기존 run의 실행 방식에는 관여하지 않습니다.
* 스윕을 일시 중지하거나 중지해도 이미 실행 중인 run에는 영향을 주지 않습니다.
* 스윕을 취소할 때만 실행 중인 run이 강제로 종료됩니다(상태가 `Killed`로 변경됨).

스윕 상태와 run 상태가 서로 어떻게 연관되는지 자세히 알아보려면 [스윕 및 run 상태 이해하기](/ko/products/wandb/sweeps/pause-resume-and-cancel-sweeps#understanding-sweep-and-run-statuses)를 참조하세요.

<h2 id="view-the-state-of-a-run">
  run의 상태 확인하기
</h2>

Python SDK를 사용해 프로그래밍 방식으로, 또는 W\&B App에서 대화형으로 run의 상태를 확인할 수 있습니다.

<Tabs>
  <Tab title="W&B Python SDK">
    run의 현재 상태에 액세스하려면 [`wandb.Api.Run`](/ko/products/wandb/ref/python/public-api/runs) 객체의 `state` 속성을 사용하세요.

    다음 코드 스니펫은 지정한 프로젝트에 있는 모든 run의 상태를 가져와 출력합니다. 이 코드 스니펫을 복사하여 Python 환경에 붙여 넣은 다음, 꺾쇠괄호(`< >`)로 묶인 값을 실제 값으로 바꾸세요.

    ```python theme={"system"}
    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을 필터링하는 방법은 [run 필터링](/ko/products/wandb/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** 탭을 선택하세요.

    **상태** 필드 옆에서 run의 현재 상태를 확인할 수 있습니다.
  </Tab>
</Tabs>
