Skip to main content
You search an audit stream to find out who did what in NexusOne, such as who accessed a table or which user called an API. The audit page keeps these records in five streams, and you search one stream at a time.

Prerequisites

Before starting this task, ensure you have the following:
  • Required roles: nx1_audit_viewer.
  • An audit store that your platform administrator configured.

Search an audit stream

Perform these steps to search an audit stream:
  1. Log in to NexusOne.
  2. On the top navigation bar, hover your mouse over Govern and then select Audit.
  3. Click the tab of the stream you want to search:
    • Data Access: Who accessed which resource, and whether the policy allowed it.
    • API calls: Each authenticated call to the NexusOne API, and every access denial.
    • MCP tool calls: Each tool called over MCP, without the values of its arguments.
    • Business rules: Rule evaluations and governance actions, such as approvals.
    • AI Router: Each routing decision, including the model chosen and its cost.
  4. Set any of the following:
    • From and To: The date and time to start and end the search.
    • Free text: A phrase to find in the reason or denied_reason field of the JSON output of an event. It appears only on Data Access, API calls, and Business rules.
  5. Optional: To filter on a field, click Add filter. A row appears with the following, from left to right:
    • Field: The field to filter on. Click the list to see every field of the stream. The following are examples:
      • Data Access: Time, Access type, and Resource
      • API calls: Time, Method, and Path
      • MCP tool calls: Time, Tool, and Outcome
      • Business rules: Time, Event, and Decision
      • AI Router: Time, Model used, and Decision
    • The comparison list: How the field should match the value. For Time, the options are is at least, is at most, and is present. Other fields have other options.
    • Value: What to compare it with. For Time and is at most, enter an ISO 8601 date and time, such as 2026-11-17T09:00:00Z.
  6. Optional: To add more filters, repeat step 5. To remove a filter, click the remove icon at the end of its row.
  7. Click Search. NexusOne shows the matching events in a table. If nothing matches, then the page says No events match.
  8. Optional: To see more events, click Next. NexusOne shows 50 events at a time.
  9. Optional: To start over, click Clear filters.

Additional resources