KEP-3288keps/sig-node/3288-separate-stdout-from-stderr

Split Stdout and Stderr Log Stream of Container

implementablealphasig-nodelatest v1.321 open finding

KEP on GitHub kep.yaml Ask about this KEP

Currently, kubelet actually has the potential to return certain log stream of a container, but this ability is not exposed to the user. This proposal enables users to view certain log stream of a container, and aims to extend kubelet and api-server with the ability to return certain container log stream.

Facts

Authors: @knight42
Approvers: @dchen1107
Reviewers: @mrunalp @sergeykanzhelev
PRR approvers: @deads2kalpha
Tracking issue: #3288(opens GitHub in a new tab) closednot_plannedclosed 2026-03-05 22:21 UTCsig/nodesig/api-machinerysig/clistage/alphalifecycle/rotten
Milestones: alpha v1.32beta v1.33stable v1.34
Participating SIGs: sig-cli
Feature gates: PodLogsQuerySplitStreams
Created / last updated: 2022-05-01 / none

Who decided each state, with the evidence.
Decided	Decision	Deciders	Evidence
2022-06-08 07:07 UTC	prr_approval deads2k gave the production readiness approval for KEP-3288 at alpha on 2022-06-08.	@deads2k prr_approver	Document 3288.yaml(opens GitHub in a new tab)
2022-06-15 00:15 UTC	stage_graduation KEP-3288 set milestone.alpha to v1.25 in PR #3289, approved by sergeykanzhelev, dchen1107, deads2k; merged by automation (k8s-ci-robot) on 2022-06-15.	@dchen1107 approve_command @dchen1107 lgtm @mrunalp lgtm @sergeykanzhelev approver @sergeykanzhelev lgtm @deads2k approve_command @knight42 author @k8s-ci-robot merger	Commit kubernetes/enhancements@33ff07a6c039cef7dd69eeb562aabba58497ddde(opens GitHub in a new tab) StatusChange milestone.alpha ∅ → v1.25 (2022-05-01)(opens GitHub in a new tab) PullRequest kubernetes/enhancements#3289 KEP 3288: Split stdout and stderr log stream(opens GitHub in a new tab) Review kubernetes/enhancements/pulls/reviews/1003480295(opens GitHub in a new tab) Review kubernetes/enhancements/pulls/reviews/1003196063(opens GitHub in a new tab) Review kubernetes/enhancements/pulls/reviews/995597998(opens GitHub in a new tab) Comment kubernetes/enhancements/issues/comments/1155827169
2022-06-15 00:15 UTC	stage_graduation KEP-3288 set milestone.beta to v1.26 in PR #3289, approved by sergeykanzhelev, dchen1107, deads2k; merged by automation (k8s-ci-robot) on 2022-06-15.	@dchen1107 approve_command @dchen1107 lgtm @mrunalp lgtm @sergeykanzhelev approver @sergeykanzhelev lgtm @deads2k approve_command @knight42 author @k8s-ci-robot merger	Commit kubernetes/enhancements@33ff07a6c039cef7dd69eeb562aabba58497ddde(opens GitHub in a new tab) StatusChange milestone.beta ∅ → v1.26 (2022-05-01)(opens GitHub in a new tab)
2022-06-15 00:15 UTC	stage_graduation KEP-3288 set milestone.stable to v1.27 in PR #3289, approved by sergeykanzhelev, dchen1107, deads2k; merged by automation (k8s-ci-robot) on 2022-06-15.	@dchen1107 approve_command @dchen1107 lgtm @mrunalp lgtm @sergeykanzhelev approver @sergeykanzhelev lgtm @deads2k approve_command @knight42 author @k8s-ci-robot merger	Commit kubernetes/enhancements@33ff07a6c039cef7dd69eeb562aabba58497ddde(opens GitHub in a new tab) StatusChange milestone.stable ∅ → v1.27 (2022-05-01)(opens GitHub in a new tab)
2022-06-15 00:15 UTC	stage_graduation KEP-3288 graduated to alpha in PR #3289, approved by sergeykanzhelev, dchen1107, deads2k; merged by automation (k8s-ci-robot) on 2022-06-15.	@dchen1107 lgtm @dchen1107 approve_command @mrunalp lgtm @sergeykanzhelev lgtm @sergeykanzhelev approver @deads2k approve_command @knight42 author @k8s-ci-robot merger	Commit kubernetes/enhancements@33ff07a6c039cef7dd69eeb562aabba58497ddde(opens GitHub in a new tab) StatusChange stage ∅ → alpha (2022-05-01)(opens GitHub in a new tab)
2022-06-15 00:15 UTC	status_transition KEP-3288 status set to provisional in PR #3289, approved by sergeykanzhelev, dchen1107, deads2k; merged by automation (k8s-ci-robot) on 2022-06-15.	@dchen1107 approve_command @dchen1107 lgtm @mrunalp lgtm @sergeykanzhelev approver @sergeykanzhelev lgtm @deads2k approve_command @knight42 author @k8s-ci-robot merger	Commit kubernetes/enhancements@33ff07a6c039cef7dd69eeb562aabba58497ddde(opens GitHub in a new tab) StatusChange status ∅ → provisional (2022-05-01)(opens GitHub in a new tab)
2022-06-15 00:15 UTC	status_transition KEP-3288 status changed from provisional to implementable in PR #3289, approved by sergeykanzhelev, dchen1107, deads2k; merged by automation (k8s-ci-robot) on 2022-06-15.	@dchen1107 approve_command @dchen1107 lgtm @mrunalp lgtm @sergeykanzhelev approver @sergeykanzhelev lgtm @deads2k approve_command @knight42 author @k8s-ci-robot merger	Commit kubernetes/enhancements@6d5bcaa7d0d3ab234017137bcd7c8caaac64002d(opens GitHub in a new tab) StatusChange status provisional → implementable (2022-06-08)(opens GitHub in a new tab)
2024-09-12 16:55 UTC	milestone_retarget KEP-3288 latest-milestone moved from v1.25 to v1.29 in PR #4221, approved by mrunalp, sergeykanzhelev; merged by automation (k8s-ci-robot) on 2024-09-12.	@mrunalp approver @haircommander lgtm @sergeykanzhelev approver @sergeykanzhelev approve_command @sergeykanzhelev lgtm @knight42 author @bart0sh lgtm @k8s-ci-robot merger	Commit kubernetes/enhancements@430d4e4dce6e1cb2f2c009a05a31e65439006ace(opens GitHub in a new tab) StatusChange latest_milestone v1.25 → v1.29 (2023-09-19)(opens GitHub in a new tab)
2024-09-12 16:55 UTC	milestone_retarget KEP-3288 latest-milestone moved from v1.29 to v1.32 in PR #4221, approved by mrunalp, sergeykanzhelev; merged by automation (k8s-ci-robot) on 2024-09-12.	@mrunalp approver @haircommander lgtm @sergeykanzhelev approver @sergeykanzhelev approve_command @sergeykanzhelev lgtm @knight42 author @bart0sh lgtm @k8s-ci-robot merger	Commit kubernetes/enhancements@f86e45f7f7000675be0ac605c92be9ecc5febaa8(opens GitHub in a new tab) StatusChange latest_milestone v1.29 → v1.32 (2024-09-08)(opens GitHub in a new tab)
2024-09-12 16:55 UTC	milestone_retarget KEP-3288 milestone.alpha moved from v1.25 to v1.29 in PR #4221, approved by mrunalp, sergeykanzhelev; merged by automation (k8s-ci-robot) on 2024-09-12.	@mrunalp approver @haircommander lgtm @sergeykanzhelev approver @sergeykanzhelev approve_command @sergeykanzhelev lgtm @knight42 author @bart0sh lgtm @k8s-ci-robot merger	Commit kubernetes/enhancements@430d4e4dce6e1cb2f2c009a05a31e65439006ace(opens GitHub in a new tab) StatusChange milestone.alpha v1.25 → v1.29 (2023-09-19)(opens GitHub in a new tab)
2024-09-12 16:55 UTC	milestone_retarget KEP-3288 milestone.alpha moved from v1.29 to v1.32 in PR #4221, approved by mrunalp, sergeykanzhelev; merged by automation (k8s-ci-robot) on 2024-09-12.	@mrunalp approver @haircommander lgtm @sergeykanzhelev approver @sergeykanzhelev approve_command @sergeykanzhelev lgtm @knight42 author @bart0sh lgtm @k8s-ci-robot merger	Commit kubernetes/enhancements@f86e45f7f7000675be0ac605c92be9ecc5febaa8(opens GitHub in a new tab) StatusChange milestone.alpha v1.29 → v1.32 (2024-09-08)(opens GitHub in a new tab)
2024-09-12 16:55 UTC	milestone_retarget KEP-3288 milestone.beta moved from v1.26 to v1.30 in PR #4221, approved by mrunalp, sergeykanzhelev; merged by automation (k8s-ci-robot) on 2024-09-12.	@mrunalp approver @haircommander lgtm @sergeykanzhelev approver @sergeykanzhelev approve_command @sergeykanzhelev lgtm @knight42 author @bart0sh lgtm @k8s-ci-robot merger	Commit kubernetes/enhancements@430d4e4dce6e1cb2f2c009a05a31e65439006ace(opens GitHub in a new tab) StatusChange milestone.beta v1.26 → v1.30 (2023-09-19)(opens GitHub in a new tab)
2024-09-12 16:55 UTC	milestone_retarget KEP-3288 milestone.beta moved from v1.30 to v1.33 in PR #4221, approved by mrunalp, sergeykanzhelev; merged by automation (k8s-ci-robot) on 2024-09-12.	@mrunalp approver @haircommander lgtm @sergeykanzhelev approver @sergeykanzhelev approve_command @sergeykanzhelev lgtm @knight42 author @bart0sh lgtm @k8s-ci-robot merger	Commit kubernetes/enhancements@f86e45f7f7000675be0ac605c92be9ecc5febaa8(opens GitHub in a new tab) StatusChange milestone.beta v1.30 → v1.33 (2024-09-08)(opens GitHub in a new tab)
2024-09-12 16:55 UTC	milestone_retarget KEP-3288 milestone.stable moved from v1.27 to v1.31 in PR #4221, approved by mrunalp, sergeykanzhelev; merged by automation (k8s-ci-robot) on 2024-09-12.	@mrunalp approver @haircommander lgtm @sergeykanzhelev approver @sergeykanzhelev approve_command @sergeykanzhelev lgtm @knight42 author @bart0sh lgtm @k8s-ci-robot merger	Commit kubernetes/enhancements@430d4e4dce6e1cb2f2c009a05a31e65439006ace(opens GitHub in a new tab) StatusChange milestone.stable v1.27 → v1.31 (2023-09-19)(opens GitHub in a new tab)
2024-09-12 16:55 UTC	milestone_retarget KEP-3288 milestone.stable moved from v1.31 to v1.34 in PR #4221, approved by mrunalp, sergeykanzhelev; merged by automation (k8s-ci-robot) on 2024-09-12.	@mrunalp approver @haircommander lgtm @sergeykanzhelev approver @sergeykanzhelev approve_command @sergeykanzhelev lgtm @knight42 author @bart0sh lgtm @k8s-ci-robot merger	Commit kubernetes/enhancements@f86e45f7f7000675be0ac605c92be9ecc5febaa8(opens GitHub in a new tab) StatusChange milestone.stable v1.31 → v1.34 (2024-09-08)(opens GitHub in a new tab)

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

Status history
At	Kind	Field	Change	Actor	Evidence
2022-05-01 14:03 UTC	label	needs-sig added	none → needs-sig	@k8s-ci-robot	source(opens GitHub in a new tab)
2022-05-01 14:06 UTC	label	sig/cli added	none → sig/cli	@k8s-ci-robot	source

Relationships as stored, Person → KEP, from kep.yaml(opens GitHub in a new tab)
Person	Relationship
@knight42 GitHub(opens GitHub in a new tab)	—AUTHORED→
@mrunalp GitHub(opens GitHub in a new tab)	—REVIEWS→
@sergeykanzhelev GitHub(opens GitHub in a new tab)	—REVIEWS→
@dchen1107

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	Feature gates	Sigs	People
{ "label": "KEP", "key": "keps/sig-node/3288-separate-stdout-from-stderr", "title": "Split Stdout and Stderr Log Stream of Container", "url": "https://github.com/kubernetes/enhancements/tree/6ebe0a94771723b3f27cb4a757f0cc22f29e38a2/keps/sig-node/3288-separate-stdout-from-stderr", "evidence_id": "hhtn3xeznhym", "number": 3288, "owning_sig": "sig-node", "status": "implementable", "stage": "alpha", "latest_milestone": "v1.32", "milestone_alpha": "v1.32", "milestone_beta": "v1.33", "milestone_stable": "v1.34", "creation_date": "2022-05-01", "metadata_invalid": false }	2	5	{ "1": { "feature_gates": 2, "sigs": 1, "people": 2 } }	not in graph (merged pull requests only)	none	none	none	none
none	none	none	none	none	1	[ { "label": "FeatureGate", "key": "PodLogsQuerySplitStreams", "title": "PodLogsQuerySplitStreams", "url": "https://github.com/kubernetes/enhancements/blob/6ebe0a94771723b3f27cb4a757f0cc22f29e38a2/keps/sig-node/3288-separate-stdout-from-stderr/kep.yaml", "evidence_id": "lc74oeaoh4r5", "name": "PodLogsQuerySplitStreams" }, { "label": "FeatureGate", "key": "SplitStdoutAndStderr", "title": "SplitStdoutAndStderr", "url": "https://github.com/kubernetes/enhancements/blob/33ff07a6c039cef7dd69eeb562aabba58497ddde/keps/sig-node/3288-separate-stdout-from-stderr/kep.yaml", "evidence_id": "4trwjwqvuyc3", "name": "SplitStdoutAndStderr" } ]	[ { "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": "knight42", "title": "knight42", "url": "https://github.com/knight42", "evidence_id": "24ptppu3m7kk", "login": "knight42", "is_bot": false }, { "label": "Person", "key": "dchen1107", "title": "dchen1107", "url": "https://github.com/dchen1107", "evidence_id": "frhgjvzxlrsh", "login": "dchen1107", "is_bot": false } ]

Rows returned by the tool
Kep	Depth	Reached	By hop	Open pull requests	Hop	Feature gates	Sigs	People
{ "label": "KEP", "key": "keps/sig-node/3288-separate-stdout-from-stderr", "title": "Split Stdout and Stderr Log Stream of Container", "url": "https://github.com/kubernetes/enhancements/tree/6ebe0a94771723b3f27cb4a757f0cc22f29e38a2/keps/sig-node/3288-separate-stdout-from-stderr", "evidence_id": "hhtn3xeznhym", "number": 3288, "owning_sig": "sig-node", "status": "implementable", "stage": "alpha", "latest_milestone": "v1.32", "milestone_alpha": "v1.32", "milestone_beta": "v1.33", "milestone_stable": "v1.34", "creation_date": "2022-05-01", "metadata_invalid": false }	2	5	{ "1": { "feature_gates": 2, "sigs": 1, "people": 2 } }	not in graph (merged pull requests only)	none	none	none	none
none	none	none	none	none	1	[ { "label": "FeatureGate", "key": "PodLogsQuerySplitStreams", "title": "PodLogsQuerySplitStreams", "url": "https://github.com/kubernetes/enhancements/blob/6ebe0a94771723b3f27cb4a757f0cc22f29e38a2/keps/sig-node/3288-separate-stdout-from-stderr/kep.yaml", "evidence_id": "lc74oeaoh4r5", "name": "PodLogsQuerySplitStreams" }, { "label": "FeatureGate", "key": "SplitStdoutAndStderr", "title": "SplitStdoutAndStderr", "url": "https://github.com/kubernetes/enhancements/blob/33ff07a6c039cef7dd69eeb562aabba58497ddde/keps/sig-node/3288-separate-stdout-from-stderr/kep.yaml", "evidence_id": "4trwjwqvuyc3", "name": "SplitStdoutAndStderr" } ]	[ { "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": "knight42", "title": "knight42", "url": "https://github.com/knight42", "evidence_id": "24ptppu3m7kk", "login": "knight42", "is_bot": false }, { "label": "Person", "key": "dchen1107", "title": "dchen1107", "url": "https://github.com/dchen1107", "evidence_id": "frhgjvzxlrsh", "login": "dchen1107", "is_bot": false } ]

Kep

Depth

Reached

By hop

Open pull requests

Hop

Feature gates

Sigs

People

{
  "label": "KEP",
  "key": "keps/sig-node/3288-separate-stdout-from-stderr",
  "title": "Split Stdout and Stderr Log Stream of Container",
  "url": "https://github.com/kubernetes/enhancements/tree/6ebe0a94771723b3f27cb4a757f0cc22f29e38a2/keps/sig-node/3288-separate-stdout-from-stderr",
  "evidence_id": "hhtn3xeznhym",
  "number": 3288,
  "owning_sig": "sig-node",
  "status": "implementable",
  "stage": "alpha",
  "latest_milestone": "v1.32",
  "milestone_alpha": "v1.32",
  "milestone_beta": "v1.33",
  "milestone_stable": "v1.34",
  "creation_date": "2022-05-01",
  "metadata_invalid": false
}

{
  "1": {
    "feature_gates": 2,
    "sigs": 1,
    "people": 2
  }
}

not in graph (merged pull requests only)

[
  {
    "label": "FeatureGate",
    "key": "PodLogsQuerySplitStreams",
    "title": "PodLogsQuerySplitStreams",
    "url": "https://github.com/kubernetes/enhancements/blob/6ebe0a94771723b3f27cb4a757f0cc22f29e38a2/keps/sig-node/3288-separate-stdout-from-stderr/kep.yaml",
    "evidence_id": "lc74oeaoh4r5",
    "name": "PodLogsQuerySplitStreams"
  },
  {
    "label": "FeatureGate",
    "key": "SplitStdoutAndStderr",
    "title": "SplitStdoutAndStderr",
    "url": "https://github.com/kubernetes/enhancements/blob/33ff07a6c039cef7dd69eeb562aabba58497ddde/keps/sig-node/3288-separate-stdout-from-stderr/kep.yaml",
    "evidence_id": "4trwjwqvuyc3",
    "name": "SplitStdoutAndStderr"
  }
]

[
  {
    "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": "knight42",
    "title": "knight42",
    "url": "https://github.com/knight42",
    "evidence_id": "24ptppu3m7kk",
    "login": "knight42",
    "is_bot": false
  },
  {
    "label": "Person",
    "key": "dchen1107",
    "title": "dchen1107",
    "url": "https://github.com/dchen1107",
    "evidence_id": "frhgjvzxlrsh",
    "login": "dchen1107",
    "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

Split Stdout and Stderr Log Stream of Container

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