Skip to main content

Stakkr Observer

Cockpit-based observability for the Stakkr host resource model, packaged as a standalone plugin and published here as the UI landing page.

Cockpit plugin RPM installable Python 3 backend Plain JavaScript frontend

The observer is the supported Stakkr UI path. It answers the live-state question that the workflow docs deliberately do not:

note

Is the current host resource policy behaving the way Stakkr intends right now?

What It Shows

  • current host policy state
  • CPU performance domains and weights
  • CPU pool topology and per-CPU utilization
  • host memory overview, including THP, KSM, and zram state
  • memory management overhead from ksmd, kswapd*, and kcompactd*

Where It Fits

Use the observer after the host foundation or cluster workflows are already in motion. It is not a replacement for the operator entrypoints.

Install Paths

From the built RPM at the repo root:

cd /path/to/stakkr
sudo dnf install -y ./cockpit/stakkr-observer/rpmbuild/RPMS/noarch/cockpit-stakkr-observer-1.0.0-1.el10.noarch.rpm

From source into Cockpit's plugin directory:

sudo mkdir -p /usr/share/cockpit/stakkr-observer
sudo rsync -av /path/to/stakkr/cockpit/stakkr-observer/ /usr/share/cockpit/stakkr-observer/

Panels

PanelPurpose
Current StateLive host policy state, host reserve, emulator placement, and guest domain placement
CPU Performance DomainsScope weights, allowed CPUs, vCPU pinning, and emulator pinning
CPU Pool TopologyPer-CPU role map, utilization, and current frequency
Memory OverviewHost memory totals, THP state, KSM savings, zram state, and swap usage
Memory Management OverheadCPU cost of ksmd, kswapd*, and kcompactd*

Source Of Truth

The authoritative implementation for the observer lives under cockpit/stakkr-observer/. This page is the GitHub Pages navigation destination for it, not a second implementation.