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

> 메트릭을 시각화하고, 축을 사용자 지정하고, 플롯에서 여러 선을 비교하세요

# 선형 플롯 개요

`wandb.Run.log()`로 시간에 따라 로깅한 메트릭은 기본적으로 선형 플롯으로 표시됩니다. 선형 플롯은 여러 메트릭 표시, 맞춤형 축 계산 등을 지원합니다.

이 페이지에서는 [워크스페이스](/ko/products/wandb/track/workspaces)에서 선형 플롯을 생성, 설정, 관리하는 방법을 설명합니다.

<Frame>
  <img src="https://mintcdn.com/coreweave-dbfa0e8d/3Dv_sw2eg8feUJlx/products/wandb/_media/line_plot_example.png?fit=max&auto=format&n=3Dv_sw2eg8feUJlx&q=85&s=43705c977605e716d19d0313fc17e4b7" alt="선형 플롯 예시" width="1838" height="622" data-path="products/wandb/_media/line_plot_example.png" />
</Frame>

<Tip>
  [CoreWeave Kubernetes Service (CKS)](/products/cks) 클러스터에서 실행되는 [run](/ko/products/wandb/runs)의 경우, 인테그레이션을 활성화하면 [CoreWeave Mission Control](https://www.coreweave.com/mission-control)로 컴퓨팅 인프라를 모니터링할 수 있습니다. 오류가 발생하면 W\&B가 프로젝트 워크스페이스의 run 플롯에 인프라 정보를 표시합니다. 사전 요구 사항과 자세한 내용은 [CoreWeave 인프라 알림 시각화](/ko/products/wandb/runs/infrastructure-alerts)를 참조하세요.
</Tip>

<h2 id="add-a-line-plot">
  선형 플롯 추가
</h2>

다음 섹션에서는 단일 메트릭 또는 여러 메트릭에 대한 선형 플롯을 만드는 방법을 설명합니다.

<Tabs>
  <Tab title="단일 지표 선형 플롯">
    [자동 워크스페이스](/ko/products/wandb/app/features/panels#workspace-modes)에서는 W\&B가 로깅된 각 메트릭에 대해 단일 메트릭 선형 플롯을 자동으로 생성합니다. 자동 워크스페이스에서 삭제된 선형 플롯을 다시 추가하거나 수동 워크스페이스에 선형 플롯을 추가하려면 다음 단계를 따르세요.

    1. 워크스페이스로 이동하세요.
    2. 선형 플롯을 전역으로 추가하려면 패널 검색 필드 근처의 제어 모음에서 **Add panels**를 클릭하세요.

       대신 섹션에 직접 선형 플롯을 추가하려면 해당 섹션의 **액션 (<Icon icon="ellipsis" iconType="solid" />)** 메뉴를 클릭한 다음 **+ Add panels**를 클릭하세요.
    3. 기본 설정으로 단일 메트릭 플롯을 추가하려면 **빠른 패널 빌더**를 클릭하세요.
       1. **단일 키 패널** 탭에서 메트릭에 마우스를 올린 다음 **Add**를 클릭하세요. 추가하려는 패널마다 이 단계를 반복하세요.
       2. **Create \[NUMBER] panels**를 클릭하세요.
    4. 대신 맞춤형 선형 플롯을 추가하려면 **Line plot**을 클릭하세요.
       1. 각 탭에서 선형 플롯의 데이터, 그룹화, 표시 기본 설정을 설정하세요. 자세한 내용은 [선형 플롯 설정 편집](#edit-line-plot-settings)을 참조하세요.
       2. x축 또는 y축에 계산된 표현식을 추가하려면 **Expressions**를 클릭하세요. [JavaScript 정규 표현식](https://www.w3schools.com/js/js_regexp.asp)을 지원합니다.
    5. 차트 등 추가할 패널의 유형을 선택하세요. 패널의 설정 세부 정보가 기본값이 선택된 상태로 표시됩니다.
    6. 필요한 경우 패널과 표시 기본 설정을 사용자 지정하세요. 설정 옵션은 선택한 패널 유형에 따라 다릅니다. 각 패널 유형의 옵션에 대한 자세한 내용은 [선형 플롯](/ko/products/wandb/app/features/panels/line-plot) 또는 [막대 플롯](/ko/products/wandb/app/features/panels/bar-plot)을 참조하세요.
    7. **Apply**를 클릭하세요.
  </Tab>

  <Tab title="다중 지표 선형 플롯">
    [자동 워크스페이스](/ko/products/wandb/app/features/panels#workspace-modes)에서 W\&B는 로깅된 각 메트릭에 대해 단일 메트릭 선형 플롯을 자동으로 생성합니다.

    이 섹션에서는 JavaScript 정규 표현식으로 선택한 여러 메트릭을 표시하는 선형 플롯을 만드는 방법을 설명합니다. 다중 메트릭 선형 플롯을 사용하면 여러 패널을 살펴보는 대신 하나의 패널에서 관련 메트릭을 비교할 수 있습니다.

    1. 워크스페이스로 이동하세요.
    2. 선형 플롯을 전역적으로 추가하려면 패널 검색 필드 근처의 제어 막대에서 **Add panels**를 클릭하세요.

       대신 섹션에 직접 선형 플롯을 추가하려면 해당 섹션의 **액션 (<Icon icon="ellipsis" iconType="solid" />)** 메뉴를 클릭한 다음 **+ Add panels**를 클릭하세요.
    3. **빠른 패널 빌더**를 클릭한 다음 **다중 메트릭 패널** 탭을 클릭하세요.
    4. **Regex**에 [Google의 RE2](https://github.com/google/re2/wiki/Syntax) 형식의 표현식을 입력하세요. 입력하는 동안 UI가 업데이트되어 표현식과 일치하는 메트릭을 표시합니다. 기본적으로 플롯 이름에는 플롯에 사용된 정규 표현식이 표시됩니다. 플롯에는 향후 로깅될 메트릭을 포함하여 표현식과 일치하는 모든 메트릭의 선이 포함됩니다.
    5. 다중 메트릭 플롯을 생성할 때 중복된 단일 메트릭 패널을 제거하려면 **Clean up auto-generated panels**를 켜세요(선택 사항). 미리보기에서 정리될 패널을 확인할 수 있습니다. <Note>이 옵션을 켜면 W\&B는 표현식과 일치하는 메트릭이 새로 로깅되어도 단일 메트릭 플롯을 생성하지 않습니다. 대신 해당 메트릭은 이 다중 메트릭 플롯에만 표시됩니다.</Note>
    6. **Create \[NUMBER] panels**를 클릭하세요.

    <h3 id="multi-metric-regular-expressions">
      다중 메트릭 정규 표현식
    </h3>

    다중 메트릭 선형 플롯은 [Google의 RE2](https://github.com/google/re2/wiki/Syntax) 구문을 사용하여 메트릭 이름을 일치시킵니다. 다음 섹션에서는 일반적인 사용 사례를 설명하고, 캡처 그룹이 W\&B에서 생성하는 패널에 미치는 영향 등 정규 표현식의 작동 방식에 대한 자세한 정보를 제공합니다.

    <h4 id="common-use-cases">
      일반적인 사용 사례
    </h4>

    다음 예시는 다중 메트릭 패널을 활용하여 실험 결과를 분석하는 몇 가지 방법을 보여줍니다.

    **레이어 또는 모델 컴포넌트 간 메트릭 비교**
    각 레이어의 메트릭마다 별도의 패널을 만드는 대신 하나의 패널에서 함께 볼 수 있습니다. 예를 들어, 이 Python 예시 코드처럼 `layer_0_loss`, `layer_1_loss`, `layer_2_loss`와 같이 일관된 이름으로 메트릭을 로깅하면 정규 표현식 `layer_\d+_loss`를 사용하여 모든 레이어의 손실을 하나의 플롯에 표시할 수 있습니다.

    ```python theme={"system"}
    with wandb.init(project="multi-layer-model") as run:
        for step in range(100):
            run.log({
                "layer_0_loss": loss_0,
                "layer_1_loss": loss_1,
                "layer_2_loss": loss_2,
                "step": step
            })
    ```

    **접두사 또는 접미사로 관련 메트릭 그룹화**
    공통 명명 패턴을 가진 모든 메트릭을 일치시킵니다. 예시:

    * `train_.*`는 `train_loss`, `train_accuracy`, `train_f1_score`와 같은 모든 트레이닝 메트릭과 일치합니다.
    * `.*_accuracy`는 `train_accuracy`, `val_accuracy`, `test_accuracy`와 같이 서로 다른 데이터셋의 정확도 메트릭과 일치합니다.

    **특정 메트릭 변형 일치시키기**
    선택 연산을 사용하여 원하는 메트릭만 일치시키세요. 예를 들어, 비캡처 그룹 `(?:layer_0|layer_10)_loss`는 중간 레이어를 제외하고 첫 번째와 열 번째 레이어의 손실에만 일치합니다.

    <h4 id="capture-groups">
      캡처 그룹
    </h4>

    정규 표현식의 캡처 그룹에 따라 다중 메트릭 패널이 생성되는 방식이 달라집니다. 이 동작을 미리 알지 못하면 혼란스러울 수 있습니다.

    * **캡처 그룹은 여러 패널을 생성합니다**
      정규 표현식에 캡처 그룹을 이루는 괄호가 있으면, UI는 해당 그룹이 캡처한 고유한 값마다 별도의 패널을 생성합니다.

      예를 들어 표현식 `(layer_0|layer_10)_loss`에는 캡처 그룹이 포함되어 있으므로 다음과 같이 두 개의 패널이 따로 생성됩니다.

      1. `layer_0`과 일치하는 메트릭을 표시하는 패널
      2. `layer_10`과 일치하는 메트릭을 표시하는 패널

    * **비캡처 그룹은 메트릭을 한 패널에 모아 표시합니다**
      패널을 따로 만들지 않고 여러 대안 중 하나와 일치시키려면 `?:` 구문으로 비캡처 그룹을 사용하세요. 표현식 `(?:layer_0|layer_10)_loss`는 앞의 예시와 동일한 메트릭과 일치하지만, 이를 하나의 패널에 함께 표시합니다.

    차이점은 다음과 같습니다.

    * `(layer_0|layer_10)_loss` - 레이어별로 하나씩, 총 두 개의 패널을 생성합니다.
    * `(?:layer_0|layer_10)_loss` - 두 레이어를 함께 표시하는 패널 하나를 생성합니다.

    따라서 분석 목적에 가장 알맞은 방식을 유연하게 선택할 수 있습니다. 메트릭을 서로 다른 패널로 나누어 보려면 캡처 그룹을 사용하세요. 하나의 플롯에서 메트릭을 함께 비교하려면 비캡처 그룹을 사용하세요.
  </Tab>
</Tabs>

<h2 id="edit-line-plot-settings">
  선형 플롯 설정 편집
</h2>

다음 섹션에서는 개별 선형 플롯 패널, 섹션 내 모든 선형 플롯 패널 또는 워크스페이스 내 모든 선형 플롯 패널의 설정을 편집하는 방법을 설명합니다. 선형 플롯 설정에 대한 자세한 내용은 [선형 플롯 레퍼런스](/ko/products/wandb/app/features/panels/line-plot/reference)를 참조하세요.

<h3 id="individual-line-plot">
  개별 선형 플롯
</h3>

선형 플롯의 개별 설정은 섹션 또는 워크스페이스의 선형 플롯 설정을 재정의합니다. 선형 플롯을 사용자 지정하려면 다음 단계를 따르세요.

1. 워크스페이스로 이동하세요.
2. 패널 위에 마우스를 올린 다음 톱니바퀴 아이콘을 클릭하세요.
3. 표시되는 드로어에서 탭을 선택하여 설정을 편집하세요.
4. **Apply**를 클릭하세요.

선형 플롯 설정은 다음 탭으로 구성됩니다.

* **Data**: X축, Y축, 샘플링 방법, 평활화, 이상값, 차트 유형을 설정합니다.
* **Grouping**: 플롯에서 run을 그룹화하고 집계할지 여부와 방법을 설정합니다.
* **Chart**: 패널 및 축의 제목을 지정하고 범례의 표시 여부와 위치를 설정합니다.
* **범례**: 패널 범례의 모양과 내용을 사용자 지정합니다.
* **Expressions**: 축에 맞춤형 계산 표현식을 추가합니다. 곱셈과 같은 산술 연산을 포함한 Operator의 전체 목록과 표현식 예시는 [Expressions](/ko/products/wandb/app/features/panels/line-plot/reference#expressions)를 참조하세요.

각 설정에 대한 자세한 내용은 [선형 플롯 레퍼런스](/ko/products/wandb/app/features/panels/line-plot/reference)를 참조하세요.

<h3 id="all-line-plots-in-a-section">
  섹션의 모든 선형 플롯
</h3>

섹션 내 모든 선형 플롯의 기본 설정을 사용자 지정하여 워크스페이스 설정을 재정의하려면:

1. 워크스페이스로 이동하세요.
2. 섹션의 톱니바퀴 아이콘을 클릭하여 설정을 여세요.
3. 나타나는 드로어에서 **Data** 또는 **표시 기본 설정** 탭을 선택하여 섹션의 기본 설정을 설정하세요. 각 **Data** 설정에 대한 자세한 내용은 [선형 플롯 레퍼런스](/ko/products/wandb/app/features/panels/line-plot/reference)를 참조하세요. 각 표시 기본 설정에 대한 자세한 내용은 [Configure section layout](../#configure-section-layout)를 참조하세요.

<h3 id="all-line-plots-in-a-workspace">
  워크스페이스의 모든 선형 플롯
</h3>

워크스페이스의 모든 선형 플롯에 대한 기본 설정을 사용자 지정하려면 다음을 수행하세요.

1. 워크스페이스로 이동하세요.
2. **Settings** 레이블이 있는 톱니바퀴 모양의 워크스페이스 설정 아이콘을 클릭하세요.
3. **Line plots**를 클릭하세요.
4. 표시되는 드로어에서 **Data** 또는 **표시 기본 설정** 탭을 선택하여 워크스페이스의 기본 설정을 지정하세요.
   * 각 **Data** 설정에 대한 자세한 내용은 [선형 플롯 레퍼런스](/ko/products/wandb/app/features/panels/line-plot/reference)를 참조하세요.
   * 각 **표시 기본 설정** 섹션에 대한 자세한 내용은 [워크스페이스 표시 기본 설정](../#configure-workspace-layout)을 참조하세요. 워크스페이스 수준에서는 선형 플롯의 기본 **Zooming** 동작을 설정할 수 있습니다. 이 설정은 x축 키가 동일한 선형 플롯 간에 확대/축소를 동기화할지 여부를 결정하며, 기본적으로 비활성화되어 있습니다.

<h2 id="visualize-average-values-on-a-plot">
  플롯에 평균값 시각화하기
</h2>

여러 실험의 평균값을 플롯에서 확인하려면 table의 Grouping 기능을 사용할 수 있습니다. run table 위의 **Group**을 클릭하고 **All**을 선택하면 그래프에 평균값이 표시됩니다.

다음 이미지는 평균을 계산하기 전의 그래프로, run마다 하나의 선이 표시됩니다.

<Frame>
  <img src="https://mintcdn.com/coreweave-dbfa0e8d/3Dv_sw2eg8feUJlx/products/wandb/_media/demo_precision_lines.png?fit=max&auto=format&n=3Dv_sw2eg8feUJlx&q=85&s=39ec1186c5d360963b250112a1e8cb90" alt="개별 정밀도 선" width="849" height="440" data-path="products/wandb/_media/demo_precision_lines.png" />
</Frame>

다음 이미지는 그룹화된 선을 사용하여 run 전체의 평균값을 나타내는 그래프입니다.

<Frame>
  <img src="https://mintcdn.com/coreweave-dbfa0e8d/3Dv_sw2eg8feUJlx/products/wandb/_media/demo_average_precision_lines.png?fit=max&auto=format&n=3Dv_sw2eg8feUJlx&q=85&s=5ca37e1a93a51e5e431ed2e5176aadf7" alt="평균 정밀도 선" width="852" height="441" data-path="products/wandb/_media/demo_average_precision_lines.png" />
</Frame>

<h2 id="visualize-nan-value-on-a-plot">
  플롯에서 NaN 값 시각화하기
</h2>

`NaN`을 반환하는 loss처럼 때때로 정의되지 않는 메트릭도 로깅하여 추적할 수 있으며, W\&B는 이를 선형 플롯에 표시합니다. `wandb.Run.log()`를 사용하면 PyTorch 텐서를 포함한 `NaN` 값도 선형 플롯에 그릴 수 있습니다. 예시:

```python theme={"system"}
with wandb.init() as run:
    # NaN 값을 로깅합니다
    run.log({"test": float("nan")})
```

<Frame>
  <img src="https://mintcdn.com/coreweave-dbfa0e8d/3Dv_sw2eg8feUJlx/products/wandb/_media/visualize_nan.png?fit=max&auto=format&n=3Dv_sw2eg8feUJlx&q=85&s=dbc9bf070f62111faec60a15173ca709" alt="NaN 값 처리" width="936" height="688" data-path="products/wandb/_media/visualize_nan.png" />
</Frame>

<h2 id="compare-multiple-metrics-on-one-chart">
  하나의 차트에서 여러 메트릭 비교하기
</h2>

하나 이상의 run에서 여러 메트릭을 나란히 비교하려면 워크스페이스에 **Run comparer** 패널을 추가하세요.

<Frame>
  <img src="https://mintcdn.com/coreweave-dbfa0e8d/3Dv_sw2eg8feUJlx/products/wandb/_media/visualization_add.gif?s=91d9a5add5d026b0c51d93e15e97f8e3" alt="시각화 패널 추가하기" width="3866" height="2574" data-path="products/wandb/_media/visualization_add.gif" />
</Frame>

1. 워크스페이스로 이동하세요.
2. 페이지 오른쪽 상단에 있는 **Add panels** 버튼을 선택하세요.
3. 표시되는 드로어에서 **Evaluation** 드롭다운을 펼치세요.
4. **Run comparer**를 선택하세요.

<h2 id="change-the-colors-of-the-lines">
  선 색상 변경
</h2>

run의 기본 색상이 비교에 도움이 되지 않는 경우, W\&B에서는 run table 또는 차트의 범례 설정에서 색상을 변경할 수 있습니다.

<Tabs>
  <Tab title="run table에서">
    각 run에는 초기화 시 기본적으로 임의의 색상이 지정됩니다.

    <Frame>
      <img src="https://mintcdn.com/coreweave-dbfa0e8d/3Dv_sw2eg8feUJlx/products/wandb/_media/line_plots_run_table_random_colors.png?fit=max&auto=format&n=3Dv_sw2eg8feUJlx&q=85&s=55a20460bcac59277069fee8eacec1c7" alt="run에 지정된 임의의 색상" width="272" height="174" data-path="products/wandb/_media/line_plots_run_table_random_colors.png" />
    </Frame>

    색상을 클릭하면 색상 팔레트가 나타나며, 여기에서 원하는 색상을 선택할 수 있습니다.

    <Frame>
      <img src="https://mintcdn.com/coreweave-dbfa0e8d/3Dv_sw2eg8feUJlx/products/wandb/_media/line_plots_run_table_color_palette.png?fit=max&auto=format&n=3Dv_sw2eg8feUJlx&q=85&s=cb1dfd1308d76ddb9423ebf20ce20e60" alt="색상 팔레트" width="261" height="393" data-path="products/wandb/_media/line_plots_run_table_color_palette.png" />
    </Frame>
  </Tab>

  <Tab title="차트 범례 설정에서">
    1. 워크스페이스로 이동하세요.
    2. 설정을 수정하려는 패널 위에 마우스를 올리세요.
    3. 나타나는 연필 아이콘을 선택하세요.
    4. **범례** 탭을 선택하세요.

    <Frame>
      <img src="https://mintcdn.com/coreweave-dbfa0e8d/3Dv_sw2eg8feUJlx/products/wandb/_media/plot_style_line_plot_legend.png?fit=max&auto=format&n=3Dv_sw2eg8feUJlx&q=85&s=c5b5a7916db550f6141d650da3d2dc85" alt="선형 플롯 범례 설정" width="2682" height="1166" data-path="products/wandb/_media/plot_style_line_plot_legend.png" />
    </Frame>
  </Tab>
</Tabs>

<h2 id="visualize-on-different-x-axes">
  다른 x축으로 시각화하기
</h2>

기본적으로 선형 플롯은 트레이닝 step을 x축으로 사용하지만, x축을 바꿔 데이터를 다른 관점에서 살펴볼 수도 있습니다. 실험에 걸린 절대 시간이나 실험이 실행된 날짜를 확인하려면 x축을 전환하세요. 다음 예시는 x축을 step에서 상대 시간으로, 다시 벽시계 시간(wall time)으로 전환하는 과정을 보여줍니다.

<Frame>
  <img src="https://mintcdn.com/coreweave-dbfa0e8d/3Dv_sw2eg8feUJlx/products/wandb/_media/howto_use_relative_time_or_wall_time.gif?s=599e0e411b48993dfeb9040dd979f5c1" alt="X축 시간 옵션" width="3348" height="1880" data-path="products/wandb/_media/howto_use_relative_time_or_wall_time.gif" />
</Frame>

맞춤형 x축을 사용하려면 y축 값을 로깅하는 `wandb.Run.log()` 호출에서 해당 메트릭도 함께 로깅하세요. 예를 들면 다음과 같습니다.

```python theme={"system"}
with wandb.init() as run:
    for i in range(100):
        run.log({"accuracy": acc, "custom_x": i * 10})
```

자세한 내용은 [로깅 축 사용자 지정](/ko/products/wandb/track/log/customize-logging-axes#customize-log-axes)을 참조하세요.

<h2 id="zoom">
  확대/축소
</h2>

선형 플롯의 특정 영역을 자세히 살펴보려면 두 축을 동시에 확대할 수 있습니다. 클릭하고 드래그하여 사각형을 그리면 세로와 가로 방향으로 동시에 확대됩니다. 이렇게 하면 x축과 y축의 확대 수준이 변경됩니다.

<Frame>
  <img src="https://mintcdn.com/coreweave-dbfa0e8d/3Dv_sw2eg8feUJlx/products/wandb/_media/line_plots_zoom.gif?s=b304205e205996ba87ee0c7559858a1e" alt="플롯 확대/축소 기능" width="1056" height="473" data-path="products/wandb/_media/line_plots_zoom.gif" />
</Frame>

<h2 id="hide-chart-legend">
  차트 범례 숨기기
</h2>

차트 범례가 플롯에 사용하려는 공간을 차지하는 경우, 이를 끌 수 있습니다. 이 표시/숨기기를 사용하여 선형 플롯의 범례를 끄세요:

<Frame>
  <img src="https://mintcdn.com/coreweave-dbfa0e8d/3Dv_sw2eg8feUJlx/products/wandb/_media/demo_hide_legend.gif?s=be5296cece36d9eb11da486e00ca0fdc" alt="Hide legend toggle" width="2720" height="1246" data-path="products/wandb/_media/demo_hide_legend.gif" />
</Frame>

<h2 id="create-a-run-metrics-notification">
  run 메트릭 알림 만들기
</h2>

[자동화](/ko/products/wandb/automations)를 사용하여 run 메트릭이 지정한 조건을 충족하면 팀이 알림을 받도록 하세요. 자동화는 Slack 채널에 메시지를 게시하거나 웹훅을 실행할 수 있습니다.

선형 플롯에서 해당 플롯에 표시되는 메트릭에 대한 [run 메트릭 알림](/ko/products/wandb/automations/automation-events#run-events)을 만들 수 있습니다:

1. 워크스페이스로 이동하세요.
2. 패널에 마우스를 올린 다음 벨 아이콘을 클릭하세요.
3. 기본 또는 고급 설정 컨트롤을 사용하여 자동화를 설정하세요. 예를 들어, run 필터를 적용하여 자동화의 범위를 제한하거나 절대 임계값을 설정하세요.

[자동화](/ko/products/wandb/automations)에 대해 자세히 알아보세요.


## Related topics

- [선형 플롯 레퍼런스](/ko/products/wandb/app/features/panels/line-plot/reference.md)