rlg-report 0.0.11

Log digest / analytics for rlg. Reads JSON-shaped rlg records from a file or stdin and produces aggregation tables: count by level, top components, top error messages, latency percentiles.
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
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97

<!-- SPDX-License-Identifier: Apache-2.0 OR MIT -->

<p align="center">
  <img src="https://cloudcdn.pro/rlg/v1/logos/rlg.svg" alt="RLG logo" width="128" />
</p>

<h1 align="center">rlg-report</h1>

<p align="center">
  Log digest / analytics for <code>rlg</code> streams. Count by level,
  group by component, rank top descriptions, compute latency
  percentiles.
</p>

<p align="center">
  <a href="https://github.com/sebastienrousseau/rlg/actions"><img src="https://img.shields.io/github/actions/workflow/status/sebastienrousseau/rlg/ci.yml?style=for-the-badge&logo=github" alt="Build" /></a>
  <a href="https://crates.io/crates/rlg-report"><img src="https://img.shields.io/crates/v/rlg-report.svg?style=for-the-badge&color=fc8d62&logo=rust" alt="Crates.io" /></a>
  <a href="https://docs.rs/rlg-report"><img src="https://img.shields.io/badge/docs.rs-rlg--report-66c2a5?style=for-the-badge&labelColor=555555&logo=docs.rs" alt="Docs.rs" /></a>
  <a href="https://lib.rs/crates/rlg-report"><img src="https://img.shields.io/badge/lib.rs-rlg--report-orange.svg?style=for-the-badge" alt="lib.rs" /></a>
  <a href="https://scorecard.dev/viewer/?uri=github.com/sebastienrousseau/rlg"><img src="https://img.shields.io/ossf-scorecard/github.com/sebastienrousseau/rlg?style=for-the-badge&label=OpenSSF%20Scorecard&logo=openssf" alt="OpenSSF Scorecard" /></a>
</p>

---

## Install

```bash
cargo install rlg-report
```

Requires Rust **1.88.0** or newer (edition 2024).

## CLI

```bash
# Pretty-printed digest of a log file.
rlg-report /var/log/app.ndjson

# JSON output for a dashboard.
rlg-report --format json /var/log/app.ndjson

# Read from stdin (e.g. piped from `rlg`).
my-service | rlg --format ndjson | rlg-report

# Keep only the top 3 description buckets.
rlg-report --top 3 /var/log/app.ndjson
```

### Sample output

```
── rlg report ───────────────────────────────────────────
total records:      18421
unparseable lines:  0

── by level ─────────────────
  INFO       16842
  WARN       912
  ERROR      640
  FATAL      27

── by component ─────────────
  api        12001
  db         3920
  orchestrator 2500

── top descriptions ─────────
   1240  GET /v1/users -> 200
    320  POST /v1/orders -> 201
    274  user authenticated
    ...

── latency (ms) ─────────────
  samples  16980
  p50      14
  p95      82
  p99      210
  max      4012
```

## Library mode

```rust
use rlg_report::Report;

let lines: Vec<&str> = my_log_lines();
let report = Report::from_lines(lines.into_iter());

println!("errors-and-above: {}", report.error_count());
if let Some(latency) = report.latency {
    println!("p99 latency: {} ms", latency.p99);
}
```

## License

Dual-licensed under [Apache 2.0](https://www.apache.org/licenses/LICENSE-2.0) or [MIT](https://opensource.org/licenses/MIT), at your option.