Auditing

View changes made to entities, such as requirements, tests, and defects, and non-entity assets, such as users, workflow scripts, site parameters, and folders.

Enable or disable auditing

Use the ENABLE_AUDIT site parameter to enable or disable auditing.

For details about this parameter, see Site Parameters.

Back to top

Audit log filter

By default, all non-entity audit logs are written. You can use the AUDIT_LOG_FILTER parameter to keep audit logs for specified categories only.

For details about this parameter, see Site Parameters.

Back to top

View entity audit logs

Entity audit logs are accessible from the History tab of the entity's details window.

For details about entity history, see Entity history.

Back to top

View attachment audit logs

Changes made to attachments are accessible from the Attachments tab of the entities details window.

For details, see Work with attachments.

Back to top

View non-entity audit logs

Changes made to non-entity assets, such as users, workflow scripts, site parameters, and folders are logged in either the AUDIT_LOG file or the project database tables, depending on the event type.

View from AUDIT_LOG file or Site Administration

By default, the following events are logged in the AUDIT_LOG file. When the AUDIT_LOG_LOCATION parameter is set to DB, you view the logs from the SYS_AUDIT_LOG table or from Site Administration > Monitoring > System Audit Log. For details, see View system audit logs.

Note: By default, the AUDIT_LOG file is stored in the <installdir>\log directory. You can use the AUDIT_LOG_PATH parameter to specify a different location for the log file. In the new location, the log file is renamed AUDIT_LOG_<machine_name>.

Context Operations
User management
  • Create users

  • Delete users

  • Change user details

  • Change user's projects

  • Deactivate/activate users

  • Add users to a project user group

  • Remove users from a project user group

  • Change user's groups

  • Change user's properties

  • Log in and log out

Project customizations
  • Customize project entities

  • Customize requirement types

  • Add users to groups

  • Create groups

  • Delete groups

Site parameter changes
  • Add parameters

  • Change parameter values

Workflow
  • Change project scripts

Session management
  • Create a session

Connections
  • Log in and log out

  • Disconnect

Note: User's last login and logout time is logged if the ENABLE_AUDIT_LOGIN_LOGOUT_TIME parameter is set to Y.

API Key
  • Create API keys

  • Revoke API keys

  • Delete API keys

  • Regenerate API keys

View from AUDIT_PROPERTIES and AUDIT_LOG tables

You can view the following event logs from the AUDIT_PROPERTIES and AUDIT_LOG project database tables. For details about viewing audit log from project database, see View and query project database tables.

Event Logged In Notes
Clear history

AUDIT_LOG database table

Not applicable
Change test steps (both design steps and run steps) AUDIT_PROPERTIES and AUDIT_LOG database tables

To enable auditing for test steps:

Caution:OpenText recommends that you do not enable the auditing for test steps unless it is necessary, as it generates a large amount of auditing data, especially for run steps.

Entity relations AUDIT_PROPERTIES and AUDIT_LOG database tables

To enable auditing for entity relations, insert a record into the dataconst table using the following query:

insert into dataconst(dc_const_name,dc_value) values ('ENABLE_TRACE_AUDIT','Y')

Move items to Recycle Bin and restore items AUDIT_LOG database table For details about Recycle Bin, see Recycle Bin.
Change test folders AUDIT_PROPERTIES and AUDIT_LOG database tables

To enable auditing for test folders, select the History option for target test folder fields.

For details, see Customize project entities.

Change test set folders AUDIT_PROPERTIES and AUDIT_LOG database tables

To enable auditing for test set folders, select the History option for target test set folder fields.

For details, see Customize project entities.

Back to top

See also: