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
Time from node creation to bootstrap completion (taint removal) for bootstrap-only rules.
Property Value
Type histogramLabels ruleBuckets 1, 5, 10, 30, 60, 120, 300, 600, 1200 secondsRecorded when The controller removes the bootstrap taint from a node under a bootstrap-only rule
Label Description Values
ruleNodeReadinessRule nameAny rule name
End-to-end latency from a node condition change to the taint operation that responds to it.
Property Value
Type histogramLabels rule, operationBuckets 0.01, 0.05, 0.1, 0.5, 1, 2, 5, 10, 30, 60, 120, 300 secondsRecorded when The controller adds or removes a taint after a node condition change
Label Description Values
ruleNodeReadinessRule nameAny rule name operationTaint operation that closed the reconciliation add_taint, remove_taint
Number of nodes in each readiness state per rule.
Property Value
Type gaugeLabels rule, stateRecorded when The controller syncs node state, including on each rule reconciliation
Label Description Values
ruleNodeReadinessRule nameAny rule name stateReadiness state of the counted nodes ready, not_ready, bootstrapping
Total number of failed condition evaluations, broken down by the condition that failed. Use this to find which check within a rule is blocking node readiness.
Property Value
Type counterLabels rule, conditionRecorded when The controller evaluates a rule condition against a node and the condition is not met
Label Description Values
ruleNodeReadinessRule nameAny rule name conditionType of the condition that failed Any condition type defined on the rule
Unix timestamp of the last reconciliation for each rule. Use this to detect rules that have stopped reconciling.
Property Value
Type gaugeLabels ruleRecorded when The controller reconciles the 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