← 학습 카테고리

Learn

Airflow

151개 모듈 · 현재 140번째

Airflow 모듈 140/151 airflow-learn-140

Grid View / Graph View와 Dag 하위 탭(Runs/Tasks/Events/Code/Details)

Apache Airflow Official Documentation (in-repo snapshot) — Apache Software Foundation ui.rst - "Grid View" ~ "Details Tab" 섹션 (약 129-259행)

이 모듈을 다 읽으면

  • Grid View와 Graph View가 각각 어떤 축(실행 이력 vs 구조)에 초점을 맞추는지 구분해 설명할 수 있다
  • Grid View에서 태스크 셀을 클릭했을 때 할 수 있는 조작(로그 확인, 성공/실패/clear 마킹)을 설명할 수 있다
  • Dag Details Page의 다섯 개 하위 탭(Runs/Tasks/Events/Code/Details)이 각각 어떤 정보를 담는지 설명할 수 있다

Grid View는 행=태스크, 열=Dag Run으로 배치된 상태 매트릭스로 최근 실행들을 한눈에 비교하며 태스크 셀을 클릭해 로그를 보거나 상태를 수동으로 바꿀 수 있다. Graph View는 태스크 간 의존성 구조 자체에 초점을 맞춰 특정 Dag Run을 선택해 그 시점의 태스크 상태를 구조 위에 겹쳐 볼 수 있다. Runs/Tasks/Events/Code/Details 다섯 탭은 각각 실행 이력 테이블, 태스크 메타데이터, 구조화된 이벤트, 소스 코드, 확장 설정 정보를 제공한다.

Grid View - Dag Run과 태스크 상태의 매트릭스

Grid View는 Dag Run과 태스크 상태를 조사하는 1차 인터페이스다. 워크플로를 시간에 걸쳐 디버깅·재시도·모니터링할 수 있는 상호작용 방식을 제공한다.

Grid View의 용도: **최근 Dag Run들의 상태**를 한눈에 파악; 색상과 툴팁으로 **실패하거나 재시도된 태스크**를 식별; 태스크 셀을 클릭해 로그를 보거나 태스크 인스턴스를 성공/실패/clear로 표시하는 **액션 수행**; 이름이나 부분 ID로 **태스크 필터링**; 그리드 위 드롭다운으로 "최근 25개 실행" 같은 **실행 범위 선택**.

각 행은 태스크 하나를, 각 열은 Dag Run 하나를 나타낸다. 태스크 인스턴스 위에 마우스를 올리면 세부 정보를 볼 수 있고, 클릭하면 로그와 메타데이터로 드릴다운할 수 있다.

핵심 포인트

  • Grid View는 행=태스크, 열=Dag Run인 상태 매트릭스로 최근 실행들을 비교하는 1차 인터페이스다
  • 태스크 셀 클릭으로 로그 확인 또는 성공/실패/clear로 수동 마킹이 가능하다
  • 태스크 이름/부분 ID로 필터링하고, 실행 범위(예: 최근 25개)를 드롭다운으로 선택할 수 있다

Graph View - Dag의 논리적 구조

Graph View는 Dag의 논리적 구조 - 태스크들이 어떻게 연결되어 있고, 어떤 순서로 실행되며, 브랜칭이나 재시도가 어떻게 설정되어 있는지 - 를 보여준다.

이 뷰가 도움이 되는 경우: 트리거 규칙으로 인해 **왜 태스크가 실행되지 않았는지 디버깅**(예: skip됨); 복잡한 파이프라인 전반의 **태스크 의존성 이해**; 성공/실패/upstream_failed 등 **실행별 태스크 상태 검사**.

각 노드는 태스크 하나를 나타낸다. 엣지는 태스크 간 의존성을 보여준다. 어떤 태스크든 클릭하면 그 메타데이터와 최근 실행 이력을 볼 수 있다. 상단 드롭다운으로 Dag Run 간 전환하며 실행마다 태스크 상태가 어떻게 바뀌었는지 볼 수 있다.

핵심 포인트

  • Graph View는 태스크 연결·순서·브랜칭/재시도 설정 등 Dag의 논리적 구조를 보여준다
  • 트리거 규칙으로 인한 태스크 skip 원인 디버깅, 의존성 이해, 실행별 태스크 상태 검사에 유용하다
  • 상단 드롭다운으로 Dag Run을 전환해 실행마다 달라지는 태스크 상태를 구조 위에서 확인할 수 있다

Dag 하위 탭 - Runs, Tasks, Events, Code, Details

Dag Details 페이지는 Grid/Graph 같은 인터랙티브 뷰 외에도 더 깊은 통찰과 메타데이터를 제공하는 여러 탭을 포함한다.

**Runs 탭**은 모든 Dag Run을 상태, 실행 시간, 실행 타입, Dag 버전과 함께 정렬 가능한 테이블로 보여준다.

**Tasks 탭**은 Dag 내 각 태스크의 메타데이터 - 오퍼레이터 타입, 트리거 규칙, 가장 최근 실행 상태, 실행 이력 - 를 보여준다.

**Events 탭**은 Dag 트리거, 버전 패치 등 Dag와 관련된 구조화된 이벤트를 노출한다. Dag 버저닝과 변경 사항 트러블슈팅에 특히 유용하다.

**Code 탭**은 Dag 정의의 현재 버전(마지막 파싱 시각 포함)을 보여준다. 사용자는 특정 Dag 버전의 코드를 볼 수도 있다.

**Details 탭**은 스케줄, 파일 위치, 동시성(concurrency) 제한, 버전 식별자를 포함한 Dag의 설정 세부사항과 메타데이터를 제공한다.

핵심 포인트

  • Runs 탭: 상태/실행 시간/실행 타입/Dag 버전을 담은 정렬 가능한 테이블
  • Tasks 탭: 오퍼레이터 타입/트리거 규칙/최근 상태/실행 이력 등 태스크별 메타데이터
  • Events 탭: Dag 트리거·버전 패치 등 구조화된 이벤트, 버저닝/트러블슈팅에 유용
  • Code 탭: 현재 Dag 정의(마지막 파싱 시각 포함), 특정 버전의 코드도 조회 가능
  • Details 탭: 스케줄/파일 위치/동시성 제한/버전 식별자 등 설정 세부사항