Node Readiness Controller exposes Prometheus-compatible metrics. This page describes the Prometheus metrics exposed by Node Readiness Controller for monitoring rule evaluation, taint operations, failures, and bootstrap progress.
The controller serves metrics on /metrics only when metrics are explicitly enabled. Depending on the installation, the endpoint is served either over HTTP or over HTTPS. See Installation for deployment details.
Number of NodeReadinessRule objects tracked by the controller.
Property Value
Type gaugeLabels none Recorded when The controller refreshes or removes a tracked rule
Total number of taint operations performed by the controller.
Property Value
Type counterLabels rule, operationRecorded when The controller successfully adds or removes a taint
Label Description Values
ruleNodeReadinessRule nameAny rule name operationTaint operation performed by the controller add, remove
Duration of rule evaluations per rule.
Property Value
Type histogramLabels ruleBuckets Prometheus default histogram buckets Recorded when The controller evaluates a rule against a node
Label Description Values
ruleNodeReadinessRule nameAny rule name
Total number of failure events recorded by the controller.
Property Value
Type counterLabels rule, reasonRecorded when The controller records an evaluation failure or taint add/remove failure
Label Description Values
ruleNodeReadinessRule nameAny rule name reasonFailure label recorded by the controller EvaluationError, AddTaintError, RemoveTaintError
Available starting from the v0.6.0 release.
Build information for the node-readiness-controller binary.
Property Value
Type gaugeLabels versionRecorded when The controller starts up
Label Description Values
versionBuild version of the running binary Any version string, or unknown if not set at build time
Available starting from the v0.6.0 release.
Number of nodes currently held or released by each NodeReadinessRule, collected at scrape time from the controller cache.
Property Value
Type gaugeLabels rule, stateRecorded when Computed on each Prometheus scrape from the cached node list
Label Description Values
ruleNodeReadinessRule nameAny non-dry-run rule name with a valid selector stateWhether matching nodes are still tainted by the rule or have had the taint removed held, released
Total number of nodes that have completed bootstrap.
Property Value
Type counterLabels ruleRecorded when The controller marks bootstrap as completed for a node under a bootstrap-only rule
Label Description Values
ruleNodeReadinessRule nameAny rule name
The readiness-condition-reporter serves its own Prometheus metrics on /metrics, on the address configured by METRICS_BIND_ADDRESS. See Reporter Configuration for deployment details.
Reporter binary version to track fleet version skew.
Property Value
Type gaugeLabels versionRecorded when The reporter process starts
Label Description Values
versionReporter binary version Any version string
Duration of health probe checks.
Property Value
Type histogramLabels none Buckets 0.005, 0.1, 0.25, 0.5, 1, 2.5, 5, 10 secondsRecorded when The reporter completes a health check request to CHECK_ENDPOINT
Total probe check results over time.
Property Value
Type counterLabels resultRecorded when The reporter completes a health check and classifies the result
Label Description Values
resultOutcome of the health check healthy, unhealthy, error
Total node condition update outcomes, including writes skipped when state was unchanged.
Property Value
Type counterLabels resultRecorded when The reporter evaluates whether to write the Node condition after a health check, including when the write is skipped
Label Description Values
resultOutcome of the condition write attempt success, error, skipped