# jackin-telemetry (https://jackin.tailrocks.com/reference/crates/jackin-telemetry/)



{/* GENERATED from crates/jackin-telemetry/README.md — edit the README, not this file */}

The schema authority and governed instrumentation facade keep jackin❯ telemetry consistent across processes.

## What this crate owns [#what-this-crate-owns]

* The closed OpenTelemetry extension registry and generated Rust constants.
* Bounded semantic values and correlation-id minting.
* Privacy-safe typed error capture for arbitrary `Result` error types.

## Architecture tier and allowed dependencies [#architecture-tier-and-allowed-dependencies]

T0; no workspace dependencies. Ecosystem dependencies are limited to OpenTelemetry semantic conventions and UUID generation.

## Structure [#structure]

| Module                                                                                                                                                                                                                                                                                                                          | Owns                                                            | Tests                                                                                           |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------- | ----------------------------------------------------------------------------------------------- |
| <RepoFile path="crates/jackin-telemetry/src/lib.rs">`lib.rs`</RepoFile>                                                                                                                                                                                                                                                         | Crate root and re-exports                                       | —                                                                                               |
| <RepoFile path="crates/jackin-telemetry/src/schema.rs">`schema.rs`</RepoFile> · <RepoFile path="crates/jackin-telemetry/src/schema.rs">`schema/`</RepoFile>                                                                                                                                                                     | Generated attributes, events, spans, and bounded values         | <RepoFile path="crates/jackin-telemetry/src/schema/tests.rs">`tests.rs`</RepoFile>              |
| <RepoFile path="crates/jackin-telemetry/src/event.rs">`event.rs`</RepoFile> · <RepoFile path="crates/jackin-telemetry/src/error.rs">`error.rs`</RepoFile> · <RepoFile path="crates/jackin-telemetry/src/operation.rs">`operation.rs`</RepoFile> · <RepoFile path="crates/jackin-telemetry/src/metric.rs">`metric.rs`</RepoFile> | Bounded governed signal facade                                  | <RepoFile path="crates/jackin-telemetry/tests/disabled_alloc.rs">`disabled_alloc.rs`</RepoFile> |
| <RepoFile path="crates/jackin-telemetry/src/spawn.rs">`spawn.rs`</RepoFile> · <RepoFile path="crates/jackin-telemetry/src/propagation.rs">`propagation.rs`</RepoFile>                                                                                                                                                           | Async ownership and W3C propagation                             | module tests                                                                                    |
| `benches/`                                                                                                                                                                                                                                                                                                                      | Disabled-path benchmark and reviewed 5% cross-workload baseline | `cargo xtask telemetry-bench`                                                                   |

## Public API [#public-api]

Import schema names and bounded values through `jackin_telemetry::schema`.

At a fallible operation's semantic owner, `ResultTelemetryExt` records any
`Err` as one typed event without formatting it and returns the result unchanged.
The operation guard separately completes failed span status with the same type.

## How to verify [#how-to-verify]

`cargo nextest run -p jackin-telemetry --locked`

The scheduled performance lane runs the calibration benchmark and four product
Criterion targets, then `cargo xtask telemetry-bench --capture`. The comparator
normalizes every workload median by the same-run `telemetry_calibration` median,
so uniform runner-speed changes do not masquerade as product regressions.
Refresh the reviewed <RepoFile path="crates/jackin-telemetry/benches/baseline.json">`baseline`</RepoFile> only from one complete,
inspected run with reference machine/toolchain data; a normalized regression
above 5% fails.