KEP-727keps/sig-node/727-resource-metrics-endpoint

Kubelet Resource Metrics Endpoint

implementedstablesig-nodelatest v1.29

KEP on GitHub kep.yaml Ask about this KEP

The Kubelet Resource Metrics Endpoint is a new kubelet metrics endpoint which serves metrics required by the cluster-level Resource Metrics API. The proposed design uses the prometheus text format, and provides the minimum required metrics for serving the Resource Metrics API.

Facts

Authors: @dashpole @richabanker
Approvers: @dchen1107 @brancz
Reviewers: @tallclair @directxman12
PRR approvers: @wojtek-tstable
Tracking issue: #727(opens GitHub in a new tab) closedcompletedclosed 2024-02-05 22:09 UTCsig/nodesig/instrumentationstage/stable
Milestones: alpha v1.14stable v1.29
Participating SIGs: sig-instrumentation
Feature gates: none
Created / last updated: 2019-01-24 / 2023-09-08

Who decided each state, with the evidence.
Decided	Decision	Deciders	Evidence
2020-12-17 17:41 UTC	status_transition KEP-727 status set to implementable in PR #2193, approved by johnbelamaric; merged by automation (k8s-ci-robot) on 2020-12-17.	@wojtek-t author @johnbelamaric approve_command @johnbelamaric lgtm @k8s-ci-robot merger	Commit kubernetes/enhancements@7eef794bb549a50c6b08c457556ff0eac98a4c6b(opens GitHub in a new tab) StatusChange status ∅ → implementable (2020-12-17)(opens GitHub in a new tab) PullRequest kubernetes/enhancements#2193 Migrate some node KEPs to new template(opens GitHub in a new tab) Review kubernetes/enhancements/pulls/reviews/554835705(opens GitHub in a new tab)
2021-05-05 19:23 UTC	stage_graduation KEP-727 graduated to alpha in PR #2672, approved by johnbelamaric; merged by automation (k8s-ci-robot) on 2021-05-05.	@ehashman author @johnbelamaric approve_command @johnbelamaric lgtm @k8s-ci-robot merger	Commit kubernetes/enhancements@f343d8b94f8b83e8496ae42313f1290c1767bba6(opens GitHub in a new tab) StatusChange stage ∅ → alpha (2021-05-05)(opens GitHub in a new tab) PullRequest kubernetes/enhancements#2672 Make PRR metadata required(opens GitHub in a new tab) Comment kubernetes/enhancements/issues/comments/832947166
2023-05-27 01:20 UTC	prr_approval wojtek-t gave the production readiness approval for KEP-727 at stable on 2023-05-27.	@wojtek-t prr_approver	Document 727.yaml(opens GitHub in a new tab)
2023-10-03 07:33 UTC	stage_graduation KEP-727 set milestone.alpha to v1.14 in PR #4037, approved by dchen1107; merged by automation (k8s-ci-robot) on 2023-10-03.	@wojtek-t lgtm @dchen1107 approve_command @dchen1107 lgtm @richabanker author @k8s-ci-robot merger	Commit kubernetes/enhancements@63a08bba5aee273f25d7800152edd52422b4cead(opens GitHub in a new tab) StatusChange milestone.alpha ∅ → v1.14 (2023-05-27)(opens GitHub in a new tab) PullRequest kubernetes/enhancements#4037 Update KEP for Kubelet Resource Metrics endpoint GA release(opens GitHub in a new tab) Comment kubernetes/enhancements/issues/comments/1744355078
2023-10-03 07:33 UTC	stage_graduation KEP-727 set milestone.stable to v1.29 in PR #4037, approved by dchen1107; merged by automation (k8s-ci-robot) on 2023-10-03.	@wojtek-t lgtm @dchen1107 approve_command @dchen1107 lgtm @richabanker author @k8s-ci-robot merger	Commit kubernetes/enhancements@63a08bba5aee273f25d7800152edd52422b4cead(opens GitHub in a new tab) StatusChange milestone.stable ∅ → v1.29 (2023-05-27)(opens GitHub in a new tab) PullRequest kubernetes/enhancements#4037 Update KEP for Kubelet Resource Metrics endpoint GA release(opens GitHub in a new tab) Comment kubernetes/enhancements/issues/comments/1744355078
2023-10-03 07:33 UTC	stage_graduation KEP-727 graduated to stable from alpha in PR #4037, approved by dchen1107; merged by automation (k8s-ci-robot) on 2023-10-03.	@wojtek-t lgtm @dchen1107 approve_command @dchen1107 lgtm @richabanker author @k8s-ci-robot merger	Commit kubernetes/enhancements@63a08bba5aee273f25d7800152edd52422b4cead(opens GitHub in a new tab) StatusChange stage alpha → stable (2023-05-27)(opens GitHub in a new tab) PullRequest kubernetes/enhancements#4037 Update KEP for Kubelet Resource Metrics endpoint GA release(opens GitHub in a new tab) Comment kubernetes/enhancements/issues/comments/1744355078
2024-02-05 22:08 UTC	status_transition KEP-727 status changed from implementable to implemented in PR #4388, approved by mrunalp, sergeykanzhelev, dashpole, dchen1107; merged by automation (k8s-ci-robot) on 2024-02-05.	@dchen1107 approve_command @dchen1107 lgtm @mrunalp approver @sergeykanzhelev approver @sergeykanzhelev approve_command @sergeykanzhelev lgtm @dashpole approve_command @dashpole lgtm @richabanker author @kikisdeliveryservice lgtm @k8s-ci-robot merger	Commit kubernetes/enhancements@a032105113225e6dfbf31a1b2314b9aa44149a03

Metadata, label and milestone changes, oldest first.Showing 1–10 of 70Rows

Status history
At	Kind	Field	Change	Actor	Evidence
2019-01-24 23:52 UTC	label	needs-sig added	none → needs-sig	@k8s-ci-robot	source(opens GitHub in a new tab)
2019-01-24 23:53 UTC	label	sig/node added	none → sig/node	@k8s-ci-robot	source

Relationships as stored, Person → KEP, from kep.yaml(opens GitHub in a new tab)
Person	Relationship
@dashpole GitHub(opens GitHub in a new tab)	—AUTHORED→
@richabanker GitHub(opens GitHub in a new tab)	—AUTHORED→
@tallclair GitHub(opens GitHub in a new tab)	—REVIEWS→
@directxman12

How they connect

Shortest paths in the graph between this KEP and its SIG or one of its people, up to four hops.

Impact of change

Rows returned by the tool
Kep	Depth	Reached	By hop	Open pull requests	Hop	Sigs	People
{ "label": "KEP", "key": "keps/sig-node/727-resource-metrics-endpoint", "title": "Kubelet Resource Metrics Endpoint", "url": "https://github.com/kubernetes/enhancements/tree/6ebe0a94771723b3f27cb4a757f0cc22f29e38a2/keps/sig-node/727-resource-metrics-endpoint", "evidence_id": "pesaa3oc67vy", "number": 727, "owning_sig": "sig-node", "status": "implemented", "stage": "stable", "latest_milestone": "v1.29", "milestone_alpha": "v1.14", "milestone_stable": "v1.29", "creation_date": "2019-01-24", "last_updated": "2023-09-08", "metadata_invalid": false }	2	5	{ "1": { "sigs": 1, "people": 4 } }	not in graph (merged pull requests only)	none	none	none
none	none	none	none	none	1	[ { "label": "SIG", "key": "sig-node", "title": "Node", "url": "https://github.com/kubernetes/community/tree/440e496d3a172234d81728df1bfe43849b589adf/sig-node", "evidence_id": "nrsuxu2xcxa7", "display_name": "Node", "sig_label": "node", "in_scope": true } ]	[ { "label": "Person", "key": "dashpole", "title": "dashpole", "url": "https://github.com/dashpole", "evidence_id": "uavosvxmo4c4", "login": "dashpole", "is_bot": false }, { "label": "Person", "key": "richabanker", "title": "richabanker", "url": "https://github.com/richabanker", "evidence_id": "nx5chvq4244k", "login": "richabanker", "is_bot": false }, { "label": "Person", "key": "dchen1107", "title": "dchen1107", "url": "https://github.com/dchen1107", "evidence_id": "frhgjvzxlrsh", "login": "dchen1107", "is_bot": false }, { "label": "Person", "key": "brancz", "title": "brancz", "url": "https://github.com/brancz", "evidence_id": "ettxebbdtlth", "login": "brancz", "is_bot": false } ]

Rows returned by the tool
Kep	Depth	Reached	By hop	Open pull requests	Hop	Sigs	People
{ "label": "KEP", "key": "keps/sig-node/727-resource-metrics-endpoint", "title": "Kubelet Resource Metrics Endpoint", "url": "https://github.com/kubernetes/enhancements/tree/6ebe0a94771723b3f27cb4a757f0cc22f29e38a2/keps/sig-node/727-resource-metrics-endpoint", "evidence_id": "pesaa3oc67vy", "number": 727, "owning_sig": "sig-node", "status": "implemented", "stage": "stable", "latest_milestone": "v1.29", "milestone_alpha": "v1.14", "milestone_stable": "v1.29", "creation_date": "2019-01-24", "last_updated": "2023-09-08", "metadata_invalid": false }	2	5	{ "1": { "sigs": 1, "people": 4 } }	not in graph (merged pull requests only)	none	none	none
none	none	none	none	none	1	[ { "label": "SIG", "key": "sig-node", "title": "Node", "url": "https://github.com/kubernetes/community/tree/440e496d3a172234d81728df1bfe43849b589adf/sig-node", "evidence_id": "nrsuxu2xcxa7", "display_name": "Node", "sig_label": "node", "in_scope": true } ]	[ { "label": "Person", "key": "dashpole", "title": "dashpole", "url": "https://github.com/dashpole", "evidence_id": "uavosvxmo4c4", "login": "dashpole", "is_bot": false }, { "label": "Person", "key": "richabanker", "title": "richabanker", "url": "https://github.com/richabanker", "evidence_id": "nx5chvq4244k", "login": "richabanker", "is_bot": false }, { "label": "Person", "key": "dchen1107", "title": "dchen1107", "url": "https://github.com/dchen1107", "evidence_id": "frhgjvzxlrsh", "login": "dchen1107", "is_bot": false }, { "label": "Person", "key": "brancz", "title": "brancz", "url": "https://github.com/brancz", "evidence_id": "ettxebbdtlth", "login": "brancz", "is_bot": false } ]

Kep

Depth

Reached

By hop

Open pull requests

Hop

Sigs

People

{
  "label": "KEP",
  "key": "keps/sig-node/727-resource-metrics-endpoint",
  "title": "Kubelet Resource Metrics Endpoint",
  "url": "https://github.com/kubernetes/enhancements/tree/6ebe0a94771723b3f27cb4a757f0cc22f29e38a2/keps/sig-node/727-resource-metrics-endpoint",
  "evidence_id": "pesaa3oc67vy",
  "number": 727,
  "owning_sig": "sig-node",
  "status": "implemented",
  "stage": "stable",
  "latest_milestone": "v1.29",
  "milestone_alpha": "v1.14",
  "milestone_stable": "v1.29",
  "creation_date": "2019-01-24",
  "last_updated": "2023-09-08",
  "metadata_invalid": false
}

{
  "1": {
    "sigs": 1,
    "people": 4
  }
}

not in graph (merged pull requests only)

[
  {
    "label": "SIG",
    "key": "sig-node",
    "title": "Node",
    "url": "https://github.com/kubernetes/community/tree/440e496d3a172234d81728df1bfe43849b589adf/sig-node",
    "evidence_id": "nrsuxu2xcxa7",
    "display_name": "Node",
    "sig_label": "node",
    "in_scope": true
  }
]

[
  {
    "label": "Person",
    "key": "dashpole",
    "title": "dashpole",
    "url": "https://github.com/dashpole",
    "evidence_id": "uavosvxmo4c4",
    "login": "dashpole",
    "is_bot": false
  },
  {
    "label": "Person",
    "key": "richabanker",
    "title": "richabanker",
    "url": "https://github.com/richabanker",
    "evidence_id": "nx5chvq4244k",
    "login": "richabanker",
    "is_bot": false
  },
  {
    "label": "Person",
    "key": "dchen1107",
    "title": "dchen1107",
    "url": "https://github.com/dchen1107",
    "evidence_id": "frhgjvzxlrsh",
    "login": "dchen1107",
    "is_bot": false
  },
  {
    "label": "Person",
    "key": "brancz",
    "title": "brancz",
    "url": "https://github.com/brancz",
    "evidence_id": "ettxebbdtlth",
    "login": "brancz",
    "is_bot": false
  }
]

MATCH (k:KEP {key: $key}) RETURN k LIMIT 1 ; MATCH (k:KEP {key: $key}) MATCH path = (k)-[:REPLACES|SUPERSEDED_BY|SEE_ALSO|GATED_BY*1..2]-(n) WHERE n <> k AND (n:KEP OR n:FeatureGate) AND all(x IN nodes(path)[1..-1] WHERE x <> k AND (x:KEP OR (x:FeatureGate AND NOT x.key IN $placeholders))) WITH n, path ORDER BY length(path), [x IN nodes(path) | x.key] WITH n, collect(path)[0] AS path RETURN n AS node, length(path) AS hop, path ORDER BY hop, n.key LIMIT 150 ; UNWIND $keys AS kk MATCH (k:KEP {key: kk}) RETURN k.key AS kep, [(k)-[r_0:OWNED_BY]->(s_0:SIG) WHERE coalesce(r_0.valid_to, $open) = $open | s_0] AS sigs, [(p_1:Person)-[r_1:AUTHORED]->(k) WHERE coalesce(r_1.valid_to, $open) = $open AND coalesce(p_1.is_bot, false) = false | p_1] AS authors, [(p_2:Person)-[r_2:APPROVES]->(k) WHERE coalesce(r_2.valid_to, $open) = $open AND coalesce(p_2.is_bot, false) = false | p_2] AS approvers, [(k)-[r_3:TRACKED_BY]->(i_3:Issue) WHERE coalesce(r_3.valid_to, $open) = $open AND i_3.state = 'open' | i_3] AS open_issues LIMIT 200

Kubelet Resource Metrics Endpoint

Facts

How they connect

Impact of change

Keyboard shortcuts

Everywhere

Go to a page

Ask

Search lists

KEP page

Findings table

How they connect

Impact of change

Hop 1

Impact of change

Impact of change

Hop 1