Skip to main content
Version: 10.3

Audit activity log

Control Tower provides audit functionality to track user and system actions. To view the history of actions, go to System Settings > Activity Log.

The Activity Log page displays a grid with the following information:

  • Revision number
  • User: a user (or system) who performed a particular operation
  • Type: a clickable field describing the target operation object, for instance, License, Template, Task
  • Entity ID: a unique identifier of the operation object
  • Action: an operation performed by a user, for example, CREATED or UPDATED
  • Event Date: the date and time when the operation was performed
  • IP Address: an IP address of the user

View changes​

To view the changes made in files, such as Bot Configs, Templates, and so on, go to the Type column and click the appropriate link.

A file comparison dialog appears.

The available activity types are as follows.

Type nameDescription
RuleChanging composite and other types of rules
Bot ConfigurationTracking changes of Bot Configurations
TemplateTracking changes of Templates
QuestionTracking changes of the Manual Task configuration
LicenseTracking changes of Workspace licenses
HitTracking changes of Manual Task internal entities
Endpoint TaskTracking changes of Manual Task internal entities
Scheduled Campaign UploadTracking changes of schedulers
Business ProcessTracking changes of Business Processes
TaskTracking changes of Manual Tasks
CampaignTracking changes of Business Process definitions
Campaign StructureTracking changes in the XML structure of a Business Process workflow
Task PreviewTracking the usage of the Manual Task Preview feature
Business Process PreviewTracking the Business Process preview actions
UserTracking changes of users in the system; for LDAP and SSO, counting unsuccessful login attempts is not supported
User GroupTracking changes of user groups in the system
RoleTracking changes of system roles
Secrets VaultTracking changes of Secrets Vault entries
ExportTracking export of entities
Task ExportTracking export of Manual Tasks
Business Process ExportTracking export of Business Processes
Campaign ExportTracking export of Business Process definitions
Data StoreTracking changes of Data Store entries
Data Store ContentTracking changes of the Data Store content
Training SetTracking changes of Training Set entries
Answer TypeTracking changes of Answer Type entries
Business Process TabTracking actions on the Business Process Designer tab
Task TabTracking actions on the tabs used to design Manual Tasks
AccountTracking changes of the default Workspace license
RunTracking changes of Business Process runs
Download FileTracking changes of downloading files
PreviewTracking the usage of the preview feature
Bot OperationTracking changes of Bot Operations
Manual OperationTracking changes of Manual Operations
Business Process OperationTracking changes of Business Process Operations
Inconsistent AssignmentTracking the usage of inconsistent assignments
Data Management ConfigurationTracking changes of the data management configuration
AI Agent VariationTracking changes of AI Agent Variations
AI Agent Variation ConfigurationTracking changes of the AI Agent Variation configuration
Asynchronous Sub-process ExecutionTracking the usage of the asynchronous sub-process execution
Synchronous Sub-process ExecutionTracking the usage of the synchronous sub-process execution
note

For details on how to track and manage user sessions, refer to the Manage sessions guide.

Apply filters​

To facilitate search among the thousands of logged records, apply any of the two filter types—a predefined and an advanced one.

Predefined filter​

The filter sets a time frame for the records to be displayed on the list. To apply, click the Filter by field and select a predefined filter from the drop-down options.

Advanced filter​

The advanced filter enables setting one or more criteria to display records on the list. To apply the advanced filter, follow the steps below:

  1. Select the Advanced checkbox and click the Add parameter button.

  2. In the drop-down box, select one or more search parameters—Type, Entity ID, Created date, User, or IP address.

  3. For each search parameter, choose and specify a filtering criteria: contains, doesn't contain, equals to, and so on, and a specific condition to include or exclude from the result, respectively.

    For instance, if you want to find all changes made on a specific date, set the search parameter to Created date, the filtering criteria to equals to, and the condition—to the specific date.

  4. (Optional) Select the Match all parameters checkbox if all parameters should match.

  5. Click Apply Filter.

Save filter​

To save a filter for future use, click ... next to Apply Filter and, in the drop-down menu, select Save Filter.

Type in a name for your filter and set it to be private or available for other users.

You can then apply the saved filter by selecting it in the list of the predefined filters in the Filter by field.

Clear or refine filter​

If a filter is applied, the filter area contains a special box with the matching results count.

To remove or edit the filter, click Clear filter or Refine Filter, respectively.

View query database objects​

All data are stored in the AuditData table. For column descriptions, see View changes.

Query sample for displaying changes in roles and users
select case a.`action`
        when 0 then 'CREATED'
        when 1 then 'UPDATED'
        when 2 then 'DELETED'
        when 3 then 'DOWNLOADED'
        when 4 then 'VIEWED'
        else 'N/A'
        end as "action"
     , a.content
     , a.createdDate
     , a.entityId
     , a.username
     , a.threadName
  from AuditData as a
 where a.entityType in( 'ROLE', 'USER')
 order by a.createdDate desc
;
troubleshooting

For support guides, refer to the following pages: