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.
alytricalityis a placeholder distribution name. The project will be republished under its real brand at launch; the import package, entry points, andtelemetry.distro.nameall 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)
| 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)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| 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 logRelease 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 logSecurity 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.
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 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.