airflow-exporter

What it is and what it does

airflow-exporter is an Airflow plugin that bridges workflow orchestration and observability by publishing DAG and task metrics to Prometheus. It exposes metrics like task status counts, DAG status, DAG run duration, and the last DAG run state, each labeled with dag_id, task_id, owner, and status information. Metrics are served at a standard HTTP endpoint on your Airflow instance.

The package integrates directly into Airflow with minimal setup—a single pip install—and supports adding custom labels to metrics via DAG params, enabling environment-specific or team-specific metric segmentation. It requires apache-airflow and prometheus-client as runtime dependencies and supports current Python versions (3.9+), with separate version branches for Airflow 2.* and 3.* compatibility.

Use it for:

• Monitor DAG execution status and task completion rates in real time via Prometheus dashboards and alerts.
• Track DAG run duration to identify performance regressions or bottlenecks in workflow execution.
• Add environment or team labels to metrics for multi-tenant or multi-environment Airflow deployments.
• Integrate Airflow observability into existing Prometheus-based monitoring stacks without custom instrumentation.
• Alert on DAG failures or paused workflows by querying airflow_dag_last_status metrics in Prometheus rules.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Exposes Airflow DAG and task metrics to Prometheus, making workflow status and performance observable through a standard monitoring endpoint.

Yes. The package solves a clear problem—exposing Airflow metrics to Prometheus—with low install friction, active maintenance, permissive licensing, and no known vulnerabilities. It is suitable for any Airflow deployment that uses Prometheus for monitoring. Verify that your Airflow version (2.* or 3.*) matches the exporter version branch before installing.

Install

airflow-exporter on PyPI

pip install airflow-exporter

uv add airflow-exporter

poetry add airflow-exporter

Installing airflow-exporter

Before you install

Low friction: pure Python wheel with only two runtime dependencies (apache-airflow and prometheus-client). Actively maintained with a recent release; last commit 2026-07-05 and 279 repository stars suggest stable ongoing support.

License in practice

MIT license permits unrestricted use, modification, and distribution with minimal restrictions—suitable for commercial and open-source deployments alike.

Quickstart

pip install airflow-exporter

# Metrics automatically available at:
# http://<your_airflow_host_and_port>/admin/metrics/

# Optional: add labels to DAG params
dag = DAG(
    'dummy_dag',
    params={'labels': {'env': 'test'}}
)

Requires Python >=3.9 and a running Airflow instance (2.* for versions <2.0.0, 3.* for >=2.0.0).

Verify before relying

• Whether the exporter automatically registers itself as an Airflow plugin or requires manual configuration steps beyond pip install.
• Performance overhead when exporting metrics from DAGs with hundreds or thousands of tasks.

Package facts

Evidence: airflow_exporter-2.1.0-py3-none-any.whl

Keywords: airflow, exporter, metrics, plugin, prometheus

Tags

More Monitoring packages