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.

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 help

Exemplos

TUI interactiva
delonix dash
Snapshot único, para um script
delonix dash --once
JSON, para um datasource ou pipeline
delonix 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.