Skip to content

Update logs-in-kubernetes docs to warn users about daemonsets #4160

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

Open
wants to merge 4 commits into
base: main
Choose a base branch
from

Conversation

dehaansa
Copy link
Contributor

@dehaansa dehaansa commented Aug 7, 2025

PR Description

Add a tip for ensuring that you use the appropriate configuration to not collect duplicate logs when deploying Alloy as a daemonset.

Which issue(s) this PR fixes

See #1185 (comment)

@dehaansa dehaansa added the type/docs Docs Squad label across all Grafana Labs repos label Aug 7, 2025
Copy link
Contributor

github-actions bot commented Aug 7, 2025

@dehaansa
Copy link
Contributor Author

dehaansa commented Aug 7, 2025

Not sure if the recommendation for docs would be stacked tips or all in one admonition, let me know.
image

@clayton-cornell
Copy link
Contributor

Not sure if the recommendation for docs would be stacked tips or all in one admonition, let me know.

Yeah... we try to avoid that wherever possible. Sometimes it's the only way to get the point across, sometimes we can rework the doc structure to combine admonitions... or write the info into body text.

There's no explicit guidance for this in the Writer's Toolkit.

In this case though, the new test addition looks more like a note to me. A tip is helpful extra info that be skipped... in this case that looks like it's important information.

@@ -166,6 +166,12 @@ Replace the following values:
You can get pods logs through the log files on each node. In this guide, you get the logs through the Kubernetes API because it doesn't require system privileges for {{< param "PRODUCT_NAME" >}}.
{{< /admonition >}}

{{< admonition type="tip" >}}
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
{{< admonition type="tip" >}}
{{< admonition type="note" >}}

I think this could be better as a note. It's not something the user can ignore/skip if they have deployed things as a daemonset.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
backport release/v1.9 backport release/v1.10 type/docs Docs Squad label across all Grafana Labs repos
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants