---
id: airflow-exporter
version: "2.1.0"
license: MIT License Copyright (c) 2025 Epoch8 Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the… (full text in the JSON record)
license_treatment: permissive
maintenance: active
---

# airflow-exporter — Airflow plugin to export dag and task based metrics to Prometheus.

License: permissive · Maintenance: active · Downloads: 290.4K/mo

## 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 above — 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

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

- License: MIT License Copyright (c) 2025 Epoch8 Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the… (full text in the JSON record) (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 290.4K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

airflow prometheus metrics, airflow monitoring exporter, dag task metrics prometheus, airflow observability plugin, prometheus airflow integration, airflow metrics endpoint, workflow monitoring prometheus, airflow-plugin, prometheus-exporter, observability

[View on SkillFed](https://skillfed.io/packages/airflow-exporter) · [View on PyPI](https://pypi.org/project/airflow-exporter/)