-
Notifications
You must be signed in to change notification settings - Fork 14.5k
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
logging: structured logging, klog deprecation #30505
logging: structured logging, klog deprecation #30505
Conversation
👷 Deploy Preview for kubernetes-io-vnext-staging processing. 🔨 Explore the source changes: c307316 🔍 Inspect the deploy log: https://app.netlify.com/sites/kubernetes-io-vnext-staging/deploys/6195fe8aea995c0007ff7b22 |
@@ -22,11 +22,59 @@ generates log messages for the Kubernetes system components. | |||
|
|||
For more information about klog configuration, see the [Command line tool reference](/docs/reference/command-line-tools-reference/). |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
What is the right approach for updating the command line tools reference? Manually edit the HTML table?
That needs to be part of this PR.
/hold
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
We typically update all generated docs during the release, separately from human-made PRs that accompany changes in that release.
If that's true here to, we can /unhold.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Sounds like I don't need to worry about the reference docs then.
/unhold
| Merge stderr and stdout, write to stdout | `2>&1` | `kube-log-runner` (default behavior) | | ||
| Redirect both into log file | `1>>/tmp/log 2>&1` | `kube-log-runner -log-file=/tmp/log` | | ||
| Copy into log file and to stdout | `2>&1 \| tee -a /tmp/log` | `kube-log-runner -log-file=/tmp/log -also-stdout` | | ||
| Redirect only stdout into log file | `>/tmp/log` | `kube-log-runner -log-file=/tmp/log -redirect-stderr=false` | |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
We need to check that this complex table is rendered correctly. It works in GitHub, but I am not sure about the Kubernetes HTML.
Where can I find the preview pages?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Here's the preview: https://deploy-preview-30505--kubernetes-io-vnext-staging.netlify.app/docs/concepts/cluster-administration/system-logs/#klog
(To find this: start from #30505 (comment) and click “Deploy preview”)
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Hmm, "Deploy preview" is just plain text when I look at that comment.
I see a link to the deploy log, but that also doesn't link to the preview.
Anyway, rendering looks good.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Ah sorry. It turns out that as a privileged user I get that link and other folks don't.
Not sure why (I don't see it as confidential and the URLs are predictable).
I might nudge Netlify about that if I get time. It's a busy period though!
/sig instrumentation |
/assign |
This is primarily the docs PR for - alpha: kubernetes/enhancements#2845 - beta: kubernetes/enhancements#1602 But as it touches the file, it also updates the examples and explanations to reflect some recent observations.
14ff32f
to
c307316
Compare
/assign @serathius |
LG from technical standpoint. |
LGTM label has been added. Git tree hash: 586c9a34ac508b2c948c0452d8e6bacdefd8b5bf
|
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
LGTM from SIG Docs!
/cc @jlbutler |
/assign @reylejano For approval. |
/approve |
[APPROVALNOTIFIER] This PR is APPROVED This pull-request has been approved by: jlbutler The full list of commands accepted by this bot can be found here. The pull request process is described here
Needs approval from an approver in each of these files:
Approvers can indicate their approval by writing |
This is primarily the docs PR for
But as it touches the file, it also updates the examples and explanations to
reflect some recent observations.