alytricality-airflow
Airflow task-instance tracing for alytricality,
the opinionated OpenTelemetry tracing distro for data pipelines. It registers an
Airflow listener that opens one span per task instance and links it to the trace
that triggered the DAG run, so a pipeline reads as a single trace from its
upstream trigger through every task.
Pre-launch naming.
alytricality-airflowis a placeholder distribution name. The project will be republished under its real brand at launch; the import package and the plugin entry-point name change with it.
Install
pip install alytricality-airflow
There is nothing to import and no file to copy into plugins/. The package
ships an airflow.plugins entry point, so installing it next to Airflow — in
the same environment as the scheduler and workers — is the entire installation.
On Composer, add alytricality[gcp] and alytricality-airflow to
pypi_packages; in a custom image, install the same two lines.
apache-airflow is a peer dependency supplied by the runtime and is
deliberately not pinned here. alytricality is pinned exactly: the two
distributions release in lockstep.
Configure
Configuration is the core package's standard OTEL_* environment, set on the
scheduler and workers:
OTEL_EXPORTER_OTLP_ENDPOINT=https://collector.example.com
OTEL_SERVICE_NAME=airflow
OTEL_RESOURCE_ATTRIBUTES=deployment.environment=prod
The listener applies two setdefaults of its own before its first hook —
OTEL_SERVICE_NAME=airflow and OTEL_PYTHON_DISABLED_INSTRUMENTATIONS=flask
(the Airflow webserver is Flask; its health-check spans are noise). A value you
set always wins.
Behavior
- One span per task instance, keyed by
(dag_id, run_id, task_id, map_index), named after the baretask_idso mapped instances aggregate. - Trace linkage from
ti.context_carrier(native AIP-49) or atraceparentin the DAG run'sconf— a link, not a remote parent, since the trigger and the DAG run are independently rooted. - Task attributes under
airflow.task.*; terminal state set at span end. - Failures captured on the span and written to stderr, so a traceback survives pod teardown under the KubernetesExecutor.
- Defers entirely to an existing tracer provider (e.g. Airflow-native
otel_on=True) — never fights another owner for the global provider. - Bounded flush per task; a telemetry failure never fails the task.
Supported window
Python 3.10–3.13, Airflow 2.9+ and 3.x (2.9, 2.11, 3.1, and 3.2 covered in CI), OpenTelemetry SDK 1.27–1.45.
License
Apache-2.0.
Metadata
Release files for alytricality-airflow 0.2.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| alytricality_airflow-0.2.0.tar.gz | 9.5 kB | With provenance | Details for alytricality_airflow-0.2.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| alytricality_airflow-0.2.0-py3-none-any.whl | Python 3 | none | any | Details for alytricality_airflow-0.2.0-py3-none-any.whl |
Total release size: 20.8 kB
Release files / alytricality_airflow-0.2.0.tar.gz
| Download URL | alytricality_airflow-0.2.0.tar.gz |
|---|---|
| Size | 9.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
708f4e2b21a0e602d620429233e06100462a3a39ffb10bf30b2cba0ca66e5230
|
|
BLAKE2b-256 checksum How to use checksums |
1c2f7cbc902164daa84dc816be30c9bb98a2b9b14adc10046e34b5d0bbdf0d92
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 28, 2026.
Transparency logRelease files / alytricality_airflow-0.2.0-py3-none-any.whl
| Download URL | alytricality_airflow-0.2.0-py3-none-any.whl |
|---|---|
| Size | 11.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
9e64fca17ee77828e01ab962aa51c60ba86bbe687e27935d3fefba4c8e95984f
|
|
BLAKE2b-256 checksum How to use checksums |
12ceaa58bd2a962597f455132369b1a73f75ff2276498f3e06e31902e9753b87
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 28, 2026.
Transparency logSecurity for alytricality-airflow 0.2.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
Both files in this release have been uploaded with provenance metadata.
Attestation for alytricality_airflow-0.2.0.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 28, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.