Skip to content

docs(apm): clarify why observed sampling rate can differ in Storage Explorer - #8102

Open
alexandra5000 wants to merge 4 commits into
elastic:mainfrom
alexandra5000:apm/storage-explorer-sampling-rate-clarification
Open

docs(apm): clarify why observed sampling rate can differ in Storage Explorer#8102
alexandra5000 wants to merge 4 commits into
elastic:mainfrom
alexandra5000:apm/storage-explorer-sampling-rate-clarification

Conversation

@alexandra5000

Copy link
Copy Markdown
Contributor

Summary

Expands the one-line sampling rate description in the Storage Explorer docs into a dedicated subsection that explains the common reasons the observed rate diverges from the configured rate:

  • Errors are always stored regardless of sampling configuration
  • Head-based sampling only applies to root transactions; non-root services respect upstream distributed tracing headers
  • Non-sampled transactions are not sent to APM Server at all (except RUM JS Agent)
  • Tail-based sampling: APM Server buffer overflow can raise or lower the observed rate depending on overflow configuration
  • Third-party gateways injecting tracing headers override the configured rate
  • Tips for getting a more accurate comparison (stable time range, low error rate period)

Content sourced from internal KB article d43a7b9b by @lucabelluccini. To be confirmed by an SME.

Closes elastic/kibana#207309

🤖 Generated with Claude Code

Expands the single-sentence explanation into a dedicated subsection covering:
errors always being stored, head-based and tail-based sampling edge cases,
APM Server buffer overflow behavior, and third-party tracing header overrides
@github-actions

Copy link
Copy Markdown
Contributor

Elastic Docs AI PR menu

Check the box to run an AI review for this pull request.

  • Review docs changes (docs-review). Status: not started.

Powered by GitHub Agentic Workflows and docs-actions. For more information, reach out to the docs team.

@github-actions

github-actions Bot commented Aug 27, 2026

Copy link
Copy Markdown
Contributor

🔍 Preview links for changed docs

@github-actions

github-actions Bot commented Aug 27, 2026

Copy link
Copy Markdown
Contributor

✅ Elastic Docs Style Checker (Vale)

No issues found on modified lines!


The Vale linter checks documentation changes against the Elastic Docs style guide. To use Vale locally or report issues, refer to Elastic style guide for Vale.

@alexandra5000
alexandra5000 marked this pull request as ready for review August 28, 2026 08:22
@alexandra5000
alexandra5000 requested a review from a team as a code owner August 28, 2026 08:22
@cpipilas

Copy link
Copy Markdown

Hey @smith , will need some help here

@mdbirnstiehl mdbirnstiehl left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

One nit, but otherwise LGTM!

Comment thread solutions/observability/apm/storage-explorer.md Outdated
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Observability] Update Storage Explorer docs

4 participants