Prometheus Metrics
This page is the full reference for Prometheus metrics exposed by the Cluster Readiness Engine (CRE) controller. All metrics are registered with the controller-runtime metrics registry and served on the /metrics endpoint.
Scrape configuration
The Helm chart ships a ServiceMonitor for the Prometheus Operator (enabled by default via metrics.serviceMonitor.enabled):
Job status metrics
The gauge is set for all three status values on each update, ensuring that a transition from in_progress to succeeded also zeroes out the in_progress series. Metrics are cleaned up when a Job is deleted.
Hardware failure metrics
Node health check metrics
Reconciliation metrics
Workload metrics
Goodput metrics
All goodput metrics share the same label set: namespace, measurement, job, workflow.
Goodput metrics are cleaned up when a GoodputMeasurement is deleted.
Metric lifecycle
Goodput metrics are cleaned up at specific lifecycle events to prevent stale data in Prometheus:
NCCL bandwidth metrics
All NCCL bandwidth metrics share the same label set: namespace, measurement, job, workflow, nccl_test, message_size_bytes.
The nccl_test label identifies the collective operation (e.g., all_reduce, all_gather, alltoall). The message_size_bytes label tracks results per message size tested.
NCCL bandwidth metrics are cleaned up when a BandwidthMeasurement is deleted.
Cardinality at scale: NCCL metrics include a message_size_bytes label (typically 20-30 values per test). With 3 test types and 10 concurrent measurements, expect ~600-900 NCCL time series. Goodput metrics produce 10 series per measurement. At 100+ concurrent Jobs, monitor your Prometheus memory and consider increasing sampleInterval or limiting concurrent Certifications.
Topology metrics
Example PromQL queries
Job status
Hardware failures
Goodput
NCCL bandwidth
Reconciliation performance
Topology validation
Example alerting rules
The following PrometheusRule examples provide starting points for monitoring a burn-in cluster.
See also
- Job API — the resource that emits job status and hardware failure metrics
- GoodputMeasurement API and BandwidthMeasurement API — the resources that populate goodput and bandwidth metrics
- Workflow API — the resource that populates topology validation metrics
- Goodput & Bandwidth Measurement — conceptual overview of the goodput formula and its components