Skip to content

Document 30-day retention for telemetry events - #509

Merged
ehfeng merged 2 commits into
mainfrom
hypeship/telemetry-retention-docs
Aug 19, 2026
Merged

Document 30-day retention for telemetry events#509
ehfeng merged 2 commits into
mainfrom
hypeship/telemetry-retention-docs

Conversation

@ehfeng

@ehfeng ehfeng commented Aug 19, 2026

Copy link
Copy Markdown
Contributor

Summary

A customer asked how long Session telemetry data is persisted for. The answer (30 days, per the telemetry basin config) wasn't documented anywhere — the telemetry pages, privacy policy, and changelog were all silent on it.

This adds retention documentation in two places:

  • Telemetry Overview — new "Retention" section stating captured events are retained for 30 days then expired, with a pointer to the streaming/archive flow and a note that ZDR orgs don't persist telemetry at all.
  • Telemetry Categories — the "Data sensitivity" section already discusses data at rest; adds the 30-day window there so readers of either page get the answer.

Note

Low Risk
Documentation-only changes with no product or security behavior impact.

Overview
Documents that captured browser telemetry is retained for 30 days then expired, closing a gap where persistence duration wasn’t stated in the docs.

Adds a Retention section on the telemetry overview: events can be streamed or pulled within that window and are unavailable after 30 days. The categories Data sensitivity note now states the same retention window and links to overview#retention so readers of either page get a consistent answer about data at rest.

Reviewed by Cursor Bugbot for commit fd06c3f. Bugbot is set up for automated code reviews on this repo. Configure here.

@mintlify

mintlify Bot commented Aug 19, 2026

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
Kernel 🟢 Ready View Preview Aug 19, 2026, 6:16 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.

Comment thread browsers/telemetry/overview.mdx Outdated
@Sayan-
Sayan- marked this pull request as ready for review August 19, 2026 18:29
cursor[bot]
cursor Bot approved these changes Aug 19, 2026
Co-authored-by: Sayan <Sayan-@users.noreply.github.com>
@ehfeng
ehfeng requested a review from Sayan- August 19, 2026 19:12

@cursor cursor Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Risk Assessment: Very Low

Decision: Keep existing approval (risk did not increase)

Re-evaluated after the latest push (fd06c3fc, applying a review suggestion). The PR still only edits two Mintlify documentation pages (browsers/telemetry/overview.mdx and browsers/telemetry/categories.mdx). Net change is 5 lines added and 1 line removed: a Retention section stating a 30-day event expiry window, plus a cross-link from the categories page.

The follow-up commit removed a Zero Data Retention sentence from that section. That is still documentation copy only and does not raise risk.

  • Codepaths / blast radius: Docs copy only. No application code, APIs, config, CI, or infrastructure.
  • Complexity: Trivial prose and internal doc links.
  • Operational / security impact: None. Retention behavior is not implemented here; only described.
  • User-facing surface: Public docs text. No runtime or auth/permission changes.
  • CODEOWNERS: None required (no CODEOWNERS file).

This remains Very Low: documentation-only, no production logic or shared-system impact. Prior approval stands; not re-approving.

Open in Web View Automation 

Sent by Cursor Automation: Assign PR reviewers

@ehfeng
ehfeng merged commit 75c9406 into main Aug 19, 2026
4 checks passed
@ehfeng
ehfeng deleted the hypeship/telemetry-retention-docs branch August 19, 2026 19:18
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.

2 participants