rlg-cli 0.0.11

`rlg` — `jq` for structured logs. Tail, filter, and convert log streams across all 14 `rlg` formats from the command line.
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

<!-- 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-cli</h1>

<p align="center">
  <code>jq</code> for structured logs. Tail, filter, and convert log
  streams across all 14 <code>rlg</code> formats from the command line.
</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-cli"><img src="https://img.shields.io/crates/v/rlg-cli.svg?style=for-the-badge&color=fc8d62&logo=rust" alt="Crates.io" /></a>
  <a href="https://docs.rs/rlg-cli"><img src="https://img.shields.io/badge/docs.rs-rlg--cli-66c2a5?style=for-the-badge&labelColor=555555&logo=docs.rs" alt="Docs.rs" /></a>
  <a href="https://lib.rs/crates/rlg-cli"><img src="https://img.shields.io/badge/lib.rs-rlg--cli-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-cli
```

The binary is named `rlg`. Requires Rust **1.88.0** or newer (edition 2024).

## Usage

```bash
# Default: read JSON records from stdin, emit Logfmt to stdout.
my-service | rlg

# Tail a file and convert to MCP-shaped JSON-RPC notifications.
rlg /var/log/app.ndjson --format mcp

# Drop everything below ERROR.
my-service | rlg --min-level error

# Show only records from the `db` component.
my-service | rlg --component db

# Filter by a single attribute (value parsed as JSON).
my-service | rlg --attr user_id=42
my-service | rlg --attr 'region="eu-west-1"'

# Combine filters and pick an output format.
rlg /var/log/app.ndjson \
    --min-level warn \
    --component api \
    --format ecs
```

### Supported output formats

`clf`, `cef`, `elf`, `w3c`, `apache`, `log4j-xml`, `json`,
`gelf`, `logstash`, `ndjson`, `mcp`, `otlp`, `logfmt`, `ecs`.

### Input

For `0.0.11`, the CLI accepts the **canonical `LogFormat::JSON`
shape** — one record per line. Unparseable lines pass through
verbatim so you can pipe non-rlg log noise through `rlg`
without losing entries.

Parsers for the other input formats (MCP transport envelope,
OTLP, ECS, GELF, Logstash) are tracked under
[`crates/rlg-cli/doc/INPUT-FORMATS.md`](doc/INPUT-FORMATS.md)
and land incrementally.

## 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.