failed-deps

Elena Kostyuchenko

Definition

Returns the unmet dependencies for a task instance from the perspective of the scheduler. This command helps to determine why a task instance is not scheduled and queued by the scheduler.

Usage

$ airflow tasks failed-deps [-h] [--map-index MAP_INDEX] [-S SUBDIR] [-v]
                          dag_id task_id execution_date_or_run_id

Arguments

Parameter Description

dag_id

The ID of the DAG

task_id

The ID of the task

execution_date_or_run_id

The execution_date of the DAG or run_id of the DAG run

--map-index

Mapped task index. Default: -1

-S, --subdir

File or directory location for DAGs. Defaults to [AIRFLOW_HOME]/dags, where [AIRFLOW_HOME] is the value set for AIRFLOW_HOME config in airflow.cfg

-h, --help

Print out the help manual for this command

-v, --verbose

Make logging output more verbose

Examples

An example command for displaying unmet dependencies for a DAG:

$ airflow tasks failed-deps example_dag extract_people manual__2025-04-14T15:29:17.298007+00:00
Found a mistake? Seleсt text and press Ctrl+Enter to report it