Skip to content

docs: add Helm configuration instructions for metrics#43481

Merged
joestringer merged 1 commit intocilium:mainfrom
suunj:docs/metrics-helm-configuration
Jan 28, 2026
Merged

docs: add Helm configuration instructions for metrics#43481
joestringer merged 1 commit intocilium:mainfrom
suunj:docs/metrics-helm-configuration

Conversation

@suunj
Copy link
Copy Markdown
Contributor

@suunj suunj commented Dec 22, 2025

Please ensure your pull request adheres to the following guidelines:

  • For first time contributors, read Submitting a pull request
  • All code is covered by unit and/or runtime tests where feasible.
  • All commits contain a well written commit description including a title,
    description and a Fixes: #XXX line if the commit addresses a particular
    GitHub issue.
  • If your commit description contains a Fixes: <commit-id> tag, then
    please add the commit author[s] as reviewer[s] to this issue.
  • All commits are signed off. See the section Developer’s Certificate of Origin
  • Provide a title or release-note blurb suitable for the release notes.
  • Are you a user of Cilium? Please add yourself to the Users doc
  • Thanks for contributing!

Fixes: #21450

Documentation: Added Helm configuration instructions for enabling and customizing metrics.

@suunj suunj requested review from a team as code owners December 22, 2025 15:18
@maintainer-s-little-helper maintainer-s-little-helper bot added the dont-merge/needs-release-note-label The author needs to describe the release impact of these changes. label Dec 22, 2025
@github-actions github-actions bot added the kind/community-contribution This was a contribution made by a community member. label Dec 22, 2025
Copy link
Copy Markdown
Member

@joestringer joestringer left a comment

Choose a reason for hiding this comment

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

Thanks for the PR!

There's already some description about how to enable or disable specific metrics in the section around line 398. However, it's focused on how to configure this with direct agent flags rather than with Helm. Perhaps instead of adding a new section that duplicates the information, you could extend that earlier section to describe how to apply the configuration with Helm (preferred) or with commandline flags?

One possible way to render this would be to use .. tabs:: syntax so there's two tabs, one for each way to configure. You can find an example of this syntax in the Documentation/installation/k8s-install-helm.rst file.

@joestringer joestringer added the release-note/misc This PR makes changes that have no direct user impact. label Jan 5, 2026
@maintainer-s-little-helper maintainer-s-little-helper bot removed the dont-merge/needs-release-note-label The author needs to describe the release impact of these changes. label Jan 5, 2026
@joestringer joestringer added the area/documentation Impacts the documentation, including textual changes, sphinx, or other doc generation code. label Jan 9, 2026
@chancez
Copy link
Copy Markdown
Contributor

chancez commented Jan 13, 2026

Thanks for the PR!

There's already some description about how to enable or disable specific metrics in the section around line 398. However, it's focused on how to configure this with direct agent flags rather than with Helm. Perhaps instead of adding a new section that duplicates the information, you could extend that earlier section to describe how to apply the configuration with Helm (preferred) or with commandline flags?

One possible way to render this would be to use .. tabs:: syntax so there's two tabs, one for each way to configure. You can find an example of this syntax in the Documentation/installation/k8s-install-helm.rst file.

I was gonna suggest at least grouping it closer to the existing docs, but I like the tabs approach.

@joestringer joestringer marked this pull request as draft January 26, 2026 17:02
@joestringer
Copy link
Copy Markdown
Member

I'll mark this as draft until you get a chance to take another look @suunj . When you'd like more feedback, please click "Ready for review" at the bottom of the page to bring it back to the attention of reviews. Thanks for your contribution :)

@suunj suunj force-pushed the docs/metrics-helm-configuration branch from 41a581c to c0fa257 Compare January 26, 2026 22:37
@maintainer-s-little-helper
Copy link
Copy Markdown

Commit c0fa257 does not match "(?m)^Signed-off-by:".

Please follow instructions provided in https://docs.cilium.io/en/stable/contributing/development/contributing_guide/#developer-s-certificate-of-origin

@maintainer-s-little-helper maintainer-s-little-helper bot added the dont-merge/needs-sign-off The author needs to add signoff to their commits before merge. label Jan 26, 2026
@suunj suunj marked this pull request as ready for review January 26, 2026 22:42
@maintainer-s-little-helper
Copy link
Copy Markdown

Commits c0fa257, 9b0ede3 do not match "(?m)^Signed-off-by:".

Please follow instructions provided in https://docs.cilium.io/en/stable/contributing/development/contributing_guide/#developer-s-certificate-of-origin

@suunj suunj force-pushed the docs/metrics-helm-configuration branch from 9b0ede3 to 0314b9d Compare January 26, 2026 23:31
@maintainer-s-little-helper maintainer-s-little-helper bot removed the dont-merge/needs-sign-off The author needs to add signoff to their commits before merge. label Jan 26, 2026
@maintainer-s-little-helper
Copy link
Copy Markdown

Commit 91c47bf does not match "(?m)^Signed-off-by:".

Please follow instructions provided in https://docs.cilium.io/en/stable/contributing/development/contributing_guide/#developer-s-certificate-of-origin

@maintainer-s-little-helper maintainer-s-little-helper bot added the dont-merge/needs-sign-off The author needs to add signoff to their commits before merge. label Jan 26, 2026
Signed-off-by: SeungJu Cheon <suunj1331@gmail.com>
@suunj suunj force-pushed the docs/metrics-helm-configuration branch from 91c47bf to 8f878ea Compare January 27, 2026 00:00
@maintainer-s-little-helper maintainer-s-little-helper bot removed the dont-merge/needs-sign-off The author needs to add signoff to their commits before merge. label Jan 27, 2026
Copy link
Copy Markdown
Member

@joestringer joestringer left a comment

Choose a reason for hiding this comment

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

The changes here look good. I think we could probably improve the overall structure a bit more to pull this up to the top of the metrics reference section rather than being under the cilium-agent configuration section. I realize (now) that each component has its own configuration sections, but the main thing that differs is just the specific configuration flag and hopefully not the syntax for these advanced map-type configurations.

Either way the change itself looks good to me via:
https://deploy-preview-43481--docs-cilium-io.netlify.app/observability/metrics#configuration

@joestringer joestringer added needs-backport/1.18 This PR / issue needs backporting to the v1.18 branch needs-backport/1.19 This PR / issue needs backporting to the v1.19 branch labels Jan 27, 2026
@joestringer
Copy link
Copy Markdown
Member

/test

@joestringer joestringer enabled auto-merge January 28, 2026 23:35
@joestringer joestringer added this pull request to the merge queue Jan 28, 2026
@joestringer
Copy link
Copy Markdown
Member

Thanks @suunj!

Merged via the queue into cilium:main with commit b76f928 Jan 28, 2026
73 checks passed
@maintainer-s-little-helper maintainer-s-little-helper bot added the ready-to-merge This PR has passed all tests and received consensus from code owners to merge. label Jan 28, 2026
@mhofstetter mhofstetter mentioned this pull request Jan 29, 2026
6 tasks
@mhofstetter mhofstetter added backport-pending/1.19 The backport for Cilium 1.19.x for this PR is in progress. and removed needs-backport/1.19 This PR / issue needs backporting to the v1.19 branch labels Jan 29, 2026
@mhofstetter mhofstetter mentioned this pull request Jan 29, 2026
6 tasks
@mhofstetter mhofstetter added backport-pending/1.18 The backport for Cilium 1.18.x for this PR is in progress. and removed needs-backport/1.18 This PR / issue needs backporting to the v1.18 branch labels Jan 29, 2026
@github-actions github-actions bot added backport-done/1.19 The backport for Cilium 1.19.x for this PR is done. backport-done/1.18 The backport for Cilium 1.18.x for this PR is done. and removed backport-pending/1.19 The backport for Cilium 1.19.x for this PR is in progress. backport-pending/1.18 The backport for Cilium 1.18.x for this PR is in progress. labels Jan 30, 2026
@cilium-release-bot cilium-release-bot bot moved this to Released in cilium v1.19.0 Feb 3, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area/documentation Impacts the documentation, including textual changes, sphinx, or other doc generation code. backport-done/1.18 The backport for Cilium 1.18.x for this PR is done. backport-done/1.19 The backport for Cilium 1.19.x for this PR is done. kind/community-contribution This was a contribution made by a community member. ready-to-merge This PR has passed all tests and received consensus from code owners to merge. release-note/misc This PR makes changes that have no direct user impact.

Projects

No open projects
Status: Released

Development

Successfully merging this pull request may close these issues.

Improve metrics docs to describe how to configure metrics using helm

4 participants