upstream/kubernetes
1
0
Fork 0
mirror of https://github.com/kubernetes/kubernetes.git synced 2026-06-08 16:30:57 -04:00
Code Issues Projects Releases Packages Wiki Activity Actions

Merge pull request #138628 from richabanker/metrics-docs-update-1.36

Browse source 
Make metric doc generation order-stable and update metrics docs for v1.36
This commit is contained in:
Kubernetes Prow Robot 2026-05-12 01:01:49 +05:30 committed by GitHub
commit 4cfd7e74b1
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
4 changed files with 5675 additions and 5501 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

10638
hack/tools/instrumentation/documentation/documentation-list.yaml
View file

File diff suppressed because it is too large Load diff

435
hack/tools/instrumentation/documentation/documentation.md
View file

@ -8,7 +8,7 @@ description: >-
## Metrics (v1.36)
<!-- (auto-generated 2026 Feb 28) -->
<!-- (auto-generated 2026 Apr 27) -->
<!-- (auto-generated v1.36) -->
This page details the metrics that different Kubernetes components export. You can query the metrics endpoint for these
components using an HTTP scrape, and fetch the current metrics data in Prometheus format.
@ -424,6 +424,48 @@ Beta metrics observe a looser API contract than its stable counterparts. No labe
<li data-type="counter"><label class="metric_detail">Type:</label> <span class="metric_type">Counter</span></li>
<li class="metric_component_endpoints"><label class="metric_detail">Components:</label><ul><li>cloud-controller-manager (/metrics)</li><li>kube-apiserver (/metrics)</li><li>kube-controller-manager (/metrics)</li><li>kube-proxy (/metrics)</li><li>kube-scheduler (/metrics)</li><li>kubelet (/metrics)</li></ul></li></ul>
</div><div class="metric" data-stability="beta">
<div class="metric_name">endpoint_slice_controller_desired_endpoint_slices</div>
<div class="metric_help">Number of EndpointSlices that would exist with perfect endpoint allocation</div>
<ul>
<li><label class="metric_detail">Stability Level:</label><span class="metric_stability_level">BETA</span></li>
<li data-type="gauge"><label class="metric_detail">Type:</label> <span class="metric_type">Gauge</span></li>
<li class="metric_component_endpoints"><label class="metric_detail">Components:</label><ul><li>kube-controller-manager (/metrics)</li></ul></li></ul>
</div><div class="metric" data-stability="beta">
<div class="metric_name">endpoint_slice_controller_endpoints_added_per_sync</div>
<div class="metric_help">Number of endpoints added on each Service sync</div>
<ul>
<li><label class="metric_detail">Stability Level:</label><span class="metric_stability_level">BETA</span></li>
<li data-type="histogram"><label class="metric_detail">Type:</label> <span class="metric_type">Histogram</span></li>
<li class="metric_component_endpoints"><label class="metric_detail">Components:</label><ul><li>kube-controller-manager (/metrics)</li></ul></li></ul>
</div><div class="metric" data-stability="beta">
<div class="metric_name">endpoint_slice_controller_endpoints_desired</div>
<div class="metric_help">Number of endpoints desired</div>
<ul>
<li><label class="metric_detail">Stability Level:</label><span class="metric_stability_level">BETA</span></li>
<li data-type="gauge"><label class="metric_detail">Type:</label> <span class="metric_type">Gauge</span></li>
<li class="metric_component_endpoints"><label class="metric_detail">Components:</label><ul><li>kube-controller-manager (/metrics)</li></ul></li></ul>
</div><div class="metric" data-stability="beta">
<div class="metric_name">endpoint_slice_controller_endpoints_removed_per_sync</div>
<div class="metric_help">Number of endpoints removed on each Service sync</div>
<ul>
<li><label class="metric_detail">Stability Level:</label><span class="metric_stability_level">BETA</span></li>
<li data-type="histogram"><label class="metric_detail">Type:</label> <span class="metric_type">Histogram</span></li>
<li class="metric_component_endpoints"><label class="metric_detail">Components:</label><ul><li>kube-controller-manager (/metrics)</li></ul></li></ul>
</div><div class="metric" data-stability="beta">
<div class="metric_name">endpoint_slice_controller_num_endpoint_slices</div>
<div class="metric_help">Number of EndpointSlices</div>
<ul>
<li><label class="metric_detail">Stability Level:</label><span class="metric_stability_level">BETA</span></li>
<li data-type="gauge"><label class="metric_detail">Type:</label> <span class="metric_type">Gauge</span></li>
<li class="metric_component_endpoints"><label class="metric_detail">Components:</label><ul><li>kube-controller-manager (/metrics)</li></ul></li></ul>
</div><div class="metric" data-stability="beta">
<div class="metric_name">endpoint_slice_controller_services_count_by_traffic_distribution</div>
<div class="metric_help">Number of Services using some specific trafficDistribution</div>
<ul>
<li><label class="metric_detail">Stability Level:</label><span class="metric_stability_level">BETA</span></li>
<li data-type="gauge"><label class="metric_detail">Type:</label> <span class="metric_type">Gauge</span></li>
<li class="metric_labels_varying"><label class="metric_detail">Labels:</label><span class="metric_label">traffic_distribution</span></li><li class="metric_component_endpoints"><label class="metric_detail">Components:</label><ul><li>kube-controller-manager (/metrics)</li></ul></li></ul>
</div><div class="metric" data-stability="beta">
<div class="metric_name">hidden_metrics_total</div>
<div class="metric_help">The count of hidden metrics.</div>
<ul>
@ -431,6 +473,48 @@ Beta metrics observe a looser API contract than its stable counterparts. No labe
<li data-type="counter"><label class="metric_detail">Type:</label> <span class="metric_type">Counter</span></li>
<li class="metric_component_endpoints"><label class="metric_detail">Components:</label><ul><li>cloud-controller-manager (/metrics)</li><li>kube-apiserver (/metrics)</li><li>kube-controller-manager (/metrics)</li><li>kube-proxy (/metrics)</li><li>kube-scheduler (/metrics)</li><li>kubelet (/metrics)</li></ul></li></ul>
</div><div class="metric" data-stability="beta">
<div class="metric_name">horizontal_pod_autoscaler_controller_metric_computation_duration_seconds</div>
<div class="metric_help">The time(seconds) that the HPA controller takes to calculate one metric. The label 'action' should be either 'scale_down', 'scale_up', or 'none'. The label 'error' should be either 'spec', 'internal', or 'none'. The label 'metric_type' corresponds to HPA.spec.metrics[*].type</div>
<ul>
<li><label class="metric_detail">Stability Level:</label><span class="metric_stability_level">BETA</span></li>
<li data-type="histogram"><label class="metric_detail">Type:</label> <span class="metric_type">Histogram</span></li>
<li class="metric_labels_varying"><label class="metric_detail">Labels:</label><span class="metric_label">action</span><span class="metric_label">error</span><span class="metric_label">metric_type</span></li><li class="metric_component_endpoints"><label class="metric_detail">Components:</label><ul><li>kube-controller-manager (/metrics)</li></ul></li></ul>
</div><div class="metric" data-stability="beta">
<div class="metric_name">horizontal_pod_autoscaler_controller_metric_computation_total</div>
<div class="metric_help">Number of metric computations. The label 'action' should be either 'scale_down', 'scale_up', or 'none'. Also, the label 'error' should be either 'spec', 'internal', or 'none'. The label 'metric_type' corresponds to HPA.spec.metrics[*].type</div>
<ul>
<li><label class="metric_detail">Stability Level:</label><span class="metric_stability_level">BETA</span></li>
<li data-type="counter"><label class="metric_detail">Type:</label> <span class="metric_type">Counter</span></li>
<li class="metric_labels_varying"><label class="metric_detail">Labels:</label><span class="metric_label">action</span><span class="metric_label">error</span><span class="metric_label">metric_type</span></li><li class="metric_component_endpoints"><label class="metric_detail">Components:</label><ul><li>kube-controller-manager (/metrics)</li></ul></li></ul>
</div><div class="metric" data-stability="beta">
<div class="metric_name">horizontal_pod_autoscaler_controller_reconciliation_duration_seconds</div>
<div class="metric_help">The time(seconds) that the HPA controller takes to reconcile once. The label 'action' should be either 'scale_down', 'scale_up', or 'none'. Also, the label 'error' should be either 'spec', 'internal', or 'none'. Note that if both spec and internal errors happen during a reconciliation, the first one to occur is reported in `error` label.</div>
<ul>
<li><label class="metric_detail">Stability Level:</label><span class="metric_stability_level">BETA</span></li>
<li data-type="histogram"><label class="metric_detail">Type:</label> <span class="metric_type">Histogram</span></li>
<li class="metric_labels_varying"><label class="metric_detail">Labels:</label><span class="metric_label">action</span><span class="metric_label">error</span></li><li class="metric_component_endpoints"><label class="metric_detail">Components:</label><ul><li>kube-controller-manager (/metrics)</li></ul></li></ul>
</div><div class="metric" data-stability="beta">
<div class="metric_name">horizontal_pod_autoscaler_controller_reconciliations_total</div>
<div class="metric_help">Number of reconciliations of HPA controller. The label 'action' should be either 'scale_down', 'scale_up', or 'none'. Also, the label 'error' should be either 'spec', 'internal', or 'none'. Note that if both spec and internal errors happen during a reconciliation, the first one to occur is reported in `error` label.</div>
<ul>
<li><label class="metric_detail">Stability Level:</label><span class="metric_stability_level">BETA</span></li>
<li data-type="counter"><label class="metric_detail">Type:</label> <span class="metric_type">Counter</span></li>
<li class="metric_labels_varying"><label class="metric_detail">Labels:</label><span class="metric_label">action</span><span class="metric_label">error</span></li><li class="metric_component_endpoints"><label class="metric_detail">Components:</label><ul><li>kube-controller-manager (/metrics)</li></ul></li></ul>
</div><div class="metric" data-stability="beta">
<div class="metric_name">job_controller_pod_failures_handled_by_failure_policy_total</div>
<div class="metric_help">`The number of failed Pods handled by failure policy with, respect to the failure policy action applied based on the matched, rule. Possible values of the action label correspond to the, possible values for the failure policy rule action, which are:, "FailJob", "Ignore" and "Count".`</div>
<ul>
<li><label class="metric_detail">Stability Level:</label><span class="metric_stability_level">BETA</span></li>
<li data-type="counter"><label class="metric_detail">Type:</label> <span class="metric_type">Counter</span></li>
<li class="metric_labels_varying"><label class="metric_detail">Labels:</label><span class="metric_label">action</span></li><li class="metric_component_endpoints"><label class="metric_detail">Components:</label><ul><li>kube-controller-manager (/metrics)</li></ul></li></ul>
</div><div class="metric" data-stability="beta">
<div class="metric_name">job_controller_terminated_pods_tracking_finalizer_total</div>
<div class="metric_help">`The number of terminated pods (phase=Failed|Succeeded), that have the finalizer batch.kubernetes.io/job-tracking, The event label can be "add" or "delete".`</div>
<ul>
<li><label class="metric_detail">Stability Level:</label><span class="metric_stability_level">BETA</span></li>
<li data-type="counter"><label class="metric_detail">Type:</label> <span class="metric_type">Counter</span></li>
<li class="metric_labels_varying"><label class="metric_detail">Labels:</label><span class="metric_label">event</span></li><li class="metric_component_endpoints"><label class="metric_detail">Components:</label><ul><li>kube-controller-manager (/metrics)</li></ul></li></ul>
</div><div class="metric" data-stability="beta">
<div class="metric_name">kubelet_image_volume_mounted_errors_total</div>
<div class="metric_help">Number of failed image volume mounts.</div>
<ul>
@ -487,6 +571,27 @@ Beta metrics observe a looser API contract than its stable counterparts. No labe
<li data-type="gauge"><label class="metric_detail">Type:</label> <span class="metric_type">Gauge</span></li>
<li class="metric_labels_varying"><label class="metric_detail">Labels:</label><span class="metric_label">manager</span><span class="metric_label">name</span></li><li class="metric_component_endpoints"><label class="metric_detail">Components:</label><ul><li>cloud-controller-manager (/metrics)</li><li>kube-apiserver (/metrics)</li><li>kube-controller-manager (/metrics)</li><li>kube-proxy (/metrics)</li><li>kube-scheduler (/metrics)</li><li>kubelet (/metrics)</li></ul></li></ul>
</div><div class="metric" data-stability="beta">
<div class="metric_name">scheduler_goroutines</div>
<div class="metric_help">Number of running goroutines split by the work they do such as binding.</div>
<ul>
<li><label class="metric_detail">Stability Level:</label><span class="metric_stability_level">BETA</span></li>
<li data-type="gauge"><label class="metric_detail">Type:</label> <span class="metric_type">Gauge</span></li>
<li class="metric_labels_varying"><label class="metric_detail">Labels:</label><span class="metric_label">operation</span></li><li class="metric_component_endpoints"><label class="metric_detail">Components:</label><ul><li>kube-scheduler (/metrics)</li></ul></li></ul>
</div><div class="metric" data-stability="beta">
<div class="metric_name">scheduler_permit_wait_duration_seconds</div>
<div class="metric_help">Duration of waiting on permit.</div>
<ul>
<li><label class="metric_detail">Stability Level:</label><span class="metric_stability_level">BETA</span></li>
<li data-type="histogram"><label class="metric_detail">Type:</label> <span class="metric_type">Histogram</span></li>
<li class="metric_labels_varying"><label class="metric_detail">Labels:</label><span class="metric_label">result</span></li><li class="metric_component_endpoints"><label class="metric_detail">Components:</label><ul><li>kube-scheduler (/metrics)</li></ul></li></ul>
</div><div class="metric" data-stability="beta">
<div class="metric_name">scheduler_plugin_evaluation_total</div>
<div class="metric_help">Number of attempts to schedule pods by each plugin and the extension point (available only in PreFilter, Filter, PreScore, and Score).</div>
<ul>
<li><label class="metric_detail">Stability Level:</label><span class="metric_stability_level">BETA</span></li>
<li data-type="counter"><label class="metric_detail">Type:</label> <span class="metric_type">Counter</span></li>
<li class="metric_labels_varying"><label class="metric_detail">Labels:</label><span class="metric_label">extension_point</span><span class="metric_label">plugin</span><span class="metric_label">profile</span></li><li class="metric_component_endpoints"><label class="metric_detail">Components:</label><ul><li>kube-scheduler (/metrics)</li></ul></li></ul>
</div><div class="metric" data-stability="beta">
<div class="metric_name">scheduler_pod_scheduling_sli_duration_seconds</div>
<div class="metric_help">E2e latency for a pod being scheduled, from the time the pod enters the scheduling queue and might involve multiple scheduling attempts.</div>
<ul>
@ -494,6 +599,13 @@ Beta metrics observe a looser API contract than its stable counterparts. No labe
<li data-type="histogram"><label class="metric_detail">Type:</label> <span class="metric_type">Histogram</span></li>
<li class="metric_labels_varying"><label class="metric_detail">Labels:</label><span class="metric_label">attempts</span></li><li class="metric_component_endpoints"><label class="metric_detail">Components:</label><ul><li>kube-scheduler (/metrics)</li></ul></li></ul>
</div><div class="metric" data-stability="beta">
<div class="metric_name">scheduler_unschedulable_pods</div>
<div class="metric_help">The number of unschedulable pods broken down by plugin name. A pod will increment the gauge for all plugins that caused it to not schedule and so this metric have meaning only when broken down by plugin.</div>
<ul>
<li><label class="metric_detail">Stability Level:</label><span class="metric_stability_level">BETA</span></li>
<li data-type="gauge"><label class="metric_detail">Type:</label> <span class="metric_type">Gauge</span></li>
<li class="metric_labels_varying"><label class="metric_detail">Labels:</label><span class="metric_label">plugin</span><span class="metric_label">profile</span></li><li class="metric_component_endpoints"><label class="metric_detail">Components:</label><ul><li>kube-scheduler (/metrics)</li></ul></li></ul>
</div><div class="metric" data-stability="beta">
<div class="metric_name">workqueue_adds_total</div>
<div class="metric_help">Total number of adds handled by workqueue</div>
<ul>
@ -1222,6 +1334,34 @@ Alpha metrics do not have any API guarantees. These metrics must be used at your
<li data-type="histogram"><label class="metric_detail">Type:</label> <span class="metric_type">Histogram</span></li>
<li class="metric_labels_varying"><label class="metric_detail">Labels:</label><span class="metric_label">flow_schema</span><span class="metric_label">priority_level</span></li><li class="metric_component_endpoints"><label class="metric_detail">Components:</label><ul><li>kube-apiserver (/metrics)</li></ul></li></ul>
</div><div class="metric" data-stability="alpha">
<div class="metric_name">apiserver_impersonation_attempts_duration_seconds</div>
<div class="metric_help">Latency of impersonation attempts in seconds split by mode and decision.</div>
<ul>
<li><label class="metric_detail">Stability Level:</label><span class="metric_stability_level">ALPHA</span></li>
<li data-type="histogram"><label class="metric_detail">Type:</label> <span class="metric_type">Histogram</span></li>
<li class="metric_labels_varying"><label class="metric_detail">Labels:</label><span class="metric_label">decision</span><span class="metric_label">mode</span></li><li class="metric_component_endpoints"><label class="metric_detail">Components:</label><ul><li>kube-apiserver (/metrics)</li></ul></li></ul>
</div><div class="metric" data-stability="alpha">
<div class="metric_name">apiserver_impersonation_attempts_total</div>
<div class="metric_help">Total number of impersonation attempts split by mode and decision.</div>
<ul>
<li><label class="metric_detail">Stability Level:</label><span class="metric_stability_level">ALPHA</span></li>
<li data-type="counter"><label class="metric_detail">Type:</label> <span class="metric_type">Counter</span></li>
<li class="metric_labels_varying"><label class="metric_detail">Labels:</label><span class="metric_label">decision</span><span class="metric_label">mode</span></li><li class="metric_component_endpoints"><label class="metric_detail">Components:</label><ul><li>kube-apiserver (/metrics)</li></ul></li></ul>
</div><div class="metric" data-stability="alpha">
<div class="metric_name">apiserver_impersonation_authorization_attempts_duration_seconds</div>
<div class="metric_help">Latency of authorization checks made by the impersonation handler in seconds split by mode and decision.</div>
<ul>
<li><label class="metric_detail">Stability Level:</label><span class="metric_stability_level">ALPHA</span></li>
<li data-type="histogram"><label class="metric_detail">Type:</label> <span class="metric_type">Histogram</span></li>
<li class="metric_labels_varying"><label class="metric_detail">Labels:</label><span class="metric_label">decision</span><span class="metric_label">mode</span></li><li class="metric_component_endpoints"><label class="metric_detail">Components:</label><ul><li>kube-apiserver (/metrics)</li></ul></li></ul>
</div><div class="metric" data-stability="alpha">
<div class="metric_name">apiserver_impersonation_authorization_attempts_total</div>
<div class="metric_help">Total number of authorization checks made by the impersonation handler split by mode and decision.</div>
<ul>
<li><label class="metric_detail">Stability Level:</label><span class="metric_stability_level">ALPHA</span></li>
<li data-type="counter"><label class="metric_detail">Type:</label> <span class="metric_type">Counter</span></li>
<li class="metric_labels_varying"><label class="metric_detail">Labels:</label><span class="metric_label">decision</span><span class="metric_label">mode</span></li><li class="metric_component_endpoints"><label class="metric_detail">Components:</label><ul><li>kube-apiserver (/metrics)</li></ul></li></ul>
</div><div class="metric" data-stability="alpha">
<div class="metric_name">apiserver_init_events_total</div>
<div class="metric_help">Counter of init events processed in watch cache broken by resource type.</div>
<ul>
@ -1243,6 +1383,27 @@ Alpha metrics do not have any API guarantees. These metrics must be used at your
<li data-type="counter"><label class="metric_detail">Type:</label> <span class="metric_type">Counter</span></li>
<li class="metric_component_endpoints"><label class="metric_detail">Components:</label><ul><li>kube-apiserver (/metrics)</li></ul></li></ul>
</div><div class="metric" data-stability="alpha">
<div class="metric_name">apiserver_manifest_admission_config_controller_automatic_reload_last_timestamp_seconds</div>
<div class="metric_help">Timestamp of the last automatic reload of admission manifest configuration split by status, plugin, and apiserver identity.</div>
<ul>
<li><label class="metric_detail">Stability Level:</label><span class="metric_stability_level">ALPHA</span></li>
<li data-type="gauge"><label class="metric_detail">Type:</label> <span class="metric_type">Gauge</span></li>
<li class="metric_labels_varying"><label class="metric_detail">Labels:</label><span class="metric_label">apiserver_id_hash</span><span class="metric_label">plugin</span><span class="metric_label">status</span></li><li class="metric_component_endpoints"><label class="metric_detail">Components:</label><ul><li>kube-apiserver (/metrics)</li></ul></li></ul>
</div><div class="metric" data-stability="alpha">
<div class="metric_name">apiserver_manifest_admission_config_controller_automatic_reloads_total</div>
<div class="metric_help">Total number of automatic reloads of admission manifest configuration split by status, plugin, and apiserver identity.</div>
<ul>
<li><label class="metric_detail">Stability Level:</label><span class="metric_stability_level">ALPHA</span></li>
<li data-type="counter"><label class="metric_detail">Type:</label> <span class="metric_type">Counter</span></li>
<li class="metric_labels_varying"><label class="metric_detail">Labels:</label><span class="metric_label">apiserver_id_hash</span><span class="metric_label">plugin</span><span class="metric_label">status</span></li><li class="metric_component_endpoints"><label class="metric_detail">Components:</label><ul><li>kube-apiserver (/metrics)</li></ul></li></ul>
</div><div class="metric" data-stability="alpha">
<div class="metric_name">apiserver_manifest_admission_config_controller_last_config_info</div>
<div class="metric_help">Information about the last applied admission manifest configuration with hash as label, split by plugin and apiserver identity.</div>
<ul>
<li><label class="metric_detail">Stability Level:</label><span class="metric_stability_level">ALPHA</span></li>
<li data-type="custom"><label class="metric_detail">Type:</label> <span class="metric_type">Custom</span></li>
<li class="metric_labels_varying"><label class="metric_detail">Labels:</label><span class="metric_label">plugin</span><span class="metric_label">apiserver_id_hash</span><span class="metric_label">hash</span></li><li class="metric_component_endpoints"><label class="metric_detail">Components:</label><ul><li>kube-apiserver (/metrics)</li></ul></li></ul>
</div><div class="metric" data-stability="alpha">
<div class="metric_name">apiserver_mutating_admission_policy_check_duration_seconds</div>
<div class="metric_help">Mutation admission latency for individual mutation expressions in seconds, labeled by policy and binding.</div>
<ul>
@ -1531,7 +1692,7 @@ Alpha metrics do not have any API guarantees. These metrics must be used at your
<li class="metric_labels_varying"><label class="metric_detail">Labels:</label><span class="metric_label">group</span><span class="metric_label">resource</span></li><li class="metric_component_endpoints"><label class="metric_detail">Components:</label><ul><li>kube-apiserver (/metrics)</li></ul></li></ul>
</div><div class="metric" data-stability="alpha">
<div class="metric_name">apiserver_watch_cache_resource_version</div>
<div class="metric_help">Current resource version of watch cache broken by resource type.</div>
<div class="metric_help">Current resource version of watch cache broken by resource type. This is truncated to the 15 least significant digits.</div>
<ul>
<li><label class="metric_detail">Stability Level:</label><span class="metric_stability_level">ALPHA</span></li>
<li data-type="gauge"><label class="metric_detail">Type:</label> <span class="metric_type">Gauge</span></li>
@ -1551,6 +1712,20 @@ Alpha metrics do not have any API guarantees. These metrics must be used at your
<li data-type="counter"><label class="metric_detail">Type:</label> <span class="metric_type">Counter</span></li>
<li class="metric_labels_varying"><label class="metric_detail">Labels:</label><span class="metric_label">group</span><span class="metric_label">resource</span><span class="metric_label">version</span></li><li class="metric_component_endpoints"><label class="metric_detail">Components:</label><ul><li>kube-apiserver (/metrics)</li></ul></li></ul>
</div><div class="metric" data-stability="alpha">
<div class="metric_name">apiserver_watch_filtered_events_total</div>
<div class="metric_help">Counter of events filtered out by shard selector during watch dispatch, broken by resource type.</div>
<ul>
<li><label class="metric_detail">Stability Level:</label><span class="metric_stability_level">ALPHA</span></li>
<li data-type="counter"><label class="metric_detail">Type:</label> <span class="metric_type">Counter</span></li>
<li class="metric_labels_varying"><label class="metric_detail">Labels:</label><span class="metric_label">group</span><span class="metric_label">resource</span></li><li class="metric_component_endpoints"><label class="metric_detail">Components:</label><ul><li>kube-apiserver (/metrics)</li></ul></li></ul>
</div><div class="metric" data-stability="alpha">
<div class="metric_name">apiserver_watch_shards_total</div>
<div class="metric_help">Number of active sharded watch connections broken by resource type.</div>
<ul>
<li><label class="metric_detail">Stability Level:</label><span class="metric_stability_level">ALPHA</span></li>
<li data-type="gauge"><label class="metric_detail">Type:</label> <span class="metric_type">Gauge</span></li>
<li class="metric_labels_varying"><label class="metric_detail">Labels:</label><span class="metric_label">group</span><span class="metric_label">resource</span></li><li class="metric_component_endpoints"><label class="metric_detail">Components:</label><ul><li>kube-apiserver (/metrics)</li></ul></li></ul>
</div><div class="metric" data-stability="alpha">
<div class="metric_name">apiserver_webhooks_x509_insecure_sha1_total</div>
<div class="metric_help">Counts the number of requests to servers with insecure SHA1 signatures in their serving certificate OR the number of connection failures due to the insecure SHA1 signatures (either/or, based on the runtime environment)</div>
<ul>
@ -1565,6 +1740,13 @@ Alpha metrics do not have any API guarantees. These metrics must be used at your
<li data-type="counter"><label class="metric_detail">Type:</label> <span class="metric_type">Counter</span></li>
<li class="metric_component_endpoints"><label class="metric_detail">Components:</label><ul><li>kube-apiserver (/metrics)</li></ul></li></ul>
</div><div class="metric" data-stability="alpha">
<div class="metric_name">apiserver_websocket_streaming_requests_total</div>
<div class="metric_help">Total number of WebSocket streaming requests (exec/attach/portforward) routed by the API server, labeled by subresource and proxy_type. proxy_type is proxied_to_kubelet when the kubelet handles the request directly; otherwise translated_at_apiserver.</div>
<ul>
<li><label class="metric_detail">Stability Level:</label><span class="metric_stability_level">ALPHA</span></li>
<li data-type="counter"><label class="metric_detail">Type:</label> <span class="metric_type">Counter</span></li>
<li class="metric_labels_varying"><label class="metric_detail">Labels:</label><span class="metric_label">proxy_type</span><span class="metric_label">subresource</span></li><li class="metric_component_endpoints"><label class="metric_detail">Components:</label><ul><li>kube-apiserver (/metrics)</li></ul></li></ul>
</div><div class="metric" data-stability="alpha">
<div class="metric_name">attach_detach_controller_attachdetach_controller_forced_detaches</div>
<div class="metric_help">Number of times the A/D Controller performed a forced detach</div>
<ul>
@ -1740,34 +1922,6 @@ Alpha metrics do not have any API guarantees. These metrics must be used at your
<li data-type="counter"><label class="metric_detail">Type:</label> <span class="metric_type">Counter</span></li>
<li class="metric_labels_varying"><label class="metric_detail">Labels:</label><span class="metric_label">operation</span></li><li class="metric_component_endpoints"><label class="metric_detail">Components:</label><ul><li>kube-controller-manager (/metrics)</li></ul></li></ul>
</div><div class="metric" data-stability="alpha">
<div class="metric_name">endpoint_slice_controller_desired_endpoint_slices</div>
<div class="metric_help">Number of EndpointSlices that would exist with perfect endpoint allocation</div>
<ul>
<li><label class="metric_detail">Stability Level:</label><span class="metric_stability_level">ALPHA</span></li>
<li data-type="gauge"><label class="metric_detail">Type:</label> <span class="metric_type">Gauge</span></li>
<li class="metric_component_endpoints"><label class="metric_detail">Components:</label><ul><li>kube-controller-manager (/metrics)</li></ul></li></ul>
</div><div class="metric" data-stability="alpha">
<div class="metric_name">endpoint_slice_controller_endpoints_added_per_sync</div>
<div class="metric_help">Number of endpoints added on each Service sync</div>
<ul>
<li><label class="metric_detail">Stability Level:</label><span class="metric_stability_level">ALPHA</span></li>
<li data-type="histogram"><label class="metric_detail">Type:</label> <span class="metric_type">Histogram</span></li>
<li class="metric_component_endpoints"><label class="metric_detail">Components:</label><ul><li>kube-controller-manager (/metrics)</li></ul></li></ul>
</div><div class="metric" data-stability="alpha">
<div class="metric_name">endpoint_slice_controller_endpoints_desired</div>
<div class="metric_help">Number of endpoints desired</div>
<ul>
<li><label class="metric_detail">Stability Level:</label><span class="metric_stability_level">ALPHA</span></li>
<li data-type="gauge"><label class="metric_detail">Type:</label> <span class="metric_type">Gauge</span></li>
<li class="metric_component_endpoints"><label class="metric_detail">Components:</label><ul><li>kube-controller-manager (/metrics)</li></ul></li></ul>
</div><div class="metric" data-stability="alpha">
<div class="metric_name">endpoint_slice_controller_endpoints_removed_per_sync</div>
<div class="metric_help">Number of endpoints removed on each Service sync</div>
<ul>
<li><label class="metric_detail">Stability Level:</label><span class="metric_stability_level">ALPHA</span></li>
<li data-type="histogram"><label class="metric_detail">Type:</label> <span class="metric_type">Histogram</span></li>
<li class="metric_component_endpoints"><label class="metric_detail">Components:</label><ul><li>kube-controller-manager (/metrics)</li></ul></li></ul>
</div><div class="metric" data-stability="alpha">
<div class="metric_name">endpoint_slice_controller_endpointslices_changed_per_sync</div>
<div class="metric_help">Number of EndpointSlices changed on each Service sync</div>
<ul>
@ -1775,20 +1929,6 @@ Alpha metrics do not have any API guarantees. These metrics must be used at your
<li data-type="histogram"><label class="metric_detail">Type:</label> <span class="metric_type">Histogram</span></li>
<li class="metric_labels_varying"><label class="metric_detail">Labels:</label><span class="metric_label">topology</span><span class="metric_label">traffic_distribution</span></li><li class="metric_component_endpoints"><label class="metric_detail">Components:</label><ul><li>kube-controller-manager (/metrics)</li></ul></li></ul>
</div><div class="metric" data-stability="alpha">
<div class="metric_name">endpoint_slice_controller_num_endpoint_slices</div>
<div class="metric_help">Number of EndpointSlices</div>
<ul>
<li><label class="metric_detail">Stability Level:</label><span class="metric_stability_level">ALPHA</span></li>
<li data-type="gauge"><label class="metric_detail">Type:</label> <span class="metric_type">Gauge</span></li>
<li class="metric_component_endpoints"><label class="metric_detail">Components:</label><ul><li>kube-controller-manager (/metrics)</li></ul></li></ul>
</div><div class="metric" data-stability="alpha">
<div class="metric_name">endpoint_slice_controller_services_count_by_traffic_distribution</div>
<div class="metric_help">Number of Services using some specific trafficDistribution</div>
<ul>
<li><label class="metric_detail">Stability Level:</label><span class="metric_stability_level">ALPHA</span></li>
<li data-type="gauge"><label class="metric_detail">Type:</label> <span class="metric_type">Gauge</span></li>
<li class="metric_labels_varying"><label class="metric_detail">Labels:</label><span class="metric_label">traffic_distribution</span></li><li class="metric_component_endpoints"><label class="metric_detail">Components:</label><ul><li>kube-controller-manager (/metrics)</li></ul></li></ul>
</div><div class="metric" data-stability="alpha">
<div class="metric_name">endpoint_slice_controller_syncs</div>
<div class="metric_help">Number of EndpointSlice syncs</div>
<ul>
@ -1957,20 +2097,6 @@ Alpha metrics do not have any API guarantees. These metrics must be used at your
<li data-type="gauge"><label class="metric_detail">Type:</label> <span class="metric_type">Gauge</span></li>
<li class="metric_labels_varying"><label class="metric_detail">Labels:</label><span class="metric_label">hpa_name</span><span class="metric_label">namespace</span></li><li class="metric_component_endpoints"><label class="metric_detail">Components:</label><ul><li>kube-controller-manager (/metrics)</li></ul></li></ul>
</div><div class="metric" data-stability="alpha">
<div class="metric_name">horizontal_pod_autoscaler_controller_metric_computation_duration_seconds</div>
<div class="metric_help">The time(seconds) that the HPA controller takes to calculate one metric. The label 'action' should be either 'scale_down', 'scale_up', or 'none'. The label 'error' should be either 'spec', 'internal', or 'none'. The label 'metric_type' corresponds to HPA.spec.metrics[*].type</div>
<ul>
<li><label class="metric_detail">Stability Level:</label><span class="metric_stability_level">ALPHA</span></li>
<li data-type="histogram"><label class="metric_detail">Type:</label> <span class="metric_type">Histogram</span></li>
<li class="metric_labels_varying"><label class="metric_detail">Labels:</label><span class="metric_label">action</span><span class="metric_label">error</span><span class="metric_label">metric_type</span></li><li class="metric_component_endpoints"><label class="metric_detail">Components:</label><ul><li>kube-controller-manager (/metrics)</li></ul></li></ul>
</div><div class="metric" data-stability="alpha">
<div class="metric_name">horizontal_pod_autoscaler_controller_metric_computation_total</div>
<div class="metric_help">Number of metric computations. The label 'action' should be either 'scale_down', 'scale_up', or 'none'. Also, the label 'error' should be either 'spec', 'internal', or 'none'. The label 'metric_type' corresponds to HPA.spec.metrics[*].type</div>
<ul>
<li><label class="metric_detail">Stability Level:</label><span class="metric_stability_level">ALPHA</span></li>
<li data-type="counter"><label class="metric_detail">Type:</label> <span class="metric_type">Counter</span></li>
<li class="metric_labels_varying"><label class="metric_detail">Labels:</label><span class="metric_label">action</span><span class="metric_label">error</span><span class="metric_label">metric_type</span></li><li class="metric_component_endpoints"><label class="metric_detail">Components:</label><ul><li>kube-controller-manager (/metrics)</li></ul></li></ul>
</div><div class="metric" data-stability="alpha">
<div class="metric_name">horizontal_pod_autoscaler_controller_num_horizontal_pod_autoscalers</div>
<div class="metric_help">Current number of controlled HPA objects.</div>
<ul>
@ -1978,20 +2104,6 @@ Alpha metrics do not have any API guarantees. These metrics must be used at your
<li data-type="gauge"><label class="metric_detail">Type:</label> <span class="metric_type">Gauge</span></li>
<li class="metric_component_endpoints"><label class="metric_detail">Components:</label><ul><li>kube-controller-manager (/metrics)</li></ul></li></ul>
</div><div class="metric" data-stability="alpha">
<div class="metric_name">horizontal_pod_autoscaler_controller_reconciliation_duration_seconds</div>
<div class="metric_help">The time(seconds) that the HPA controller takes to reconcile once. The label 'action' should be either 'scale_down', 'scale_up', or 'none'. Also, the label 'error' should be either 'spec', 'internal', or 'none'. Note that if both spec and internal errors happen during a reconciliation, the first one to occur is reported in `error` label.</div>
<ul>
<li><label class="metric_detail">Stability Level:</label><span class="metric_stability_level">ALPHA</span></li>
<li data-type="histogram"><label class="metric_detail">Type:</label> <span class="metric_type">Histogram</span></li>
<li class="metric_labels_varying"><label class="metric_detail">Labels:</label><span class="metric_label">action</span><span class="metric_label">error</span></li><li class="metric_component_endpoints"><label class="metric_detail">Components:</label><ul><li>kube-controller-manager (/metrics)</li></ul></li></ul>
</div><div class="metric" data-stability="alpha">
<div class="metric_name">horizontal_pod_autoscaler_controller_reconciliations_total</div>
<div class="metric_help">Number of reconciliations of HPA controller. The label 'action' should be either 'scale_down', 'scale_up', or 'none'. Also, the label 'error' should be either 'spec', 'internal', or 'none'. Note that if both spec and internal errors happen during a reconciliation, the first one to occur is reported in `error` label.</div>
<ul>
<li><label class="metric_detail">Stability Level:</label><span class="metric_stability_level">ALPHA</span></li>
<li data-type="counter"><label class="metric_detail">Type:</label> <span class="metric_type">Counter</span></li>
<li class="metric_labels_varying"><label class="metric_detail">Labels:</label><span class="metric_label">action</span><span class="metric_label">error</span></li><li class="metric_component_endpoints"><label class="metric_detail">Components:</label><ul><li>kube-controller-manager (/metrics)</li></ul></li></ul>
</div><div class="metric" data-stability="alpha">
<div class="metric_name">informer_processing_latency_seconds</div>
<div class="metric_help">Time taken to process events after popping from the queue.</div>
<ul>
@ -2006,6 +2118,13 @@ Alpha metrics do not have any API guarantees. These metrics must be used at your
<li data-type="gauge"><label class="metric_detail">Type:</label> <span class="metric_type">Gauge</span></li>
<li class="metric_labels_varying"><label class="metric_detail">Labels:</label><span class="metric_label">group</span><span class="metric_label">name</span><span class="metric_label">resource</span><span class="metric_label">version</span></li><li class="metric_component_endpoints"><label class="metric_detail">Components:</label><ul><li>cloud-controller-manager (/metrics)</li><li>kube-apiserver (/metrics)</li><li>kube-controller-manager (/metrics)</li><li>kube-proxy (/metrics)</li><li>kube-scheduler (/metrics)</li><li>kubelet (/metrics)</li></ul></li></ul>
</div><div class="metric" data-stability="alpha">
<div class="metric_name">informer_store_resource_version</div>
<div class="metric_help">The 15 least significant digits of the resource version of the store.</div>
<ul>
<li><label class="metric_detail">Stability Level:</label><span class="metric_stability_level">ALPHA</span></li>
<li data-type="gauge"><label class="metric_detail">Type:</label> <span class="metric_type">Gauge</span></li>
<li class="metric_labels_varying"><label class="metric_detail">Labels:</label><span class="metric_label">group</span><span class="metric_label">name</span><span class="metric_label">resource</span><span class="metric_label">version</span></li><li class="metric_component_endpoints"><label class="metric_detail">Components:</label><ul><li>cloud-controller-manager (/metrics)</li><li>kube-apiserver (/metrics)</li><li>kube-controller-manager (/metrics)</li><li>kube-proxy (/metrics)</li><li>kube-scheduler (/metrics)</li><li>kubelet (/metrics)</li></ul></li></ul>
</div><div class="metric" data-stability="alpha">
<div class="metric_name">job_controller_job_finished_indexes_total</div>
<div class="metric_help">`The number of finished indexes. Possible values for the, status label are: "succeeded", "failed". Possible values for the, backoffLimit label are: "perIndex" and "global"`</div>
<ul>
@ -2027,13 +2146,6 @@ Alpha metrics do not have any API guarantees. These metrics must be used at your
<li data-type="counter"><label class="metric_detail">Type:</label> <span class="metric_type">Counter</span></li>
<li class="metric_labels_varying"><label class="metric_detail">Labels:</label><span class="metric_label">controller_name</span></li><li class="metric_component_endpoints"><label class="metric_detail">Components:</label><ul><li>kube-controller-manager (/metrics)</li></ul></li></ul>
</div><div class="metric" data-stability="alpha">
<div class="metric_name">job_controller_pod_failures_handled_by_failure_policy_total</div>
<div class="metric_help">`The number of failed Pods handled by failure policy with, respect to the failure policy action applied based on the matched, rule. Possible values of the action label correspond to the, possible values for the failure policy rule action, which are:, "FailJob", "Ignore" and "Count".`</div>
<ul>
<li><label class="metric_detail">Stability Level:</label><span class="metric_stability_level">ALPHA</span></li>
<li data-type="counter"><label class="metric_detail">Type:</label> <span class="metric_type">Counter</span></li>
<li class="metric_labels_varying"><label class="metric_detail">Labels:</label><span class="metric_label">action</span></li><li class="metric_component_endpoints"><label class="metric_detail">Components:</label><ul><li>kube-controller-manager (/metrics)</li></ul></li></ul>
</div><div class="metric" data-stability="alpha">
<div class="metric_name">job_controller_stale_sync_skips_total</div>
<div class="metric_help">Total number of Job syncs skipped due to a stale watch cache.</div>
<ul>
@ -2041,13 +2153,6 @@ Alpha metrics do not have any API guarantees. These metrics must be used at your
<li data-type="counter"><label class="metric_detail">Type:</label> <span class="metric_type">Counter</span></li>
<li class="metric_labels_varying"><label class="metric_detail">Labels:</label><span class="metric_label">group</span><span class="metric_label">resource</span></li><li class="metric_component_endpoints"><label class="metric_detail">Components:</label><ul><li>kube-controller-manager (/metrics)</li></ul></li></ul>
</div><div class="metric" data-stability="alpha">
<div class="metric_name">job_controller_terminated_pods_tracking_finalizer_total</div>
<div class="metric_help">`The number of terminated pods (phase=Failed|Succeeded), that have the finalizer batch.kubernetes.io/job-tracking, The event label can be "add" or "delete".`</div>
<ul>
<li><label class="metric_detail">Stability Level:</label><span class="metric_stability_level">ALPHA</span></li>
<li data-type="counter"><label class="metric_detail">Type:</label> <span class="metric_type">Counter</span></li>
<li class="metric_labels_varying"><label class="metric_detail">Labels:</label><span class="metric_label">event</span></li><li class="metric_component_endpoints"><label class="metric_detail">Components:</label><ul><li>kube-controller-manager (/metrics)</li></ul></li></ul>
</div><div class="metric" data-stability="alpha">
<div class="metric_name">kube_apiserver_clusterip_allocator_allocated_ips</div>
<div class="metric_help">Gauge measuring the number of allocated IPs for Services</div>
<ul>
@ -2468,6 +2573,20 @@ Alpha metrics do not have any API guarantees. These metrics must be used at your
<li data-type="counter"><label class="metric_detail">Type:</label> <span class="metric_type">Counter</span></li>
<li class="metric_component_endpoints"><label class="metric_detail">Components:</label><ul><li>kubelet (/metrics)</li></ul></li></ul>
</div><div class="metric" data-stability="alpha">
<div class="metric_name">kubelet_memory_qos_node_memory_low_bytes</div>
<div class="metric_help">Total cgroup v2 memory.low in bytes for Burstable pods. This memory is soft-reserved and may be reclaimed under extreme pressure.</div>
<ul>
<li><label class="metric_detail">Stability Level:</label><span class="metric_stability_level">ALPHA</span></li>
<li data-type="gauge"><label class="metric_detail">Type:</label> <span class="metric_type">Gauge</span></li>
<li class="metric_component_endpoints"><label class="metric_detail">Components:</label><ul><li>kubelet (/metrics)</li></ul></li></ul>
</div><div class="metric" data-stability="alpha">
<div class="metric_name">kubelet_memory_qos_node_memory_min_bytes</div>
<div class="metric_help">Total cgroup v2 memory.min in bytes for Guaranteed pods. This memory is hard-reserved and never reclaimed by the kernel.</div>
<ul>
<li><label class="metric_detail">Stability Level:</label><span class="metric_stability_level">ALPHA</span></li>
<li data-type="gauge"><label class="metric_detail">Type:</label> <span class="metric_type">Gauge</span></li>
<li class="metric_component_endpoints"><label class="metric_detail">Components:</label><ul><li>kubelet (/metrics)</li></ul></li></ul>
</div><div class="metric" data-stability="alpha">
<div class="metric_name">kubelet_metrics_provider</div>
<div class="metric_help">Metrics provider used by kubelet to collect container stats. Values can be 'cadvisor' and 'cri'</div>
<ul>
@ -2559,6 +2678,13 @@ Alpha metrics do not have any API guarantees. These metrics must be used at your
<li data-type="gauge"><label class="metric_detail">Type:</label> <span class="metric_type">Gauge</span></li>
<li class="metric_component_endpoints"><label class="metric_detail">Components:</label><ul><li>kubelet (/metrics)</li></ul></li></ul>
</div><div class="metric" data-stability="alpha">
<div class="metric_name">kubelet_pleg_pod_relist_duration_seconds</div>
<div class="metric_help">Duration in seconds for relisting a single pod in PLEG.</div>
<ul>
<li><label class="metric_detail">Stability Level:</label><span class="metric_stability_level">ALPHA</span></li>
<li data-type="histogram"><label class="metric_detail">Type:</label> <span class="metric_type">Histogram</span></li>
<li class="metric_component_endpoints"><label class="metric_detail">Components:</label><ul><li>kubelet (/metrics)</li></ul></li></ul>
</div><div class="metric" data-stability="alpha">
<div class="metric_name">kubelet_pleg_relist_duration_seconds</div>
<div class="metric_help">Duration in seconds for relisting pods in PLEG.</div>
<ul>
@ -2685,6 +2811,13 @@ Alpha metrics do not have any API guarantees. These metrics must be used at your
<li data-type="histogram"><label class="metric_detail">Type:</label> <span class="metric_type">Histogram</span></li>
<li class="metric_component_endpoints"><label class="metric_detail">Components:</label><ul><li>kubelet (/metrics)</li></ul></li></ul>
</div><div class="metric" data-stability="alpha">
<div class="metric_name">kubelet_pod_watch_events_dropped_total</div>
<div class="metric_help">Cumulative number of pod watch events dropped.</div>
<ul>
<li><label class="metric_detail">Stability Level:</label><span class="metric_stability_level">ALPHA</span></li>
<li data-type="counter"><label class="metric_detail">Type:</label> <span class="metric_type">Counter</span></li>
<li class="metric_component_endpoints"><label class="metric_detail">Components:</label><ul><li>kubelet (/metrics)</li></ul></li></ul>
</div><div class="metric" data-stability="alpha">
<div class="metric_name">kubelet_pod_worker_duration_seconds</div>
<div class="metric_help">Duration in seconds to sync a single pod. Broken down by operation type: create, update, or sync</div>
<ul>
@ -2839,6 +2972,13 @@ Alpha metrics do not have any API guarantees. These metrics must be used at your
<li data-type="counter"><label class="metric_detail">Type:</label> <span class="metric_type">Counter</span></li>
<li class="metric_component_endpoints"><label class="metric_detail">Components:</label><ul><li>kubelet (/metrics)</li></ul></li></ul>
</div><div class="metric" data-stability="alpha">
<div class="metric_name">kubelet_terminated_containers_total</div>
<div class="metric_help">Cumulative number of container terminations.</div>
<ul>
<li><label class="metric_detail">Stability Level:</label><span class="metric_stability_level">ALPHA</span></li>
<li data-type="counter"><label class="metric_detail">Type:</label> <span class="metric_type">Counter</span></li>
<li class="metric_labels_varying"><label class="metric_detail">Labels:</label><span class="metric_label">container_type</span><span class="metric_label">exit_code</span><span class="metric_label">reason</span></li><li class="metric_component_endpoints"><label class="metric_detail">Components:</label><ul><li>kubelet (/metrics)</li></ul></li></ul>
</div><div class="metric" data-stability="alpha">
<div class="metric_name">kubelet_topology_manager_admission_duration_ms</div>
<div class="metric_help">Duration in milliseconds to serve a pod admission request.</div>
<ul>
@ -2916,6 +3056,13 @@ Alpha metrics do not have any API guarantees. These metrics must be used at your
<li data-type="custom"><label class="metric_detail">Type:</label> <span class="metric_type">Custom</span></li>
<li class="metric_labels_varying"><label class="metric_detail">Labels:</label><span class="metric_label">namespace</span><span class="metric_label">persistentvolumeclaim</span></li><li class="metric_component_endpoints"><label class="metric_detail">Components:</label><ul><li>kubelet (/metrics)</li></ul></li></ul>
</div><div class="metric" data-stability="alpha">
<div class="metric_name">kubelet_websocket_streaming_requests_total</div>
<div class="metric_help">Total number of WebSocket streaming requests (exec/attach/portforward) received by the kubelet.</div>
<ul>
<li><label class="metric_detail">Stability Level:</label><span class="metric_stability_level">ALPHA</span></li>
<li data-type="counter"><label class="metric_detail">Type:</label> <span class="metric_type">Counter</span></li>
<li class="metric_labels_varying"><label class="metric_detail">Labels:</label><span class="metric_label">subresource</span></li><li class="metric_component_endpoints"><label class="metric_detail">Components:</label><ul><li>kubelet (/metrics)</li></ul></li></ul>
</div><div class="metric" data-stability="alpha">
<div class="metric_name">kubelet_working_pods</div>
<div class="metric_help">Number of pods the kubelet is actually running, broken down by lifecycle phase, whether the pod is desired, orphaned, or runtime only (also orphaned), and whether the pod is static. An orphaned pod has been removed from local configuration or force deleted in the API and consumes resources that are not otherwise visible.</div>
<ul>
@ -3315,6 +3462,27 @@ Alpha metrics do not have any API guarantees. These metrics must be used at your
<li data-type="counter"><label class="metric_detail">Type:</label> <span class="metric_type">Counter</span></li>
<li class="metric_labels_varying"><label class="metric_detail">Labels:</label><span class="metric_label">group</span><span class="metric_label">resource</span></li><li class="metric_component_endpoints"><label class="metric_detail">Components:</label><ul><li>kube-controller-manager (/metrics)</li></ul></li></ul>
</div><div class="metric" data-stability="alpha">
<div class="metric_name">resource_manager_allocation_errors_total</div>
<div class="metric_help">Number of errors encountered during exclusive resource allocation.</div>
<ul>
<li><label class="metric_detail">Stability Level:</label><span class="metric_stability_level">ALPHA</span></li>
<li data-type="counter"><label class="metric_detail">Type:</label> <span class="metric_type">Counter</span></li>
<li class="metric_labels_varying"><label class="metric_detail">Labels:</label><span class="metric_label">resource_name</span><span class="metric_label">source</span></li><li class="metric_component_endpoints"><label class="metric_detail">Components:</label><ul><li>kubelet (/metrics)</li></ul></li></ul>
</div><div class="metric" data-stability="alpha">
<div class="metric_name">resource_manager_allocations_total</div>
<div class="metric_help">Number of exclusive resource allocations performed by a resource manager.</div>
<ul>
<li><label class="metric_detail">Stability Level:</label><span class="metric_stability_level">ALPHA</span></li>
<li data-type="counter"><label class="metric_detail">Type:</label> <span class="metric_type">Counter</span></li>
<li class="metric_labels_varying"><label class="metric_detail">Labels:</label><span class="metric_label">resource_name</span><span class="metric_label">source</span></li><li class="metric_component_endpoints"><label class="metric_detail">Components:</label><ul><li>kubelet (/metrics)</li></ul></li></ul>
</div><div class="metric" data-stability="alpha">
<div class="metric_name">resource_manager_container_assignments</div>
<div class="metric_help">Number of containers with a specific type of resource assignment.</div>
<ul>
<li><label class="metric_detail">Stability Level:</label><span class="metric_stability_level">ALPHA</span></li>
<li data-type="counter"><label class="metric_detail">Type:</label> <span class="metric_type">Counter</span></li>
<li class="metric_labels_varying"><label class="metric_detail">Labels:</label><span class="metric_label">assignment_type</span><span class="metric_label">resource_name</span></li><li class="metric_component_endpoints"><label class="metric_detail">Components:</label><ul><li>kubelet (/metrics)</li></ul></li></ul>
</div><div class="metric" data-stability="alpha">
<div class="metric_name">resourceclaim_controller_creates_total</div>
<div class="metric_help">Number of ResourceClaims creation requests, categorized by creation status and admin access</div>
<ul>
@ -3329,6 +3497,27 @@ Alpha metrics do not have any API guarantees. These metrics must be used at your
<li data-type="custom"><label class="metric_detail">Type:</label> <span class="metric_type">Custom</span></li>
<li class="metric_labels_varying"><label class="metric_detail">Labels:</label><span class="metric_label">allocated</span><span class="metric_label">admin_access</span><span class="metric_label">source</span></li><li class="metric_component_endpoints"><label class="metric_detail">Components:</label><ul><li>kube-controller-manager (/metrics)</li></ul></li></ul>
</div><div class="metric" data-stability="alpha">
<div class="metric_name">resourcepoolstatusrequest_controller_request_processing_duration_seconds</div>
<div class="metric_help">Time taken to process a ResourcePoolStatusRequest</div>
<ul>
<li><label class="metric_detail">Stability Level:</label><span class="metric_stability_level">ALPHA</span></li>
<li data-type="histogram"><label class="metric_detail">Type:</label> <span class="metric_type">Histogram</span></li>
<li class="metric_labels_varying"><label class="metric_detail">Labels:</label><span class="metric_label">driver_name</span></li><li class="metric_component_endpoints"><label class="metric_detail">Components:</label><ul><li>kube-controller-manager (/metrics)</li></ul></li></ul>
</div><div class="metric" data-stability="alpha">
<div class="metric_name">resourcepoolstatusrequest_controller_request_processing_errors_total</div>
<div class="metric_help">Total number of errors encountered while processing ResourcePoolStatusRequests</div>
<ul>
<li><label class="metric_detail">Stability Level:</label><span class="metric_stability_level">ALPHA</span></li>
<li data-type="counter"><label class="metric_detail">Type:</label> <span class="metric_type">Counter</span></li>
<li class="metric_labels_varying"><label class="metric_detail">Labels:</label><span class="metric_label">driver_name</span></li><li class="metric_component_endpoints"><label class="metric_detail">Components:</label><ul><li>kube-controller-manager (/metrics)</li></ul></li></ul>
</div><div class="metric" data-stability="alpha">
<div class="metric_name">resourcepoolstatusrequest_controller_requests_processed_total</div>
<div class="metric_help">Total number of ResourcePoolStatusRequests processed</div>
<ul>
<li><label class="metric_detail">Stability Level:</label><span class="metric_stability_level">ALPHA</span></li>
<li data-type="counter"><label class="metric_detail">Type:</label> <span class="metric_type">Counter</span></li>
<li class="metric_labels_varying"><label class="metric_detail">Labels:</label><span class="metric_label">driver_name</span></li><li class="metric_component_endpoints"><label class="metric_detail">Components:</label><ul><li>kube-controller-manager (/metrics)</li></ul></li></ul>
</div><div class="metric" data-stability="alpha">
<div class="metric_name">rest_client_dns_resolution_duration_seconds</div>
<div class="metric_help">DNS resolver latency in seconds. Broken down by host.</div>
<ul>
@ -3406,6 +3595,13 @@ Alpha metrics do not have any API guarantees. These metrics must be used at your
<li data-type="histogram"><label class="metric_detail">Type:</label> <span class="metric_type">Histogram</span></li>
<li class="metric_labels_varying"><label class="metric_detail">Labels:</label><span class="metric_label">host</span><span class="metric_label">verb</span></li><li class="metric_component_endpoints"><label class="metric_detail">Components:</label><ul><li>cloud-controller-manager (/metrics)</li><li>kube-apiserver (/metrics)</li><li>kube-controller-manager (/metrics)</li><li>kube-proxy (/metrics)</li><li>kube-scheduler (/metrics)</li><li>kubelet (/metrics)</li></ul></li></ul>
</div><div class="metric" data-stability="alpha">
<div class="metric_name">rest_client_transport_ca_reload_total</div>
<div class="metric_help">Number of times a CA reload is attempted, partitioned by the result and reason for the reload attempt</div>
<ul>
<li><label class="metric_detail">Stability Level:</label><span class="metric_stability_level">ALPHA</span></li>
<li data-type="counter"><label class="metric_detail">Type:</label> <span class="metric_type">Counter</span></li>
<li class="metric_labels_varying"><label class="metric_detail">Labels:</label><span class="metric_label">reason</span><span class="metric_label">result</span></li><li class="metric_component_endpoints"><label class="metric_detail">Components:</label><ul><li>cloud-controller-manager (/metrics)</li><li>kube-apiserver (/metrics)</li><li>kube-controller-manager (/metrics)</li><li>kube-proxy (/metrics)</li><li>kube-scheduler (/metrics)</li><li>kubelet (/metrics)</li></ul></li></ul>
</div><div class="metric" data-stability="alpha">
<div class="metric_name">rest_client_transport_cache_entries</div>
<div class="metric_help">Number of transport entries in the internal cache.</div>
<ul>
@ -3413,8 +3609,22 @@ Alpha metrics do not have any API guarantees. These metrics must be used at your
<li data-type="gauge"><label class="metric_detail">Type:</label> <span class="metric_type">Gauge</span></li>
<li class="metric_component_endpoints"><label class="metric_detail">Components:</label><ul><li>cloud-controller-manager (/metrics)</li><li>kube-apiserver (/metrics)</li><li>kube-controller-manager (/metrics)</li><li>kube-proxy (/metrics)</li><li>kube-scheduler (/metrics)</li><li>kubelet (/metrics)</li></ul></li></ul>
</div><div class="metric" data-stability="alpha">
<div class="metric_name">rest_client_transport_cache_gc_calls_total</div>
<div class="metric_help">Number of times a GC cleanup attempts to delete a transport cache entry, partitioned by the result: deleted, skipped</div>
<ul>
<li><label class="metric_detail">Stability Level:</label><span class="metric_stability_level">ALPHA</span></li>
<li data-type="counter"><label class="metric_detail">Type:</label> <span class="metric_type">Counter</span></li>
<li class="metric_labels_varying"><label class="metric_detail">Labels:</label><span class="metric_label">result</span></li><li class="metric_component_endpoints"><label class="metric_detail">Components:</label><ul><li>cloud-controller-manager (/metrics)</li><li>kube-apiserver (/metrics)</li><li>kube-controller-manager (/metrics)</li><li>kube-proxy (/metrics)</li><li>kube-scheduler (/metrics)</li><li>kubelet (/metrics)</li></ul></li></ul>
</div><div class="metric" data-stability="alpha">
<div class="metric_name">rest_client_transport_cert_rotation_gc_calls_total</div>
<div class="metric_help">Number of times a cert rotation goroutine cancel func is called via GC cleanup of the associated transport</div>
<ul>
<li><label class="metric_detail">Stability Level:</label><span class="metric_stability_level">ALPHA</span></li>
<li data-type="counter"><label class="metric_detail">Type:</label> <span class="metric_type">Counter</span></li>
<li class="metric_component_endpoints"><label class="metric_detail">Components:</label><ul><li>cloud-controller-manager (/metrics)</li><li>kube-apiserver (/metrics)</li><li>kube-controller-manager (/metrics)</li><li>kube-proxy (/metrics)</li><li>kube-scheduler (/metrics)</li><li>kubelet (/metrics)</li></ul></li></ul>
</div><div class="metric" data-stability="alpha">
<div class="metric_name">rest_client_transport_create_calls_total</div>
<div class="metric_help">Number of calls to get a new transport, partitioned by the result of the operation hit: obtained from the cache, miss: created and added to the cache, uncacheable: created and not cached</div>
<div class="metric_help">Number of calls to get a new transport, partitioned by the result of the operation hit: obtained from the cache, miss: created and added to the cache, miss-gc: recreated and added back to the cache after being garbage collected, uncacheable: created and not cached</div>
<ul>
<li><label class="metric_detail">Stability Level:</label><span class="metric_stability_level">ALPHA</span></li>
<li data-type="counter"><label class="metric_detail">Type:</label> <span class="metric_type">Counter</span></li>
@ -3490,6 +3700,20 @@ Alpha metrics do not have any API guarantees. These metrics must be used at your
<li data-type="gauge"><label class="metric_detail">Type:</label> <span class="metric_type">Gauge</span></li>
<li class="metric_labels_varying"><label class="metric_detail">Labels:</label><span class="metric_label">type</span></li><li class="metric_component_endpoints"><label class="metric_detail">Components:</label><ul><li>kube-scheduler (/metrics)</li></ul></li></ul>
</div><div class="metric" data-stability="alpha">
<div class="metric_name">scheduler_dra_bindingconditions_allocations_total</div>
<div class="metric_help">Number of allocations using devices with BindingConditions, counted per driver per scheduling attempt</div>
<ul>
<li><label class="metric_detail">Stability Level:</label><span class="metric_stability_level">ALPHA</span></li>
<li data-type="counter"><label class="metric_detail">Type:</label> <span class="metric_type">Counter</span></li>
<li class="metric_labels_varying"><label class="metric_detail">Labels:</label><span class="metric_label">driver</span><span class="metric_label">profile</span><span class="metric_label">status</span></li><li class="metric_component_endpoints"><label class="metric_detail">Components:</label><ul><li>kube-scheduler (/metrics)</li></ul></li></ul>
</div><div class="metric" data-stability="alpha">
<div class="metric_name">scheduler_dra_bindingconditions_wait_duration_seconds</div>
<div class="metric_help">Time in seconds spent waiting for BindingConditions to be satisfied during PreBind.</div>
<ul>
<li><label class="metric_detail">Stability Level:</label><span class="metric_stability_level">ALPHA</span></li>
<li data-type="histogram"><label class="metric_detail">Type:</label> <span class="metric_type">Histogram</span></li>
<li class="metric_labels_varying"><label class="metric_detail">Labels:</label><span class="metric_label">driver</span><span class="metric_label">profile</span><span class="metric_label">status</span></li><li class="metric_component_endpoints"><label class="metric_detail">Components:</label><ul><li>kube-scheduler (/metrics)</li></ul></li></ul>
</div><div class="metric" data-stability="alpha">
<div class="metric_name">scheduler_event_handling_duration_seconds</div>
<div class="metric_help">Event handling latency in seconds.</div>
<ul>
@ -3504,13 +3728,6 @@ Alpha metrics do not have any API guarantees. These metrics must be used at your
<li data-type="histogram"><label class="metric_detail">Type:</label> <span class="metric_type">Histogram</span></li>
<li class="metric_labels_varying"><label class="metric_detail">Labels:</label><span class="metric_label">hinted</span><span class="metric_label">profile</span></li><li class="metric_component_endpoints"><label class="metric_detail">Components:</label><ul><li>kube-scheduler (/metrics)</li></ul></li></ul>
</div><div class="metric" data-stability="alpha">
<div class="metric_name">scheduler_goroutines</div>
<div class="metric_help">Number of running goroutines split by the work they do such as binding.</div>
<ul>
<li><label class="metric_detail">Stability Level:</label><span class="metric_stability_level">ALPHA</span></li>
<li data-type="gauge"><label class="metric_detail">Type:</label> <span class="metric_type">Gauge</span></li>
<li class="metric_labels_varying"><label class="metric_detail">Labels:</label><span class="metric_label">operation</span></li><li class="metric_component_endpoints"><label class="metric_detail">Components:</label><ul><li>kube-scheduler (/metrics)</li></ul></li></ul>
</div><div class="metric" data-stability="alpha">
<div class="metric_name">scheduler_inflight_events</div>
<div class="metric_help">Number of events currently tracked in the scheduling queue.</div>
<ul>
@ -3525,20 +3742,6 @@ Alpha metrics do not have any API guarantees. These metrics must be used at your
<li data-type="gauge"><label class="metric_detail">Type:</label> <span class="metric_type">Gauge</span></li>
<li class="metric_labels_varying"><label class="metric_detail">Labels:</label><span class="metric_label">call_type</span></li><li class="metric_component_endpoints"><label class="metric_detail">Components:</label><ul><li>kube-scheduler (/metrics)</li></ul></li></ul>
</div><div class="metric" data-stability="alpha">
<div class="metric_name">scheduler_permit_wait_duration_seconds</div>
<div class="metric_help">Duration of waiting on permit.</div>
<ul>
<li><label class="metric_detail">Stability Level:</label><span class="metric_stability_level">ALPHA</span></li>
<li data-type="histogram"><label class="metric_detail">Type:</label> <span class="metric_type">Histogram</span></li>
<li class="metric_labels_varying"><label class="metric_detail">Labels:</label><span class="metric_label">result</span></li><li class="metric_component_endpoints"><label class="metric_detail">Components:</label><ul><li>kube-scheduler (/metrics)</li></ul></li></ul>
</div><div class="metric" data-stability="alpha">
<div class="metric_name">scheduler_plugin_evaluation_total</div>
<div class="metric_help">Number of attempts to schedule pods by each plugin and the extension point (available only in PreFilter, Filter, PreScore, and Score).</div>
<ul>
<li><label class="metric_detail">Stability Level:</label><span class="metric_stability_level">ALPHA</span></li>
<li data-type="counter"><label class="metric_detail">Type:</label> <span class="metric_type">Counter</span></li>
<li class="metric_labels_varying"><label class="metric_detail">Labels:</label><span class="metric_label">extension_point</span><span class="metric_label">plugin</span><span class="metric_label">profile</span></li><li class="metric_component_endpoints"><label class="metric_detail">Components:</label><ul><li>kube-scheduler (/metrics)</li></ul></li></ul>
</div><div class="metric" data-stability="alpha">
<div class="metric_name">scheduler_plugin_execution_duration_seconds</div>
<div class="metric_help">Duration for running a plugin at a specific extension point.</div>
<ul>
@ -3616,13 +3819,6 @@ Alpha metrics do not have any API guarantees. These metrics must be used at your
<li data-type="histogram"><label class="metric_detail">Type:</label> <span class="metric_type">Histogram</span></li>
<li class="metric_labels_varying"><label class="metric_detail">Labels:</label><span class="metric_label">profile</span></li><li class="metric_component_endpoints"><label class="metric_detail">Components:</label><ul><li>kube-scheduler (/metrics)</li></ul></li></ul>
</div><div class="metric" data-stability="alpha">
<div class="metric_name">scheduler_unschedulable_pods</div>
<div class="metric_help">The number of unschedulable pods broken down by plugin name. A pod will increment the gauge for all plugins that caused it to not schedule and so this metric have meaning only when broken down by plugin.</div>
<ul>
<li><label class="metric_detail">Stability Level:</label><span class="metric_stability_level">ALPHA</span></li>
<li data-type="gauge"><label class="metric_detail">Type:</label> <span class="metric_type">Gauge</span></li>
<li class="metric_labels_varying"><label class="metric_detail">Labels:</label><span class="metric_label">plugin</span><span class="metric_label">profile</span></li><li class="metric_component_endpoints"><label class="metric_detail">Components:</label><ul><li>kube-scheduler (/metrics)</li></ul></li></ul>
</div><div class="metric" data-stability="alpha">
<div class="metric_name">scheduler_volume_binder_cache_requests_total</div>
<div class="metric_help">Total number for request volume binding cache</div>
<ul>
@ -3840,13 +4036,20 @@ Alpha metrics do not have any API guarantees. These metrics must be used at your
<li data-type="custom"><label class="metric_detail">Type:</label> <span class="metric_type">Custom</span></li>
<li class="metric_labels_varying"><label class="metric_detail">Labels:</label><span class="metric_label">plugin_name</span><span class="metric_label">state</span></li><li class="metric_component_endpoints"><label class="metric_detail">Components:</label><ul><li>kubelet (/metrics)</li></ul></li></ul>
</div><div class="metric" data-stability="alpha">
<div class="metric_name">volume_operation_total_errors</div>
<div class="metric_name">volume_operation_errors_total</div>
<div class="metric_help">Total volume operation errors</div>
<ul>
<li><label class="metric_detail">Stability Level:</label><span class="metric_stability_level">ALPHA</span></li>
<li data-type="counter"><label class="metric_detail">Type:</label> <span class="metric_type">Counter</span></li>
<li class="metric_labels_varying"><label class="metric_detail">Labels:</label><span class="metric_label">operation_name</span><span class="metric_label">plugin_name</span></li><li class="metric_component_endpoints"><label class="metric_detail">Components:</label><ul><li>kube-controller-manager (/metrics)</li></ul></li></ul>
</div><div class="metric" data-stability="alpha">
<div class="metric_name">volume_operation_total_errors</div>
<div class="metric_help">Total volume operation errors</div>
<ul>
<li><label class="metric_detail">Stability Level:</label><span class="metric_stability_level">ALPHA</span></li>
<li data-type="counter"><label class="metric_detail">Type:</label> <span class="metric_type">Counter</span></li>
<li class="metric_labels_varying"><label class="metric_detail">Labels:</label><span class="metric_label">operation_name</span><span class="metric_label">plugin_name</span></li><li class="metric_component_endpoints"><label class="metric_detail">Components:</label><ul><li>kube-controller-manager (/metrics)</li></ul></li><li class="metric_deprecated_version"><label class="metric_detail">Deprecated Versions:</label><span>1.36.0</span></li></ul>
</div><div class="metric" data-stability="alpha">
<div class="metric_name">volume_operation_total_seconds</div>
<div class="metric_help">Storage operation end to end duration in seconds</div>
<ul>

8
hack/tools/instrumentation/main.go
View file

@ -112,7 +112,13 @@ func main() {
for scanner.Scan() {
arg := scanner.Text()
ms, es := searchPathForStableMetrics(arg, endpointConfig)
stableMetrics = append(stableMetrics, ms...)
for _, m := range ms {
fqName := m.BuildFQName()
if _, ok := stableMetricNames[fqName]; !ok {
stableMetrics = append(stableMetrics, m)
}
stableMetricNames[fqName] = struct{}{}
}
errors = append(errors, es...)
}
}

95
hack/tools/instrumentation/stability-utils.sh
View file

@ -31,6 +31,7 @@ stability_check_setup() {
GOTOOLCHAIN="$(kube::golang::hack_tools_gotoolchain)" go -C "${KUBE_ROOT}/hack/tools/instrumentation" install . ./sort ./documentation
}
# shellcheck disable=SC2120
function find_files_to_check() {
# Similar to find but faster and easier to understand. We want to include
# modified and untracked files because this might be running against code
@ -43,12 +44,15 @@ function find_files_to_check() {
':!:*/third_party/*' `# catches third_party/...` \
':!:hack/*' `# catches hack/...` \
':!:*/hack/*' `# catches any subdir/hack/...` \
':!:test/*' `# catches test/...` \
':!:*/test/*' `# catches any subdir/test/...` \
':!:*/*_test.go' \
':!:hack/tools/instrumentation' \
':(glob)**/*.go' \
"$@"
}
# shellcheck disable=SC2120
function find_test_files() {
git ls-files -cmo --exclude-standard \
"$@"
@ -61,23 +65,15 @@ reset=$(tput sgr0)
function kube::validate::stablemetrics() {
stability_check_setup
temp_file=$(mktemp)
temp_file2=$(mktemp)
doValidate=$(find_files_to_check -z \
| sort -z \
| KUBE_ROOT=${KUBE_ROOT} xargs -0 -L 200 \
"${GOBIN}/instrumentation" \
find_files_to_check \
| KUBE_ROOT=${KUBE_ROOT} "${GOBIN}/instrumentation" \
-- \
1>"${temp_file}")
- \
1>"${temp_file}"
if $doValidate; then
echo -e "${green}Diffing hack/tools/instrumentation/testdata/stable-metrics-list.yaml\n${reset}"
fi
doSort=$(KUBE_ROOT=${KUBE_ROOT} "${GOBIN}/sort" --sort-file="${temp_file}" 1>"${temp_file2}")
if ! $doSort; then
echo "${red}!!! sorting metrics has failed! ${reset}" >&2
exit 1
fi
if diff -u "$KUBE_ROOT/hack/tools/instrumentation/testdata/stable-metrics-list.yaml" "$temp_file2"; then
echo -e "${green}Diffing hack/tools/instrumentation/testdata/stable-metrics-list.yaml\n${reset}"
if diff -u "$KUBE_ROOT/hack/tools/instrumentation/testdata/stable-metrics-list.yaml" "$temp_file"; then
echo -e "${green}\nPASS metrics stability verification ${reset}"
return 0
fi
@ -90,19 +86,17 @@ function kube::validate::test::stablemetrics() {
stability_check_setup
temp_file=$(mktemp)
cd "${KUBE_ROOT}/hack/tools/instrumentation"
doValidate=$(find_test_files -z \
| sort -z \
| KUBE_ROOT=${KUBE_ROOT} xargs -0 -L 200 \
"${GOBIN}/instrumentation" \
find_test_files \
| KUBE_ROOT=${KUBE_ROOT} "${GOBIN}/instrumentation" \
-- \
1>"${temp_file}")
- \
1>"${temp_file}"
if $doValidate; then
echo -e "${green}Diffing hack/tools/instrumentation/testdata/test-stable-metrics-list.yaml\n${reset}"
if diff -u "$KUBE_ROOT/hack/tools/instrumentation/testdata/test-stable-metrics-list.yaml" "$temp_file"; then
echo -e "${green}\nPASS metrics stability verification ${reset}"
return 0
fi
echo -e "${green}Diffing hack/tools/instrumentation/testdata/test-stable-metrics-list.yaml\n${reset}"
if diff -u "$KUBE_ROOT/hack/tools/instrumentation/testdata/test-stable-metrics-list.yaml" "$temp_file"; then
echo -e "${green}\nPASS metrics stability verification ${reset}"
return 0
fi
echo "${red}!!! Metrics stability static analysis test has failed!${reset}" >&2
@ -113,44 +107,29 @@ function kube::validate::test::stablemetrics() {
function kube::update::stablemetrics() {
stability_check_setup
temp_file=$(mktemp)
temp_file2=$(mktemp)
doCheckStability=$(find_files_to_check -z \
| sort -z \
| KUBE_ROOT=${KUBE_ROOT} xargs -0 -L 200 \
"${GOBIN}/instrumentation" \
find_files_to_check \
| KUBE_ROOT=${KUBE_ROOT} "${GOBIN}/instrumentation" \
-- \
1>"${temp_file}")
- \
1>"${temp_file}"
if ! $doCheckStability; then
echo "${red}!!! updating golden list of metrics has failed! ${reset}" >&2
exit 1
fi
mv -f "$temp_file" "${KUBE_ROOT}/hack/tools/instrumentation/testdata/stable-metrics-list.yaml"
doSort=$("${GOBIN}/sort" --sort-file="${KUBE_ROOT}/hack/tools/instrumentation/testdata/stable-metrics-list.yaml" 1>"${temp_file2}")
if ! $doSort; then
echo "${red}!!! sorting metrics has failed! ${reset}" >&2
exit 1
fi
mv -f "$temp_file2" "${KUBE_ROOT}/hack/tools/instrumentation/testdata/stable-metrics-list.yaml"
echo "${green}Updated golden list of stable metrics.${reset}"
}
function kube::update::documentation::list() {
stability_check_setup
temp_file=$(mktemp)
doCheckStability=$(find_files_to_check -z \
| sort -z \
| KUBE_ROOT=${KUBE_ROOT} xargs -0 -L 200 \
"${GOBIN}/instrumentation" \
find_files_to_check \
| KUBE_ROOT=${KUBE_ROOT} "${GOBIN}/instrumentation" \
--allstabilityclasses \
--endpoint-mappings="hack/tools/instrumentation/endpoint-mappings.yaml" \
-- \
1>"${temp_file}")
- \
1>"${temp_file}"
if ! $doCheckStability; then
echo "${red}!!! updating golden list of metrics has failed! ${reset}" >&2
exit 1
fi
mv -f "$temp_file" "${KUBE_ROOT}/hack/tools/instrumentation/documentation/documentation-list.yaml"
echo "${green}Updated list of metrics for documentation ${reset}"
}
@ -173,17 +152,13 @@ function kube::update::test::stablemetrics() {
stability_check_setup
temp_file=$(mktemp)
cd "${KUBE_ROOT}/hack/tools/instrumentation"
doCheckStability=$(find_test_files -z \
| sort -z \
| KUBE_ROOT=${KUBE_ROOT} xargs -0 -L 200 \
"${GOBIN}/instrumentation" \
find_test_files \
| KUBE_ROOT=${KUBE_ROOT} "${GOBIN}/instrumentation" \
-- \
1>"${temp_file}")
- \
1>"${temp_file}"
if ! $doCheckStability; then
echo "${red}!!! updating golden list of test metrics has failed! ${reset}" >&2
exit 1
fi
mv -f "$temp_file" "${KUBE_ROOT}/hack/tools/instrumentation/testdata/test-stable-metrics-list.yaml"
echo "${green}Updated test list of stable metrics.${reset}"
}