Skip to content

docs(sdk): clarify integration log collection opt-in - #19681

Open
sentry-junior[bot] wants to merge 6 commits into
masterfrom
docs/clarify-integration-logs-opt-in
Open

sentry-junior[bot] wants to merge 6 commits into
masterfrom
docs/clarify-integration-logs-opt-in

Conversation

@sentry-junior

@sentry-junior sentry-junior Bot commented Sep 29, 2026 •

Copy link
Copy Markdown
Contributor

Clarify that auto-capturing logs always requires an explicit and integration-specific opt-in; enabling an integration can only be considered sufficient opt-in in itself if the integration's primary purpose is sending logs

Shorten the auto-emitted logs section to require explicit, knowing opt-in via a dedicated option, with an exception for explicitly enabled integrations whose primary purpose is sending logs.

Co-Authored-By: Daniel Szoke <7881302+szokeasaurusrex@users.noreply.github.com>
@vercel

vercel Bot commented Sep 29, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
develop-docs Ready Ready Preview Sep 29, 2026 9:38am UTC
1 Skipped Deployment
Project Deployment Actions Updated
sentry-docs Ignored Ignored Preview Sep 29, 2026 9:38am UTC

Request Review

@github-actions github-actions Bot added sdk-develop-docs PRs touching develop-docs/sdk Priority: Normal Docs review has no urgent deadline labels Sep 29, 2026
Comment thread develop-docs/sdk/telemetry/logs.mdx Resolved
Co-Authored-By: Daniel Szoke <7881302+szokeasaurusrex@users.noreply.github.com>
Comment thread develop-docs/sdk/telemetry/logs.mdx Resolved
@github-actions github-actions Bot added Priority: Needs Triage The PR description is missing valid priority information and removed Priority: Normal Docs review has no urgent deadline labels Sep 29, 2026
@github-actions

Copy link
Copy Markdown
Contributor

Please update the IS YOUR CHANGE URGENT? section of the PR description:

  • Select exactly one option.
  • If you selected an urgent or other deadline, provide the date as YYYY-MM-DD.

This information helps the Docs team prioritize your review.

Comment thread develop-docs/sdk/telemetry/logs.mdx Resolved
Co-Authored-By: Daniel Szoke <7881302+szokeasaurusrex@users.noreply.github.com>
Co-Authored-By: Daniel Szoke <7881302+szokeasaurusrex@users.noreply.github.com>
Comment on lines +309 to +313
<Alert title="Rationale" level="info">

These rules exist because auto-emitted logs can cause a high volume of telemetry that directly impacts a user's quota. Unlike errors, where users have prior intuition about volume, silently emitting logs on their behalf could lead to unexpected costs. Requiring opt-in ensures users remain in control of their log volume.
We require explicit opt-in to prevent unexpected costs from automatically captured log volume.

</Alert>

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.

@dingsdax do you like this? I moved it into an info-block titled "Rationale" as it is not really part of the spec itself

This branch was successfully deployed

1 active deployment
Preview – develop-docs — 22657ac3 Deployed Sep 29, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Priority: Needs Triage The PR description is missing valid priority information sdk-develop-docs PRs touching develop-docs/sdk

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants