Code change:
This is a Bug Report <!-- Thanks for filing an issue! Before submitting, please fill in the following information. --<!-- See for guidance on writing an actionable issue description. --<!--Required Information--Problem: documents metrics for Kubernetes v1.26 but that's incorrect because at the time I'm filing this the live documentation is for Kubernetes v1.25 Proposed Solution: Revert whichever PR bumped the document too early or do a careful partial revert that only omits the v1.26 changes Page to Update: <!--Optional Information (remove the comment tags around information you would like to include)--<!--Kubernetes Version:--Additional Information: /sig instrumentation /language en If v1.26 gets released before we fix this, it's OK to close the issue. Consider a backport to the v1.25 docs, though.
/assign
/triage accepted
/assign

Related discussion:
text: <td class="metric_type" data-type="histogram">Histogram</td> <td class="metric_description">Admission controller latency histogram in seconds, identified by name and broken out for each operation and API resource and type (validate or admit).</td> <td class="metric_labels_varying"><div class="metric_label">name</div><div class="metric_label">operation</div><div class="metric_label">rejected</div><div class="metric_label">type</div></td> <del> <td class="metric_labels_constant"></td> <td class="metric_deprecated_version"></td></tr> </del> <ins> <td class="metric_labels_constant">None</td></tr> </ins> <tr class="metric"><td class="metric_name">apiserver_admission_step_admission_duration_seconds</td> <td class="metric_stability_level" data-stability="stable">STABLE</td> <td class="metric_type" data-type="histogram">Histogram</td> <td class="metric_description">Admission sub-step latency histogram in seconds, broken out for each operation and API resource and step type (validate or admit).</td> <td class="metric_labels_varying"><div class="metric_label">operation</div><div class="metric_label">rejected</div><div class="metric_label">type</div></td> <del> <td class="metric_labels_constant"></td> <td class="metric_deprecated_version"></td></tr> </del> <ins> <td class="metric_labels_constant">None</td></tr> </ins> <tr class="metric"><td class="metric_name">apiserver_admission_webhook_admission_duration_seconds</td> <td class="metric_stability_level" data-stability="stable">STABLE</td> <td class="metric_type" data-type="histogram">Histogram</td> <td class="metric_description">Admission webhook latency histogram in seconds, identified by name and broken out for each operation and API resource and type (validate or admit).</td> <td class="metric_labels_varying"><div class="metric_label">name</div><div class="metric_label">operation</div><div class="metric_label">rejected</div><div class="metric_label">type</div></td> <del> <td class="metric_labels_constant"></td> <td class="metric_deprecated_version"></td></tr> </del> <ins> <td class="metric_labels_constant">None</td></tr> </ins> <tr class="metric"><td class="metric_name">apiserver_current_inflight_requests</td> <td class="metric_stability_level" data-stability="stable">STABLE</td> <td class="metric_type" data-type="gauge">Gauge</td> <td class="metric_description">Maximal number of currently used inflight request limit of this apiserver per request kind in last second.</td> <td class="metric_labels_varying"><div class="metric_label">request_kind</div></td> <del> <td class="metric_labels_constant"></td> <td class="metric_deprecated_version"></td></tr> </del> <ins> <td class="metric_labels_constant">None</td></tr> </ins> <tr class="metric"><td class="metric_name">apiserver_longrunning_requests</td> <td class="metric_stability_level" data-stability="stable">STABLE</td> <td class="metric_type" data-type="gauge">Gauge</td> <td class="metric_description">Gauge of all active long-running apiserver requests broken out by verb, group, version, resource, scope and component. Not all requests are tracked this way.</td> <td class="metric_labels_varying"><div class="metric_label">component</div><div class="metric_label">group</div><div class="metric_label">resource</div><div class="metric_label">scope</div><div class="metric_label">subresource</div><div class="metric_label">verb</div><div class="metric_label">version</div></td> <del> <td class="metric_labels_constant"></td> <td class="metric_deprecated_version"></td></tr> </del> <ins> <td class="metric_labels_constant">None</td></tr> </ins> <tr class="metric"><td class="metric_name">apiserver_request_duration_seconds</td> <td class="metric_stability_level" data-stability="stable">STABLE</td> <td class="metric_type" data-type="histogram">Histogram</td> <td class="metric_description">Response latency distribution in seconds for each verb, dry run value, group, version, resource, subresource, scope and component.</td> <td class="metric_labels_varying"><div class="metric_label">component</div><div class="metric_label">dry_run</div><div class="metric_label">group</div><div class="metric_label">resource</div><div class="metric_label">scope</div><div class="metric_label">subresource</div><div class="metric_label">verb</div><div class="metric_label">version</div></td> <del> <td class="metric_labels_constant"></td> <td class="metric_deprecated_version"></td></tr> </del> <ins> <td class="metric_labels_constant">None</td></tr> </ins> <tr class="metric"><td class="metric_name">apiserver_request_total</td> <td class="metric_stability_level" data-stability="stable">STABLE</td> <td class="metric_type" data-type="counter">Counter</td> <td class="metric_description">Counter of apiserver requests broken out for each verb, dry run value, group, version, resource, scope, component, and HTTP response code.</td> <td class="metric_labels_varying"><div class="metric_label">code</div><div class="metric_label">component</div><div class="metric_label">dry_run</div><div class="metric_label">group</div><div class="metric_label">resource</div><div class="metric_label">scope</div><div class="metric_label">subresource</div><div class="metric_label">verb</div><div class="metric_label">version</div></td> <del> <td class="metric_labels_constant"></td> <td class="metric_deprecated_version"></td></tr> </del> <ins> <td class="metric_labels_constant">None</td></tr> </ins> <tr class="metric"><td class="metric_name">apiserver_requested_deprecated_apis</td> <td class="metric_stability_level" data-stability="stable">STABLE</td> <td class="metric_type" data-type="gauge">Gauge</td> <td class="metric_description">Gauge of deprecated APIs that have been requested, broken out by API group, version, resource, subresource, and removed_release.</td> <td class="metric_labels_varying"><div class="metric_label">group</div><div class="metric_label">removed_release</div><div class="metric_label">resource</div><div class="metric_label">subresource</div><div class="metric_label">version</div></td> <del> <td class="metric_labels_constant"></td> <td class="metric_deprecated_version"></td></tr> </del> <ins> <td class="metric_labels_constant">None</td></tr> </ins> <tr class="metric"><td class="metric_name">apiserver_response_sizes</td> <td class="metric_stability_level" data-stability="stable">STABLE</td> <td class="metric_type" data-type="histogram">Histogram</td> <td class="metric_description">Response size distribution in bytes for each group, version, verb, resource, subresource, scope and component.</td> <td class="metric_labels_varying"><div class="metric_label">component</div><div class="metric_label">group</div><div class="metric_label">resource</div><div class="metric_label">scope</div><div class="metric_label">subresource</div><div class="metric_label">verb</div><div class="metric_label">version</div></td> <del> <td class="metric_labels_constant"></td> <td class="metric_deprecated_version"></td></tr> </del> <ins> <td class="metric_labels_constant">None</td></tr> </ins> <tr class="metric"><td class="metric_name">apiserver_storage_objects</td> <td class="metric_stability_level" data-stability="stable">STABLE</td> <td class="metric_type" data-type="gauge">Gauge</td> <td class="metric_description">Number of stored objects at the time of last check split by kind.</td> <td class="metric_labels_varying"><div class="metric_label">resource</div></td> <del> <td class="metric_labels_constant"></td> <td class="metric_deprecated_version"></td></tr> <tr class="metric"><td class="metric_name">cronjob_controller_job_creation_skew_duration_seconds</td> <td class="metric_stability_level" data-stability="stable">STABLE</td> <td class="metric_type" data-type="histogram">Histogram</td> <td class="metric_description">Time between when a cronjob is scheduled to be run, and when the corresponding job is created</td> <td class="metric_labels_varying"></td> <td class="metric_labels_constant"></td> <td class="metric_deprecated_version"></td></tr> <tr class="metric"><td class="metric_name">job_controller_job_pods_finished_total</td> <td class="metric_stability_level" data-stability="stable">STABLE</td> <td class="metric_type" data-type="counter">Counter</td> <td class="metric_description">The number of finished Pods that are fully tracked</td> <td class="metric_labels_varying"><div class="metric_label">completion_mode</div><div class="metric_label">result</div></td> <td class="metric_labels_constant"></td> <td class="metric_deprecated_version"></td></tr> <tr class="metric"><td class="metric_name">job_controller_job_sync_duration_seconds</td> <td class="metric_stability_level" data-stability="stable">STABLE</td> <td class="metric_type" data-type="histogram">Histogram</td> <td class="metric_description">The time it took to sync a job</td> <td class="metric_labels_varying"><div class="metric_label">action</div><div class="metric_label">completion_mode</div><div class="metric_label">result</div></td> <td class="metric_labels_constant"></td> <td class="metric_deprecated_version"></td></tr> <tr class="metric"><td class="metric_name">job_controller_job_syncs_total</td> <td class="metric_stability_level" data-stability="stable">STABLE</td> <td class="metric_type" data-type="counter">Counter</td> <td class="metric_description">The number of job syncs</td> <td class="metric_labels_varying"><div class="metric_label">action</div><div class="metric_label">completion_mode</div><div class="metric_label">result</div></td> <td class="metric_labels_constant"></td> <td class="metric_deprecated_version"></td></tr> <tr class="metric"><td class="metric_name">job_controller_jobs_finished_total</td> <td class="metric_stability_level" data-stability="stable">STABLE</td> <td class="metric_type" data-type="counter">Counter</td> <td class="metric_description">The number of finished jobs</td> <td class="metric_labels_varying"><div class="metric_label">completion_mode</div><div class="metric_label">reason</div><div class="metric_label">result</div></td> <td class="metric_labels_constant"></td> <td class="metric_deprecated_version"></td></tr> </del> <ins> <td class="metric_labels_constant">None</td></tr> </ins> <tr class="metric"><td class="metric_name">node_collector_evictions_total</td> <td class="metric_stability_level" data-stability="stable">STABLE</td> <td class="metric_type" data-type="counter">Counter</td> <td class="metric_description">Number of Node evictions that happened since current instance of NodeController started.</td> <td class="metric_labels_varying"><div class="metric_label">zone</div></td> <del> <td class="metric_labels_constant"></td> <td class="metric_deprecated_version"></td></tr> </del> <ins> <td class="metric_labels_constant">None</td></tr> </ins> <tr class="metric"><td class="metric_name">scheduler_framework_extension_point_duration_seconds</td> <td class="metric_stability_level" data-stability="stable">STABLE</td> <td class="metric_type" data-type="histogram">Histogram</td> <td class="metric_description">Latency for running all plugins of a specific extension point.</td> <td class="metric_labels_varying"><div class="metric_label">extension_point</div><div class="metric_label">profile</div><div class="metric_label">status</div></td> <del> <td class="metric_labels_constant"></td> <td class="metric_deprecated_version"></td></tr> </del> <ins> <td class="metric_labels_constant">None</td></tr> </ins> <tr class="metric"><td class="metric_name">scheduler_pending_pods</td> <td class="metric_stability_level" data-stability="stable">STABLE</td> <td class="metric_type" data-type="gauge">Gauge</td> <del> <td class="metric_description">Number of pending pods, by the queue type. 'active' means number of pods in activeQ; 'backoff' means number of pods in backoffQ; 'unschedulable' means number of pods in unschedulablePods that the scheduler attempted to schedule and failed; 'gated' is the number of unschedulable pods that the scheduler never attempted to schedule because they are gated.</td> </del> <ins> <td class="metric_description">Number of pending pods, by the queue type. 'active' means number of pods in activeQ; 'backoff' means number of pods in backoffQ; 'unschedulable' means number of pods in unschedulablePods.</td> </ins> <td class="metric_labels_varying"><div class="metric_label">queue</div></td> <del> <td class="metric_labels_constant"></td> <td class="metric_deprecated_version"></td></tr> </del> <ins> <td class="metric_labels_constant">None</td></tr> </ins> <tr class="metric"><td class="metric_name">scheduler_pod_scheduling_attempts</td> <td class="metric_stability_level" data-stability="stable">STABLE</td> <td class="metric_type" data-type="histogram">Histogram</td> <td class="metric_description">Number of attempts to successfully schedule a pod.</td> <del> <td class="metric_labels_varying"></td> <td class="metric_labels_constant"></td> <td class="metric_deprecated_version"></td></tr> </del> <ins> <td class="metric_labels_varying">None</td> <td class="metric_labels_constant">None</td></tr> </ins> <tr class="metric"><td class="metric_name">scheduler_pod_scheduling_duration_seconds</td> <td class="metric_stability_level" data-stability="stable">STABLE</td> <td class="metric_type" data-type="histogram">Histogram</td> <td class="metric_description">E2e latency for a pod being scheduled which may include multiple scheduling attempts.</td> <td class="metric_labels_varying"><div class="metric_label">attempts</div></td> <del> <td class="metric_labels_constant"></td> <td class="metric_deprecated_version"></td></tr> </del> <ins> <td class="metric_labels_constant">None</td></tr> </ins> <tr class="metric"><td class="metric_name">scheduler_preemption_attempts_total</td> <td class="metric_stability_level" data-stability="stable">STABLE</td> <td class="metric_type" data-type="counter">Counter</td> <td class="metric_description">Total preemption attempts in the cluster till now</td> <del> <td class="metric_labels_varying"></td> <td class="metric_labels_constant"></td> <td class="metric_deprecated_version"></td></tr> </del> <ins> <td class="metric_labels_varying">None</td> <td class="metric_labels_constant">None</td></tr> </ins> <tr class="metric"><td class="metric_name">scheduler_preemption_victims</td> <td class="metric_stability_level" data-stability="stable">STABLE</td> <td class="metric_type" data-type="histogram">Histogram</td> <td class="metric_description">Number of selected preemption victims</td> <del> <td class="metric_labels_varying"></td> <td class="metric_labels_constant"></td> <td class="metric_deprecated_version"></td></tr> </del> <ins> <td class="metric_labels_varying">None</td> <td class="metric_labels_constant">None</td></tr> </ins> <tr class="metric"><td class="metric_name">scheduler_queue_incoming_pods_total</td> <td class="metric_stability_level" data-stability="stable">STABLE</td> <td class="metric_type" data-type="counter">Counter</td> <td class="metric_description">Number of pods added to scheduling queues by event and queue type.</td> <td class="metric_labels_varying"><div class="metric_label">event</div><div class="metric_label">queue</div></td> <del> <td class="metric_labels_constant"></td> <td class="metric_deprecated_version"></td></tr> </del> <ins> <td class="metric_labels_constant">None</td></tr> </ins> <tr class="metric"><td class="metric_name">scheduler_schedule_attempts_total</td> <td class="metric_stability_level" data-stability="stable">STABLE</td> <td class="metric_type" data-type="counter">Counter</td> <td class="metric_description">Number of attempts to schedule pods, by the result. 'unschedulable' means a pod could not be scheduled, while 'error' means an internal scheduler problem.</td> <td class="metric_labels_varying"><div class="metric_label">profile</div><div class="metric_label">result</div></td> <del> <td class="metric_labels_constant"></td> <td class="metric_deprecated_version"></td></tr> </del> <ins> <td class="metric_labels_constant">None</td></tr> </ins> <tr class="metric"><td class="metric_name">scheduler_scheduling_attempt_duration_seconds</td> <td class="metric_stability_level" data-stability="stable">STABLE</td> <td class="metric_type" data-type="histogram">Histogram</td> <td class="metric_description">Scheduling attempt latency in seconds (scheduling algorithm + binding)</td> <td class="metric_labels_varying"><div class="metric_label">profile</div><div class="metric_label">result</div></td> <del> <td class="metric_labels_constant"></td> <td class="metric_deprecated_version"></td></tr> </del> <ins> <td class="metric_labels_constant">None</td></tr> </ins> </tbody> </table>