pleme-observability 0.3.2

Observability library for Pleme platform - tracing, metrics, distributed tracing, and metric definition macros
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
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54

# pleme-observability

Observability library for Pleme platform - tracing, metrics, distributed tracing, and metric definition macros

## Installation

```toml
[dependencies]
pleme-observability = "0.1"
```

## Usage

```rust
use pleme_observability::{init_observability, define_metrics};

// Auto-detects OpenTelemetry vs basic tracing
init_observability("my-service").await?;

define_metrics! {
    REQUESTS_TOTAL: Counter = "http_requests_total";
    REQUEST_DURATION: Histogram = "http_request_duration_seconds";
}
```

## Feature Flags

| Feature | Description |
|---------|-------------|
| `tracing-basic` | Basic tracing subscriber setup |
| `distributed-tracing` | OpenTelemetry distributed tracing |
| `metrics` | Prometheus metric definitions via `define_metrics!` |
| `full` | All features enabled |

Enable features in your `Cargo.toml`:

```toml
pleme-observability = { version = "0.1", features = ["full"] }
```

## Development

This project uses [Nix](https://nixos.org/) for reproducible builds:

```bash
nix develop            # Dev shell with Rust toolchain
nix run .#check-all    # cargo fmt + clippy + test
nix run .#publish      # Publish to crates.io (--dry-run supported)
nix run .#regenerate   # Regenerate Cargo.nix
```

## License

MIT - see [LICENSE](LICENSE) for details.