Skip to content

Logs and metrics

The platform monitors itself with its own stack on every node: metrics in VictoriaMetrics, logs in VictoriaLogs, traces in Tempo, alarms through vmalert and Alertmanager.

Page Shows
Admin › Substrate › Overview Health at a glance: nodes, control plane, network, storage, reconcilers.
Admin › Substrate › Platform Health The monitoring pack’s components and dashboards.
Admin › Substrate › Explore Ad-hoc metric and log queries.
Admin › Substrate › Substrate Services Each service’s recent logs.
A node under Admin › Metal Host metrics over 15 minutes to 24 hours.
Explore: a metric query.
Explore: a metric query.
Terminal window
sudo journalctl -u stratum-controlplane -b # a service's log since boot
sudo journalctl -u stratum-host-helper --since -1h
sudo podman ps # the platform containers
sudo podman logs --tail 100 openbao

Console: Admin › Substrate › Substrate Tools lists each internal tool with its address and an SSH tunnel command: the metrics query UI (vmui), the metrics API, the scrape agent’s target list, the secrets store UI, the database, OVN and libvirt. With DNS forwarding of the parent domain in place, the web tools answer by name through the front door:

Name Tool
vmui.<parent> Metric queries (PromQL).
vmagent.<parent> Scrape targets and their state.
openbao.<parent> The secrets store’s UI.

The page is limited to the install’s bootstrap administrator.

Substrate Tools with addresses and tunnel commands.
Substrate Tools with addresses and tunnel commands.

The platform’s metrics API speaks the Prometheus query API:

Terminal window
curl -s "https://vmui.cloud.example.com/api/v1/query?query=up" | jq '.data.result | length'