klauthed-observability 0.7.0

Observability for klauthed: tracing spans, metrics, and OpenTelemetry wiring.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39

# klauthed-observability

Observability for klauthed services: structured logging/tracing, Prometheus metrics, and
OpenTelemetry trace export — all from one `TelemetryConfig`.

`init` installs the global tracing subscriber (and, per feature + config, the metrics
recorder and the OTLP trace pipeline) and returns a `Telemetry` handle. Keep it alive for
the program's lifetime; dropping it flushes OpenTelemetry spans.

```rust,no_run
use klauthed_observability::{init, TelemetryConfig};
use klauthed_core::config::Profile;

let config = TelemetryConfig::for_profile(&Profile::detect(), "billing-api");
let _telemetry = init(&config).expect("telemetry init");
tracing::info!("service starting");
```

## Features

| Feature | Enables |
|---------|---------|
| `metrics` | Prometheus recorder + a `/metrics` render handle |
| `otel` | OTLP trace export + the `propagation` module |

With `otel`, the `propagation` module carries W3C trace context across service
boundaries: `extract` a parent context from an inbound request's headers, and
`inject` / `inject_current` the active span into outbound request headers. Paired
with `klauthed-web`'s `RequestTracing` middleware, this stitches per-service spans
into a single distributed trace.

---

Part of the [klauthed rust-libraries](../README.md) workspace.
Browse the API: `cargo doc -p klauthed-observability --open`.

## License

Dual-licensed under [MIT](../LICENSE-MIT) or [Apache-2.0](../LICENSE-APACHE), at your option.