delonix dash
Dashboard de resumo/KPIs (TUI estilo htop) — RAM/rede/disco, uptime por-container, JSON e Prometheus.
Summary/KPI dashboard (htop-style TUI) — RAM/network/disk, per-container uptime, JSON and Prometheus.
Vista viva do estado do runtime — containers, VMs, imagens, redes, storage — num
só ecrã, sem precisar de correr ls em 5 grupos diferentes. Cada grupo também tem o
seu próprio (container dash, vm dash, ...); este é o agregado global.
KPIs dinâmicos: memória do slice cgroup, tráfego rx/tx acumulado por-container (com contagem
explícita de containers --net host/none não medidos, nunca somados como zero em
silêncio), uso de disco por área (imagens/volumes/VM-images/containers), e uptime real por
container (coluna UP, do pid_starttime). A tecla m alterna o
sparkline entre containers a correr e memória usada. --once imprime um snapshot de
texto e sai (scripts/CI) — é também o que acontece automaticamente quando o stdout não é um
terminal. --json dá o mesmo snapshot em JSON, para scripts ou um datasource do
Grafana. Para scrape contínuo, o delonix-mgmt/delonix-cri expõem
/metrics (Prometheus — gauges de containers/VMs/memória/rede/disco) e
GET /v1/dash (o mesmo DashSummary em JSON); os campos caros (rede/disco)
recalculam em background a cada 30s, o scrape em si fica sempre rápido.
A live view of runtime state — containers, VMs, images, networks, storage —
in one screen, without running ls across 5 different groups. Each group also has its
own (container dash, vm dash, ...); this is the global aggregate.
Dynamic KPIs: cgroup slice memory, accumulated rx/tx traffic per container (with an explicit count
of unmeasured --net host/none containers, never silently summed as zero), disk usage
by area (images/volumes/VM-images/containers), and real per-container uptime (the UP
column, from pid_starttime). The m key toggles the sparkline between
running containers and memory used. --once prints a text snapshot and exits
(scripts/CI) — also what happens automatically when stdout isn't a terminal. --json
gives the same snapshot as JSON, for scripts or a Grafana datasource. For continuous scraping,
delonix-mgmt/delonix-cri expose /metrics (Prometheus —
container/VM/memory/network/disk gauges) and GET /v1/dash (the same
DashSummary as JSON); the expensive fields (network/disk) recompute in the background
every 30s, so the scrape itself always stays fast.
📄 Implementação real em Rust: cmd/dash.rs
Usage: dlx dash [OPTIONS]
Options:
--l18n <en|pt> Output language: `en` (default) or `pt` (Portuguese, pt_AO). Also settable via `$DELONIX_L18N`. Global — works before any subcommand
--once Print ONE text snapshot and exit (no TUI) — for scripts/CI; the default when stdout is not a terminal
--json Print ONE snapshot as JSON and exit (no TUI, no ANSI) — for scripts/Grafana JSON datasource
-h, --help Print helpExemplos
delonix dashdelonix dash --oncedelonix dash --json | jq '.tiles'LaboratórioLab
Um ecrã só, sem correr ls em 5 grupos diferentes.
delonix dash --once
delonix dash
Na TUI, carrega em m para alternar o sparkline entre containers a correr e memória
usada.
One screen, instead of running ls across 5 different
groups.
delonix dash --once
delonix dash
In the TUI, press m to toggle the sparkline between running containers and memory
used.
DesafioChallenge
Corre delonix dash --json | jq e confirma que os
campos de rede/disco vêm marcados de forma explícita quando ainda não foram medidos — nunca
disfarçados de zero.
Run delonix dash --json | jq and confirm the network/disk
fields are explicitly marked when they haven't been measured yet — never disguised as zero.