Skip to content

docs: Document helm-session HTTP header for request tracing#2052

Draft
promptless-for-oss wants to merge 1 commit intohelm:mainfrom
Promptless:promptless/document-helm-session-header
Draft

docs: Document helm-session HTTP header for request tracing#2052
promptless-for-oss wants to merge 1 commit intohelm:mainfrom
Promptless:promptless/document-helm-session-header

Conversation

@promptless-for-oss
Copy link
Copy Markdown
Contributor

Open this suggestion in Promptless to view citations and reasoning process

Adds documentation for the helm-session HTTP header feature that enables correlating multiple HTTP requests from a single Helm command execution. This is useful for auditing, debugging, and observability in repository servers and monitoring systems.

Trigger Events

helm/helm PR #31967: feat(getter): add helm-session HTTP header for traceability

Promptless Research (8 files, 1 webpage, 1 GitHub PR)

  • Reviewed helm/helm#31967
  • Viewed .long_term_context/product_knowledge/product_overview.md
  • Viewed .long_term_context/doc_workflow/client_instructions.md
  • Viewed .long_term_context/style/client_style_guide.md
  • Viewed docs/topics/advanced.mdx
  • Viewed docs/topics/registries.mdx
  • Viewed docs/chart_template_guide/debugging.md
  • Viewed docs/topics/chart_repository.md
  • Read webpage from github.com
  • Viewed versioned_docs/version-3/topics/advanced.md

Agent Response

I've created a documentation suggestion for PR #31967.

Summary of Changes:

PR #31967 introduces a helm-session HTTP header that Helm attaches to all outgoing HTTP requests. This header contains a unique UUID session ID that remains consistent across all requests made during a single Helm command execution. This enables infrastructure teams and repository administrators to correlate multiple HTTP requests for auditing, debugging, and observability purposes.

Documentation Update:

I added a new "HTTP Request Tracing" section to docs/topics/advanced.mdx that explains:

  • What the helm-session header is and how it works
  • Use cases: auditing, debugging, and observability
  • That no server-side changes are required (unknown headers are safely ignored)

Suggestion: https://app.gopromptless.ai/suggestions/c8219743-0cb5-4873-8478-347dbfdafabc

Files Modified:

  • docs/topics/advanced.mdx - Added HTTP Request Tracing section

Note: I only updated the Helm 4 docs (docs/) since this feature is being added to Helm 4's main branch (helm.sh/helm/v4), not backported to v3.


Tip: Sort by Shortest Review in the Dashboard to find quick wins ⚡

Signed-off-by: promptless-for-oss <promptless-for-oss@users.noreply.github.com>
Comment thread docs/topics/advanced.mdx
kubectl get secret --all-namespaces -l "owner=helm"
```

## HTTP Request Tracing
Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Citation: Documents the helm-session HTTP header feature added in PR #31967. The implementation in pkg/getter/httpgetter.go generates a UUID session ID per HTTPGetter instance and attaches it as the helm-session header to all outgoing HTTP requests.
View source

@TerryHowe TerryHowe added awaiting release Feature needs to be merged and released before docs update hold Do not merge yet labels Mar 26, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

awaiting release Feature needs to be merged and released before docs update hold Do not merge yet size/S

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants