Skip to content

[DOCS-11459] Clarify Audit Trail default data retention period #30538

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 3 commits into
base: master
Choose a base branch
from
Open

[DOCS-11459] Clarify Audit Trail default data retention period #30538

Show file tree
Hide file tree
Changes from 1 commit
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
0ad2167
update info
maycmlee Jul 17, 2025
0a62052
Update content/en/account_management/audit_trail/_index.md
maycmlee Jul 28, 2025
36c9a35
Merge branch 'master' into may/update-audit-trail-retention-period
maycmlee Jul 28, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 4 additions & 2 deletions content/en/account_management/audit_trail/_index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -71,9 +71,11 @@ To enable archiving for Audit Trail, navigate to your [Organization Settings][3]

### Retention

Retaining events is an optional feature for Audit Trail. Scroll down to *Retention* and click the *Retain Audit Trail Events* toggle to enable.
Retaining events is an optional feature for Audit Trail. In the *Retention Period* section, click the *Change retention period*.
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
Retaining events is an optional feature for Audit Trail. In the *Retention Period* section, click the *Change retention period*.
Retaining events is an optional feature for Audit Trail. In the **Retention Period** section, click the **Change retention period** to select a retention length appropriate for your business needs.

Small nitpick here to add a bit more context to this action (of clicking into the retention period). Also boldened the italicized items. Let me know what you think.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

@iadjivon thanks! I usually say for your use case, how about that?


The default retention period for an audit trail event is seven days. You can set a retention period between three and 90 days.
When you enable Audit Trail, the default retention period for an audit trail event is 90 days. You can set the retention period to: 3, 7, 15, 30, or 90 days.
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
When you enable Audit Trail, the default retention period for an audit trail event is 90 days. You can set the retention period to: 3, 7, 15, 30, or 90 days.
When Audit Trail is enabled, the default retention period for an audit trail event is 90 days. You can set the retention period to: 3, 7, 15, 30, or 90 days.

Small change to parallel the syntax of the sentence below.


When Audit Trail is disabled, the retention period is automatically set to seven days and events from the last seven days are retained.
Copy link
Contributor

Choose a reason for hiding this comment

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

When Audit Trail is disabled, the retention period is reset back to the default of 7 days.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Sounds good, made the update.


{{< img src="account_management/audit_logs/retention_period.png" alt="Audit Trail Retention setup in Datadog" style="width:80%;">}}

Expand Down
3 changes: 2 additions & 1 deletion content/en/data_security/data_retention_periods.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -24,7 +24,8 @@ attributes:
- **Spans**: 90 days
- product: Audit Trail
data_type: |
- **Audit logs**: 90 days
- **Audit logs (Audit Trail enabled)**: 90 days
- **Audit logs (Audit Trail disabled)**: 7 days
- product: Browser RUM
data_type: |
- **Events**: 30 days
Expand Down
Loading