grafatui 0.1.8

A Grafana-like TUI for Prometheus
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

# Exporting and Recording

Grafatui can export the current dashboard view as SVG, PNG, or both. It can also record changed dashboard states into a timestamped frame bundle.

## Export a Snapshot

Press `e` to export the current visible dashboard.

Output files are written under `--export-dir`:

```bash
grafatui --export-dir ./grafatui-exports --export-format both
```

Supported formats:

- `svg`
- `png`
- `both`

## Record Changed Frames

Press `Ctrl+E` to start recording. Press `Ctrl+E` again, or quit with `q`, to finalize the bundle.

Grafatui records only changed rendered states:

```text
grafatui-recording-<timestamp>/
  frame-000001.svg
  frame-000002.svg
  manifest.json
```

If `--export-format png` or `both` is selected, matching PNG files are written too.

## Recording Limits

Limit the number of changed frames in one recording:

```bash
grafatui --record-max-frames 300
```

When the frame cap is reached, Grafatui stops writing new frames and records `completed_reason = "capped"` when finalized.

## Manifest

Each recording writes a `manifest.json` file with metadata for downstream tooling:

```json
{
  "version": 1,
  "format": "svg",
  "changed_only": true,
  "frame_count": 2,
  "max_frames": 300,
  "completed_reason": "stopped",
  "viewport": { "width": 100, "height": 40 },
  "frames": [
    {
      "index": 1,
      "elapsed_ms": 0,
      "files": ["frame-000001.svg"]
    }
  ]
}
```