Data retention

Retention window

Each plan has a default retention window (Developer 7 days, Team 30, Business 180). An Owner or Admin can set a shorter or equal window under Settings → Data & retention.

An hourly worker deletes:

  • events whose occurrence time is older than the window, and
  • sessions with no activity left inside the window.

Findings are kept so the security record survives; they lose their link to deleted sessions and say so. Each run that deletes something is recorded with its cutoff and counts, visible on the same settings page. "Run now" triggers a run immediately.

Export

  • One trace: the Export button on any trace downloads the session, its events (as stored, after redaction), findings and Git correlations as JSON. Requires the data.export permission.
  • Whole organization: Settings → Data & retention → Download organization export. Business plan and above. Streams members, sessions, events, findings, policies, Git records and the audit log as one JSON document.

Both are recorded in the audit log.

Deletion

An Owner can delete the organization under Settings → General by typing its slug. This permanently removes everything belonging to it, including the audit log. There is no soft delete and no recovery.

To stop collection without deleting history, revoke ingestion keys (Integrations) and run npx @tracemason/cli uninstall on developer machines.

Audit log

Sensitive actions are recorded with the actor, target, time and IP: organization changes, membership and role changes, invitations, key creation and revocation, collector approvals, policy changes, finding triage, integration changes, exports, retention runs, billing changes. Visible to Owners, Admins and Security Analysts.

The audit log is deleted with the organization and is not otherwise subject to the event retention window.