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; there is no baked-in default
OTEL_SERVICE_NAME Service identity
OTEL_RESOURCE_ATTRIBUTES Extra resource attributes
OTEL_EXPORTER_OTLP_PROTOCOL grpc selects the gRPC exporter; otherwise HTTP/protobuf
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.44 (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.1.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.1.0
File Size Uploaded Provenance Actions
alytricality-0.1.0.tar.gz 12.6 kB With provenance Details for alytricality-0.1.0.tar.gz

Built distribution (wheel)

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

Total release size: 28.8 kB

Release files / alytricality-0.1.0.tar.gz

Download URL alytricality-0.1.0.tar.gz
Size 12.6 kB
Tags Source
SHA-256 checksum
How to use checksums
4e3f6151ee3b3c08bab5e4c79a20c3b6bcc9a9e1696d9f8340cea71bc8ab9128
BLAKE2b-256 checksum
How to use checksums
c49fca3d8e43e3881af276b62c1778a1e6ac390d0cdee4cacd0074195f8965a8
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 Aug 15, 2026.

Transparency log

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

Download URL alytricality-0.1.0-py3-none-any.whl
Size 16.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
1768f4d448b295069d046395c70eef33655c1db49bee4f152cbe53c6b4ae1aa9
BLAKE2b-256 checksum
How to use checksums
681be7b2bb9a79e5b71251f1cba173a710bff4b70a97a2b2f2f4e1a898362a14
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 Aug 15, 2026.

Transparency log

Security for alytricality 0.1.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.1.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 Aug 15, 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.1.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