Skip to main content
Version: 10.2.8

Audit activity log

Control Tower provides audit functionality to track user and system actions, such as creation of Manual Tasks, edits of Use Cases, and so on.

To view the history of actions, go to Configuration > Activity Log.

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

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

View specific 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. Under the grid, you will see a file comparison dialog.

Activity types​

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 the Manual Task internal entities.
Endpoint TaskTracking changes of the 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 the users in the system. For LDAP and SSO, counting unsuccessful login attempts is not supported.
User groupTracking changes of the user groups in the system.
User passwordTracking password changes.
RoleTracking changes of the system roles.
Secrets VaultTracking changes of the Secure Vault entries.
Export (XML)Tracking export of the entities.
Task Export (XML)Tracking export of Manual Tasks.
Business Process Export (XML)Tracking export of Business Processes.
Campaign ExportTracking export of Business Process definitions.
Data StoreTracking changes of Data Store entries.
Training SetTracking changes of Training Set entries.
Answer TypeTracking changes of the Answer Type entries.
PreferencesTracking changes of the system preferences.
Business Process TabTracking actions on the Business Process Designer tabs.
Task TabTracking actions on the tabs to design Manual Tasks.
AccountTracking changes of the default Workspace license.
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, from the drop-down options, select a Predefined Filter.

Advanced filter​

The advanced filter enables setting one or more criteria to display records on the list—Type, Entity ID, Created date, Username, IP address.

To apply, follow the steps below:

  1. Select the Advanced checkbox.

  2. Click the Add filter button and, in the displayed drop-down box, select one or more search parameter—Type, Entity ID, Created date, Username, 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. Click Apply filter.

Save filter​

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

Type in a name for your filter and set the filter to be a private one or to be available for other users as well.

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.

Query database objects​

All data are stored in the AuditData table. For column descriptions, see the Activity Log grid details above.

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: