Skip to main content

alytricality

An opinionated OpenTelemetry tracing distro for data pipelines. One decorator assembles the whole SDK — resource detection, OTLP export, bundled instrumentors, W3C context propagation, bounded flush on exit — from standard OTEL_* environment variables, and never breaks the workload: any telemetry failure degrades to no telemetry, loudly logged, never raised.

Pre-launch naming. alytricality is a placeholder distribution name. The project will be republished under its real brand at launch; the import package, entry points, and telemetry.distro.name all change with it.

Install

pip install alytricality

Extras: alytricality[gcp] adds the official GCP resource detector, alytricality[grpc] the OTLP/gRPC exporter, alytricality[all] both.

Use

from alytricality import traced


@traced
def handler(event): ...

@traced marks the process entry point and always produces a SERVER root span named after the function: it records exceptions, links any inbound trace context found in the first argument, and performs a bounded force_flush on exit. Applying it a second time to the same function is a no-op, so root spans never stack. For notebooks, REPLs, and scripts with no function to decorate, call init() instead — the same idempotent assembly, which returns the process runtime and never raises.

Everything you do inside a trace is native opentelemetry-api:

from opentelemetry import trace

trace.get_current_span().set_attribute("rows.loaded", 1042)

Configuration

Standard OTel environment variables only — there are no config kwargs and no package-specific vars, and the package never writes to the environment.

Variable Role
OTEL_EXPORTER_OTLP_ENDPOINT Required; without it tracing is disabled with a warning
OTEL_SERVICE_NAME Service identity
OTEL_RESOURCE_ATTRIBUTES Extra resource attributes
OTEL_EXPORTER_OTLP_PROTOCOL grpc selects the gRPC exporter; otherwise HTTP/protobuf
OTEL_EXPORTER_OTLP_COMPRESSION Defaults to gzip when unset; none disables
OTEL_PYTHON_DISABLED_INSTRUMENTATIONS Opt out of bundled instrumentors
OTEL_SDK_DISABLED true turns everything into a no-op

Export is always OTLP. requests, urllib3, psycopg2, and grpc instrumentation is bundled and applied automatically; an instrumentor whose target library isn't installed is skipped quietly.

Supported window

Python 3.10–3.13, OpenTelemetry SDK 1.27–1.45 (min and max both tested in CI). opentelemetry-instrumentation-* releases are pinned to the matched set for each SDK window, so consumers don't hand-curate OTel version lines.

License

Apache-2.0.

Metadata

Release files for alytricality 0.2.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for alytricality 0.2.0
File Size Uploaded Provenance Actions
alytricality-0.2.0.tar.gz 17.3 kB With provenance Details for alytricality-0.2.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for alytricality 0.2.0
File Interpreter ABI Platform Actions
alytricality-0.2.0-py3-none-any.whl Python 3 none any Details for alytricality-0.2.0-py3-none-any.whl

Total release size: 38.8 kB

Release files / alytricality-0.2.0.tar.gz

Download URL alytricality-0.2.0.tar.gz
Size 17.3 kB
Tags Source
SHA-256 checksum
How to use checksums
40f3ce755fb3404a23cff3fe004f02a5f2171488376afa8d0cda0716f4f2f9a7
BLAKE2b-256 checksum
How to use checksums
e86dff822151f5ae80f91db5970cb600cd5c30bfd263cce3f1575ac08f3986ed
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 log

Release files / alytricality-0.2.0-py3-none-any.whl

Download URL alytricality-0.2.0-py3-none-any.whl
Size 21.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
dd3fc4ed5476acda786eb9b98559d5cfbfca761de1d6c47ce472fb750e775fbf
BLAKE2b-256 checksum
How to use checksums
9f0d1eafa86f7717cbc24b724507976fadb2ec276ca77b15330b04ede1271e8d
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 log

Security for alytricality 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.

Select from 2 files

Attestation for alytricality-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 log

A 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.

Release history Release notifications | RSS feed

This release

0.2.0 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page