Skip to main content

Monitoring

The monitoring views are read-only tools that let you trace activity on the platform: Chat Threads (/admin/chat-threads) and Task Runs (/admin/task-runs). Both views are for inspection; conversations cannot be continued or edited here.

Who Can Open the Views​

ViewAccess
Chat ThreadsThe Administrator and Auditor roles, and custom roles with the thread:view-all permission
Task RunsThe Administrator role

The Auditor Role​

Auditor is a built-in role (see Users). According to its description it allows "Read-only monitoring: all threads plus access review of users, roles, and permissions." It contains two permissions:

PermissionAllows
thread:view-allReading every user's chat threads
user:readReading users, roles, and permissions for access review

Among the monitoring views, an auditor opens Chat Threads. There they read every conversation, but cannot delete anything or write to other users' chats. Task Runs remain reserved for administrators. Because the user list requires the user:manage permission, an Auditor sees an empty User column, the detail view shows the user ID instead of the email address, and the Project column shows project IDs. Filtering and searching by user therefore have no effect for them.

You grant the role like any other role, directly to a user or through a group. The Auditor role replaces the former individual Auditor permission on a user's detail page; to grant these rights today, use the Auditor role.

Chat Threads​

The Chat Threads page lists the conversations users have had with agents (see Threads). The table contains the following columns:

ColumnDescription
NameName of the conversation
ProjectAssociated project. Threads created via the OpenAI-compatible API do not belong to any project and are marked with API
UserThe user who owns the thread (filterable)
CreatedCreation date
Last activeTime of the last activity

You can sort by any column by clicking its header. By default, the most recently created threads are at the top. Use the search field to filter the list by name, project, or user. Use the filter on the User column to show only the threads of specific users. Clicking the thread count in the project list opens this page already filtered to that project.

To open the detail view, click a row. Administrators can delete a thread using the action menu (⋮) at the end of a row; this requires a confirmation.

Thread Detail View​

The detail page shows the following cards:

  • Conversation — a read-only view of the entire conversation history.
  • Metadata — Created, Agent, User, Project, as well as Current Run and Last Run.
  • Token Usage — the Prompt Tokens, Completion Tokens, and Total Tokens consumed by this thread.
  • Files — the files attached to the thread.
  • Credentials — the credentials stored for the thread. Administrators can remove individual entries using the trash icon.

Administrators remove the entire conversation using Delete Thread.

Task Runs​

The Task Runs page lists the executions of tasks (see Tasks). The table contains the following columns:

ColumnDescription
TaskName of the executed task (filterable)
IDShortened identifier of the run
CreatedTime of execution

You can sort by any column; by default, the newest runs are at the top. Use the search field to search the list by task name or ID. To open the detail view, click a row.

Run Detail View​

The detail page shows:

  • a read-only view of the execution flow.
  • Metadata — the underlying Task (linked to the task definition), Created, the Token Usage (prompt / completion / total), as well as the number of attached Files and stored Credentials.

Notes​

note

Deleting a thread or credentials is permanent and cannot be undone.

  • Both views are inspection-only tools and do not alter the flow of a conversation or execution.
  • For an organization-wide analysis of token consumption across all threads, see the Token Metrics page. It is available to administrators only.