Skip to content

Add Natural Language Query documentation to Audit Trail#34622

Open
anthony-dgx wants to merge 8 commits intomasterfrom
anthony.dagneaux/audit-trail-nlq-documentation
Open

Add Natural Language Query documentation to Audit Trail#34622
anthony-dgx wants to merge 8 commits intomasterfrom
anthony.dagneaux/audit-trail-nlq-documentation

Conversation

@anthony-dgx
Copy link
Contributor

Summary

  • Add NLQ (Natural Language Query) section to the Audit Trail documentation page
  • Customers can now search audit events using plain English instead of learning query syntax
  • Section added under "Explore audit events", following the same pattern as the Logs NLQ documentation

Test plan

  • Verify the NLQ section renders correctly on the preview
  • Add screenshot/GIF at static/images/account_management/audit_logs/audit_trail_nlq.mp4 (light and dark mode)
  • Confirm links and shortcodes work as expected

🤖 Generated with Claude Code

Document NLQ support in Audit Trail, allowing customers to search audit events using plain English instead of query syntax.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@anthony-dgx anthony-dgx requested a review from a team as a code owner February 16, 2026 16:32
@github-actions
Copy link
Contributor

Preview links (active after the build_preview check completes)

Modified Files

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@github-actions github-actions bot added the Images Images are added/removed with this PR label Feb 16, 2026
anthony-dgx and others added 6 commits February 16, 2026 17:44
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
- CI requires mp4 format, not GIF
- Remove "click Ask in the search field" since there is no Ask button

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Copy link
Contributor

@drichards-87 drichards-87 left a comment

Choose a reason for hiding this comment

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

Left one suggestion related to our style guide and approved the PR.


Use Natural Language Queries (NLQ) to describe what you're looking for in plain English. Datadog automatically translates your request into a structured audit trail query, making it easier to explore audit events without needing to write complex syntax.

The system translates natural language input into Datadog queries and understands context such as users, actions, resources, and time ranges. It also detects relevant fields automatically — for example, "Who modified the payment dashboard last week" or "Show all role changes in the past 24 hours."
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
The system translates natural language input into Datadog queries and understands context such as users, actions, resources, and time ranges. It also detects relevant fields automatically for example, "Who modified the payment dashboard last week" or "Show all role changes in the past 24 hours."
The system translates natural language input into Datadog queries and understands context such as users, actions, resources, and time ranges. It also detects relevant fields automatically, for example, "Who modified the payment dashboard last week" or "Show all role changes in the past 24 hours."

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Images Images are added/removed with this PR

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants