Airflow

UI 개요 - 테마와 브라우저 요구사항

Airflow UI는 데이터 파이프라인과 데이터 asset을 모니터링·관리·트러블슈팅하는 강력한 방법을 제공한다. Airflow 3부터 UI는 다크/라이트 테마 지원과 재설계된 내비게이션 경험을 갖춘 현대적인 모습으로 새로 단장되었다.

이 문서의 스크린샷은 기본적으로 다크 테마를 사용하며, 일부 뷰는 비교를 위해 라이트 테마로도 함께 보여준다. 테마는 Airflow UI 하단 모서리의 사용자 설정에서 전환할 수 있다.

Airflow 3 UI는 최신 브라우저와 CSS 기능을 사용한다. Chrome, Edge, Firefox, Safari의 최신 버전을 사용해야 한다 - ``oklch()``나 ``color-mix()`` 같은 최신 CSS 색상 함수를 지원하지 않는 구형 브라우저 버전은 UI를 올바르게 렌더링하지 못할 수 있다.

Home Page - 시스템 상태와 최근 활동의 고수준 개요

Home Page는 시스템 상태와 최근 활동에 대한 고수준 개요를 제공한다. Airflow 3의 기본 랜딩 페이지이며 다음을 포함한다: MetaDatabase, Scheduler, Triggerer, Dag Processor 같은 시스템 컴포넌트의 **헬스 인디케이터**; 상태별로 필터링된 Dag로 이동하는 **빠른 링크**(예: 실패한 Dag, 실행 중인 Dag, 활성 Dag); 선택 가능한 시간 범위에 걸친 성공/실패율과 개수를 보여주는 **Dag 및 Task Instance 이력**; materialization과 트리거된 Dag를 포함한 **최근 asset 이벤트**.

이 페이지는 환경의 건강 상태를 빠르게 평가하고 최근 이슈나 asset 트리거 이벤트를 파악하는 데 유용하다.

Dag List View - Dag 목록과 필터링

Dag List View는 메인 내비게이션 바에서 **Dags** 탭을 클릭하면 나타난다. 환경에 있는 모든 Dag를 상태, 최근 실행, 설정 요약과 함께 보여준다.

각 행에는 다음이 포함된다: **Dag ID**; **스케줄**과 다음 실행 시각; **최근 Dag Run의 상태**; **최근 실행의 바 차트**; 그룹화·필터링에 쓰이는 **태그**(예: ``example``, ``produces``); **일시정지/재개 토글**; Dag 레벨 뷰로 이동하는 링크.

뷰 상단에서는 Dag 상태·스케줄 상태·태그 **필터**를 사용하거나, **검색**이나 **고급 검색(⌘+K)**으로 특정 Dag를 찾거나, 드롭다운(예: 최근 실행 시작 날짜)으로 목록을 **정렬**할 수 있다.

일부 Dag는 데이터 asset과 상호작용한다 - asset 조건에 의해 트리거되는 Dag는 업스트림 asset 입력을 보여주는 팝업을 표시할 수 있다.

Dag Details Page - 탭 기반 메타데이터·진단 뷰

목록에서 Dag를 클릭하면 Dag Details Page가 열린다. 이 뷰는 Dag의 메타데이터, 최근 활동, 태스크 레벨 진단에 대한 중앙 집중식 접근을 제공한다.

주요 요소: ID, 소유자, 태그, 스케줄, 최신 Dag 버전을 포함한 **Dag 메타데이터**; Dag를 트리거하거나 재파싱하거나 일시정지/재개할 수 있는 **액션 버튼**; **탭 인터페이스** - Overview(최근 실패, 실행 횟수, 태스크 로그), Grid View(상태 히트맵), Graph View(태스크 의존성), Runs(전체 실행 이력), Tasks(집계 통계), Events(시스템/asset 트리거 이벤트), Code(Dag 소스), Details(확장 메타데이터).

이 페이지는 또한 최근 Dag 실행에 대한 시각적 **타임라인**과 실패에 대한 **로그 미리보기**를 포함해, 사용자가 여러 실행에 걸친 이슈를 빠르게 파악할 수 있게 돕는다.