list_dag_runs
Retrieve and display DAG run information for Airflow environments to monitor processing status and investigate historical failures. Filter by environment, date range, or specific DAG to analyze workflow execution.
Instructions
Get DAG runs for today, yesterday, last week, or a specific date.
This is the go-to tool when the user asks about DAG runs, processing status, or historical failures. Returns a numbered interactive list so the user can pick a specific run for deeper investigation.
Args: env: Target environment — 'dev', 'uat', 'test', or 'prod'. IMPORTANT: Do NOT guess or default. Ask the user which environment if not specified. dag_id: Optional — filter to a specific DAG. If omitted, shows ALL DAGs. date: 'today' (default), 'yesterday', 'last_week', or ISO date (e.g. '2026-02-15'). limit: Max runs to return (default 50).
Returns a numbered list of runs with status, timing and duration. Present these to the user so they can pick one by number.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| env | No | ||
| dag_id | No | ||
| date | No | today | |
| limit | No |