Dag Run View/트리거 창과 Task Instance View의 탭 구성
Apache Airflow Official Documentation (in-repo snapshot) — Apache Software Foundation ui.rst - "Dag Run View" ~ "Task Instance Tabs" 섹션 (약 260-462행)
이 모듈을 다 읽으면
- Dag Run View의 각 하위 탭(Task Instances/Events/Code/Details/Graph View)이 개별 실행에 대해 어떤 정보를 담는지 설명할 수 있다
- Single Run과 Backfill 트리거 창의 차이를 설명할 수 있다
- Task Instance View의 탭 중 Logs가 기본 탭이자 첫 확인 지점인 이유와, XCom/Code 탭이 각각 무엇을 보여주는지 설명할 수 있다
Dag Run View는 Runs 탭에서 특정 실행 행을 선택하면 열리며, 그 실행에 국한된 태스크 인스턴스 상태·이벤트·당시 파싱된 코드·상세 메타데이터·그래프를 보여준다. Trigger Window는 즉시 실행(Single Run)과 과거 날짜 대량 실행(Backfill)을 구분해 제공한다. 개별 태스크를 클릭하면 열리는 Task Instance View는 실패 시 가장 먼저 확인해야 할 Logs 탭을 기본으로, Rendered Templates/XCom/Events/Code/Details 탭으로 그 실행 하나에 대한 세부 정보를 제공한다.
Dag Run View와 하위 탭
각 Dag Run은 Dag의 **Runs** 탭에서 특정 행을 선택하면 접근할 수 있는 자신만의 뷰를 가진다. Dag Run View는 선택한 실행에 대한 메타데이터와 태스크 레벨 세부사항, 렌더링된 코드 등을 보여준다.
주요 요소: logical date, 실행 타입, 지속 시간, Dag 버전, 파싱 시각을 포함한 **Dag Run 메타데이터**; 실행을 clear하거나 마킹하거나 노트를 추가하는 **액션 버튼**; 최근 Dag Run 전반의 태스크 지속 시간과 상태를 보여주는 지속적인 **Grid View 사이드바**(반복되는 이슈나 성능 추세를 한눈에 파악하는 데 도움).
**Task Instances 탭**은 Dag Run 내 각 태스크 인스턴스의 상태와 메타데이터를 보여준다. 컬럼: Task ID, State, Start/End Dates, Try Number, Operator Type, Duration, Dag Version. 각 행에는 태스크 지속 시간을 시각적으로 나타내는 미니 Gantt 스타일 타임라인도 포함된다.
**Events 탭**은 (있다면) 이 Dag Run의 실행에 기여한 시스템 레벨 또는 asset 트리거 이벤트를 나열한다.
**Code 탭**은 이 실행이 파싱되었던 시점의 Dag 소스 코드를 보여준다. 버전 드리프트를 디버깅하거나, 서로 다른 코드로 실행된 Dag Run 간 동작을 비교하는 데 유용하다.
**Details 탭**은 확장 메타데이터를 제공한다: Run ID와 Trigger Type; Queued At, Start/End Time, Duration; Data Interval 경계; Trigger Source와 Run Config; Dag Version ID와 Bundle Name.
**Graph View 탭**은 Dag의 태스크 의존성 구조에 이 특정 실행의 각 태스크 상태를 오버레이해 보여준다. 태스크 실패 경로나 다운스트림 블로커를 시각적으로 디버깅하는 데 유용하다. 각 노드는 태스크 지속 시간을 나타내는 시각적 인디케이터도 포함한다.
핵심 포인트
- Dag Run View는 logical date/실행 타입/지속 시간/Dag 버전/파싱 시각 메타데이터와, clear/마킹/노트 추가 액션, 지속적인 Grid View 사이드바를 제공한다
- Task Instances 탭은 컬럼(Task ID/State/Start-End/Try Number/Operator/Duration/Dag Version)과 미니 Gantt 타임라인을 태스크별로 보여준다
- Code 탭은 '이 실행이 파싱된 시점'의 소스를 보여줘 버전 드리프트 디버깅에 쓰인다
- Details 탭은 Run ID/Trigger Type/Queued-Start-End Time/Data Interval/Trigger Source/Run Config/Dag Version ID/Bundle Name을 담는다
- Graph View 탭은 Dag 구조 위에 이 실행의 태스크 상태와 지속 시간 인디케이터를 오버레이한다
Dag Trigger Window - Single Run과 Backfill
**Single Run** 창은 Dag Run을 트리거할 수 있게 해준다.
**Backfill** 창은 과거 날짜에 대한 Dag Run을 트리거할 수 있게 해준다.
핵심 포인트
- Single Run 창은 (보통 현재 시점 기준) 단일 Dag Run을 즉시 트리거하는 용도다
- Backfill 창은 과거 날짜들에 대한 Dag Run을 트리거하는 용도다
Task Instance View와 하위 탭
Dag Run View에서 특정 태스크를 클릭하면 **Task Instance View**로 이동한다. 이는 그 개별 태스크 실행에 대한 상세 로그와 메타데이터를 보여준다.
각 태스크 인스턴스는 로그, 렌더링된 템플릿, XCom, 실행 메타데이터에 접근할 수 있는 탭 뷰를 가진다.
**Logs** 탭(기본 탭)은 시스템 출력, 오류 메시지, 트레이스백 정보를 포함한 태스크 로그를 보여준다. 태스크가 실패했을 때 가장 먼저 확인해야 할 곳이다.
**Rendered Templates** 탭은 태스크의 템플릿 필드가 렌더링된 버전을 보여준다. context 변수를 디버깅하거나 동적 콘텐츠를 검증하는 데 유용하다.
**XCom** 탭은 ``XCom.push()``를 통해 push되었거나 TaskFlow 사용 시 Python 함수에서 반환된 값을 보여준다.
**Events** 탭은 (있다면) 이 특정 태스크 인스턴스 실행과 관련된 이벤트를 보여준다.
**Code** 탭은 실행 시점에 파싱된 Dag 소스 코드를 보여준다. 태스크가 어떤 버전의 Dag로 실행되었는지 검증하는 데 도움이 된다.
**Details** 탭은 태스크 인스턴스의 런타임 메타데이터를 보여준다: Task ID와 State; Dag Run ID, Dag Version, Bundle Name; 사용된 Operator와 런타임 지속 시간; Pool과 slot 사용량; Executor와 그 설정.
핵심 포인트
- Task Instance View는 Dag Run View에서 특정 태스크를 클릭해 진입하며 그 실행 하나에 국한된 정보를 보여준다
- Logs 탭이 기본 탭이며 태스크 실패 시 가장 먼저 확인해야 할 곳이다
- XCom 탭은 XCom.push() 또는 TaskFlow 함수 반환값을 보여준다
- Details 탭은 Task ID/State, Dag Run ID/Version/Bundle Name, Operator, Pool/slot 사용량, Executor 설정을 포함한다