Xeon uncore observability

Turn Intel Uncore PMU Countersinto Production Telemetry

Ocellus exports memory, cache, interconnect, power, and fabric counters as Prometheus metrics, with Grafana dashboards built for each Intel server generation.

How to use it

From host counters to Grafana in three steps.

  1. Run the Ocellus agent

    Download the latest static Linux binary and start Prometheus daemon mode on the Xeon host.

    curl -LO https://github.com/minhuw/ocellus/releases/latest/download/ocellus
chmod +x ocellus
sudo modprobe msr
sudo ./ocellus --daemon --listen 0.0.0.0:8080 --measure-interval-ms 1000

  2. Add the Prometheus scrape target

    Point Prometheus at the Ocellus agent and reload Prometheus.

    scrape_configs:
  - job_name: ocellus
    static_configs:
      - targets: ['xeon-host.example.com:8080']

  3. Import a Grafana dashboard

    Pick the matching Xeon family and version, then copy the dashboard URL into Grafana's import flow.

    Sandy Bridge-EP

    Family 6 ยท Model 0x2d

    Grafana dashboard

    Copy this URL into Grafana's dashboard import flow.

    https://ocellus.minhuw.dev/dashboards/intel-sandy-ivy-bridge-xeon.json