mx-logging 0.1.0

Tracing and OpenTelemetry logging utilities for MultiversX Rust services.
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
55
56

# mx-logging

Tracing and logging utilities for MultiversX services.

## Features

- Structured logging with tracing
- Compact console output format
- Environment-based configuration via `RUST_LOG`
- Optional OpenTelemetry integration (feature: `opentelemetry`)

## Usage

```rust
use mx_logging::init;

// Initialize with default filter
init(None, "info");

tracing::info!(tx_count = 100, "Processing batch");
```

### With explicit filter

```rust
use mx_logging::init;

// Explicit filter takes precedence over RUST_LOG
init(Some("mx_relayer=debug,mx_notifier=info"), "info");
```

### With OpenTelemetry (requires `opentelemetry` feature)

```rust,ignore
use mx_logging::{OtelConfig, init_with_otel};

let config = OtelConfig {
    service_name: "mx-relayer".to_string(),
    otlp_endpoint: "http://localhost:4317".to_string(),
    ..Default::default()
};

init_with_otel(&config, None, "info").expect("Failed to initialize tracing");
```

## Configuration

Set `RUST_LOG` environment variable:
```bash
RUST_LOG=mx_relayer=debug,mx_notifier=info cargo run
```

Filter priority:
1. `RUST_LOG` environment variable (if set)
2. Explicit `filter` argument (if provided)
3. `default_filter` argument