선 그래프 개요

메트릭을 시각화하고 축을 사용자 지정하며 플롯에서 여러 선을 비교합니다

wandb.Run.log()으로 기록한 메트릭은 시간 경과에 따라 기본적으로 선 그래프로 표시됩니다. 선 그래프는 여러 메트릭을 동시에 그리거나 사용자 정의 축을 계산하는 등 다양한 기능을 지원합니다.

이 페이지에서는 워크스페이스에서 선 그래프를 생성, 구성 및 관리하는 방법을 설명합니다.

CoreWeave 인프라에서 실행되는 실행의 경우, CoreWeave Mission Control이 컴퓨팅 인프라를 모니터링합니다. 오류가 발생하면 W&B는 인프라 정보를 프로젝트 워크스페이스의 해당 실행 플롯에 자동으로 추가합니다. 자세한 내용은 CoreWeave 인프라 알림 시각화를 참고하세요.

​

선 그래프 추가

이 섹션에서는 단일 메트릭 또는 여러 메트릭에 대한 선 그래프를 생성하는 방법을 설명합니다.

단일 메트릭 선 그래프

자동 워크스페이스에서는 기록된 각 메트릭마다 단일 메트릭 선 그래프가 자동으로 생성됩니다. 자동 워크스페이스에서 삭제한 선 그래프를 다시 추가하거나, 수동 워크스페이스에 선 그래프를 추가하려면 다음 단계를 따르세요.

1. 워크스페이스로 이동합니다.

2. 워크스페이스 전체에 선 그래프를 추가하려면 패널 검색 필드 근처의 컨트롤 바에서 Add panels를 클릭합니다.

   대신 특정 섹션에 직접 선 그래프를 추가하려면 섹션의 작업 ... 메뉴를 클릭한 다음 + Add panels를 클릭합니다.

3. 기본 설정으로 단일 메트릭 플롯을 추가하려면 Quick panel builder를 클릭합니다.

   1. Single-key panels 탭에서 메트릭 위에 마우스를 올린 다음 Add를 클릭합니다. 추가하려는 각 패널에 대해 이 단계를 반복합니다.
   2. Create <number> panels를 클릭합니다.

4. 대신 사용자 지정 선 그래프를 추가하려면 Line plot을 클릭합니다.

   1. 해당 탭을 사용하여 선 그래프의 데이터, 그룹화, 표시 설정을 구성합니다. 자세한 내용은 선 그래프 설정 편집을 참조하세요.
   2. x 또는 y 축에 계산식 표현을 추가하려면 Expressions를 클릭합니다. JavaScript 정규 표현식을 지원합니다. 추가할 패널 유형(예: 차트)을 선택하면 선택된 기본값과 함께 패널의 구성 세부 정보가 표시됩니다.

5. 필요에 따라 패널과 그 표시 설정을 사용자 지정합니다. 구성 옵션은 선택한 패널 유형에 따라 달라집니다. 각 패널 유형의 옵션에 대해 자세히 알아보려면 선 그래프 또는 막대 그래프와 같은 아래의 관련 섹션을 참조하세요.

6. Apply를 클릭합니다.

다중 지표 선 그래프

이 기능은 프리뷰 단계이며, 초대받은 사용자만 사용할 수 있습니다. 사용을 요청하려면 support 또는 담당 AISE에게 문의하세요.

자동 워크스페이스에서는 기록된 각 메트릭마다 단일 메트릭 선 그래프가 자동으로 생성됩니다. 이 섹션에서는 JavaScript 정규식을 사용해 여러 메트릭을 함께 표시하는 단일 선 그래프를 생성하는 방법을 설명합니다. 선택적으로 여러 개의 단일 메트릭 그래프를 하나의 멀티 메트릭 그래프로 통합할 수 있습니다. 이렇게 하면 많은 메트릭이 기록된 워크스페이스의 성능을 개선하고, 실행 결과를 더 효율적으로 분석하는 데 도움이 됩니다.

1. 워크스페이스로 이동합니다.

2. 워크스페이스 전체에 적용되는 선 그래프(line plot)를 추가하려면, 패널 검색 필드 근처의 컨트롤 바에서 Add panels를 클릭합니다.

   대신 특정 섹션에만 선 그래프를 직접 추가하려면, 섹션의 동작 메뉴 ...를 클릭한 다음 + Add panels를 클릭합니다.

3. Quick panel builder를 클릭한 다음 Multi-metric panels 탭을 클릭합니다.

4. Regex에 JavaScript regular expression 형식의 표현식을 입력합니다. 입력하는 동안 UI가 업데이트되면서 어떤 메트릭이 해당 표현식과 일치하는지 표시합니다. 기본적으로 그래프 이름에는 그래프에서 사용한 정규식이 표시됩니다. 이 그래프에는 표현식과 일치하는 모든 메트릭의 선이 포함되며, 이후에 기록되는 메트릭도 포함됩니다.

5. 멀티 메트릭 그래프를 생성할 때 중복되는 단일 메트릭 패널을 선택적으로 제거하려면 Clean up auto-generated panels 토글을 켭니다. 미리 보기에 정리 대상 패널이 표시됩니다.

6. Create <number> panels를 클릭합니다.

​

멀티 메트릭 정규식 자세히 알아보기

멀티 메트릭 선 그래프는 메트릭 이름을 매칭하기 위해 JavaScript 정규식을 사용합니다. 이 섹션에서는 몇 가지 일반적인 사용 사례를 보여 주고, 캡처 그룹이 생성되는 패널에 어떤 영향을 미치는지 등 정규식이 동작하는 방식에 대한 자세한 내용을 설명합니다.

​

일반적인 사용 사례

이 섹션에서는 멀티 메트릭 패널을 사용해 실험 결과를 분석하는 몇 가지 방법을 보여 줍니다.

레이어 또는 모델 구성 요소 간 메트릭 비교 각 레이어의 메트릭마다 별도의 패널을 만드는 대신, 하나의 패널에서 함께 볼 수 있습니다. 예를 들어, 다음 Python 예제 코드처럼 layer_0_loss, layer_1_loss, layer_2_loss와 같이 일관된 이름으로 메트릭을 기록하는 경우, 정규식 layer_\d+_loss를 사용하여 모든 레이어의 loss를 하나의 그래프에 표시할 수 있습니다.

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와 같이 서로 다른 데이터셋의 accuracy 메트릭과 매칭됩니다.

특정 메트릭 변형만 매칭하기 원하는 메트릭만 매칭하도록 alternation을 사용합니다. 예를 들어, non-capture 그룹 (?:layer_0|layer_10)_loss는 중간 레이어를 제외하고 첫 번째와 열 번째 레이어의 loss만 매칭합니다.

​

캡처 그룹 이해하기

정규식의 캡처 그룹은 다중 메트릭 패널이 어떻게 생성되는지를 제어합니다. 이 동작은 알고 있지 않으면 헷갈릴 수 있습니다.

• 캡처 그룹은 여러 개의 패널을 만듭니다 정규식에 캡처 그룹을 이루는 괄호가 포함되어 있으면, 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 - 두 레이어를 함께 보여주는 하나의 패널을 생성합니다.

이를 통해 분석 목적에 가장 적합한 방식을 유연하게 선택할 수 있습니다. 메트릭을 개별 패널로 분리하고 싶다면 캡처 그룹을 사용하세요. 하나의 플롯에서 메트릭을 함께 비교하고 싶다면 비캡처 그룹을 사용하세요.

​

선 그래프 설정 수정

이 섹션에서는 개별 선 그래프 패널, 섹션 내 모든 선 그래프 패널, 또는 워크스페이스의 모든 선 그래프 패널에 대한 설정을 수정하는 방법을 설명합니다. 선 그래프 설정에 대한 자세한 내용은 Line plot reference를 참고하세요.

​

개별 선 그래프

개별 선 그래프 설정은 섹션이나 워크스페이스 수준의 선 그래프 설정보다 우선 적용됩니다. 선 그래프를 사용자 지정하려면:

1. 워크스페이스로 이동합니다.
2. 패널 위에 마우스를 올린 다음 톱니바퀴 아이콘을 클릭합니다.
3. 나타나는 드로어에서 설정을 편집할 탭을 선택합니다.
4. Apply를 클릭합니다.

선 그래프 설정은 다음과 같은 탭으로 구성됩니다:

• Data: x축, y축, 샘플링 방법, 스무딩, 이상치, 차트 유형을 설정합니다.
• Grouping: 플롯에서 실행을 어떻게 그룹화하고 집계할지 설정합니다.
• Chart: 패널 및 축 제목을 지정하고, 범례의 표시 여부와 위치를 설정합니다.
• Legend: 패널 범례의 모양과 내용을 사용자 지정합니다.
• Expressions: 축에 사용할 사용자 정의 계산식을 추가합니다.

각 설정에 대한 자세한 내용은 Line plot reference를 참조하세요.

​

섹션의 모든 선 그래프

섹션 내 모든 선 그래프의 기본 설정을 워크스페이스 수준의 선 그래프 설정 대신 별도로 지정하려면:

1. 워크스페이스로 이동합니다.
2. 섹션의 톱니바퀴 아이콘을 클릭하여 설정을 엽니다.
3. 표시되는 드로어에서 Data 또는 Display preferences 탭을 선택해 섹션의 기본 설정을 구성합니다. 각 Data 설정에 대한 자세한 내용은 Line plot reference를 참조하세요. 각 표시 기본 설정에 대한 자세한 내용은 Configure section layout을 참조하세요.

​

워크스페이스의 모든 선 그래프

워크스페이스의 모든 선 그래프에 대한 기본 설정을 변경하려면 다음을 수행합니다:

1. 워크스페이스로 이동합니다.
2. 기어 모양 아이콘과 Settings 레이블이 있는 워크스페이스 설정 아이콘을 클릭합니다.
3. Line plots를 클릭합니다.
4. 나타나는 드로어에서 Data 또는 Display preferences 탭을 선택하여 워크스페이스의 기본 설정을 구성합니다.
   • 각 Data 설정에 대한 자세한 내용은 Line plot reference를 참조하세요.
   • 각 Display preferences 섹션에 대한 자세한 내용은 Workspace display preferences를 참조하세요. 워크스페이스 수준에서 선 그래프의 기본 Zooming 동작을 설정할 수 있습니다. 이 설정은 동일한 x축 키를 사용하는 선 그래프 간에 줌을 동기화할지 여부를 제어합니다. 기본적으로 비활성화되어 있습니다.

​

플롯에서 평균값 시각화하기

여러 개의 서로 다른 실험이 있고 플롯에서 이들의 값 평균을 보고 싶다면, 테이블의 그룹화(Grouping) 기능을 사용할 수 있습니다. 실행 테이블 상단에서 “Group”을 클릭하고 “All”을 선택하여 그래프에 평균값을 표시하세요.

다음은 평균을 내기 전 그래프의 모습입니다:

다음 이미지는 그룹화된 선을 사용하여 여러 실행에 대한 평균값을 나타내는 그래프입니다.

​

플롯에서 NaN 값 시각화

wandb.Run.log()을 사용하여 선 그래프에 PyTorch 텐서를 포함한 NaN 값도 그릴 수 있습니다. 예를 들어:

with wandb.init() as run:
    # NaN 값 기록
    run.log({"test": float("nan")})

​

하나의 차트에서 여러 메트릭 비교하기

1. 워크스페이스로 이동합니다.
2. 페이지 오른쪽 상단에서 Add panels 버튼을 선택합니다.
3. 왼쪽에 나타나는 패널에서 Evaluation 드롭다운을 확장합니다.
4. Run comparer를 선택합니다.

​

선 색상 변경하기

기본 실행 색상이 비교에 적합하지 않을 수 있습니다. 이를 개선하기 위해 wandb는 색상을 수동으로 변경할 수 있는 두 가지 방법을 제공합니다.

실행 테이블에서

각 실행은 생성될 때 기본적으로 무작위 색상이 지정됩니다.

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

차트 범례 설정에서

1. 워크스페이스로 이동합니다.
2. 설정을 편집할 패널 위에 마우스를 올립니다.
3. 나타나는 연필 아이콘을 선택합니다.
4. Legend 탭을 선택합니다.

​

서로 다른 x축으로 시각화하기

실험에 걸린 절대 시간을 보거나, 실험이 어느 날 실행되었는지 확인하려면 x축을 변경하면 됩니다. 아래는 단계(steps)에서 상대 시간으로, 그리고 다시 wall time으로 전환하는 예시입니다.

사용자 지정 x축을 사용하려면, y축을 로깅하는 것과 같은 wandb.Run.log() 호출에서 해당 지표를 함께 로깅하세요. 예를 들어:

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

자세한 내용은 로그 축 사용자 지정을 참조하세요.

​

확대

차트 위에서 직사각형 영역을 마우스로 드래그하여 세로 및 가로 방향을 동시에 확대합니다. 이렇게 하면 x축과 y축 범위가 함께 조정됩니다.

​

차트 범례 숨기기

이 간단한 토글로 선 그래프의 범례를 끌 수 있습니다:

​

실행 지표 알림 생성

Automations를 사용하여 실행 지표가 지정한 조건을 만족할 때 팀에 알림을 보낼 수 있습니다. Automation은 Slack 채널에 메시지를 게시하거나 웹훅을 호출할 수 있습니다.

선 그래프에서 해당 그래프에 표시된 지표에 대해 빠르게 실행 지표 알림을 생성할 수 있습니다:

1. 워크스페이스로 이동합니다.
2. 패널 위에 마우스를 올린 다음 종(bell) 아이콘을 클릭합니다.
3. 기본 또는 고급 구성 옵션을 사용하여 Automation을 설정합니다. 예를 들어, 실행 필터를 적용해 Automation의 범위를 제한하거나 절대 임계값을 설정할 수 있습니다.

Automations에 대해 더 알아보세요.