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.

RAPLIMCCHAIIOPCUUPI

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 or download classic JSON for one-off import. Use v2 resource JSON for provisioning.

    Sandy Bridge-EP

    Family 6 ยท Model 0x2d

    Latest channel
    DashboardOcellus Intel Sandy / Ivy Bridge Xeon
    Classic JSON206 KB
    V2 Resource327 KB
    Recommended for the import dialog

    Classic Import JSON

    Copy the dashboard body into Grafana's import text area, or download it and upload the file.

    Download
    For Git Sync and file provisioning

    Grafana V2 Resource JSON

    Keep this format for automated provisioning workflows and version-controlled dashboard resources. Download the resource file and place it in your provisioning path or repository.

    Download