Warning: Starting from the end of February, 2024, the old Audit trail app will no longer be available. The new Audit trail functionality will be the only functionality available and to be used. We strongly recommend switching to the new Audit trail starting from now if you have not done so already. The new Audit trail is already available and no action is required from your part to activate it. All the events from the old Audit trail app will be archived and transferred to the new Audit trail. You will still be able to export them from the Archive tab (Note: if your platform was created after January 1, 2024, you will not see the Archive tab as all the events will be included in the New Audit trail app). Please note that the Audit trail report found in the Reports area will no longer be available.
An audit trail (also called audit log) is an immutable record that keeps track of administrative actions performed in the system, such as important changes to course completion or enrollment status. The Audit trail report provides evidence of a sequence of activities that have affected specific operations, procedures, or events, and it is useful to allocate the appropriate accountability in case of incidents, specifically pertaining to compliance.
Activating the app
Activate the Audit trail app as described in the Managing apps & features article of the Knowledge Base. The app is listed in the Docebo additional features tab.
Creating Audit trail reports
To create a report, access the Admin menu, then press the Reports item in the E-Learning section. On the main Reports page, press the Create custom report button. In the pop-up box, provide a name for the report, then flag the option to create an Audit trail report. Press Next.
Choose the users to include in the report, selecting them from the Users, Groups or Branch tab. The system can keep multiple selections among tabs. You can also run a report on all registered users, if necessary. Note that when you select users in an Audit trail Report, you are selecting the administrative users who performed the specified action(s) instead of the acted upon users. For example, if you later choose the event User has been created (by administrator), you select the administrators who created the users and not the created users. Press Next to proceed.
Press Next and set the Event Date filter, allowing you to filter by date the events that will be shown in your Audit trail report (and in its preview and export). The option to include events that occurred on any dates is the default for the filter, so if you don’t set any specific dates, all events will be shown in your report, without date restrictions. This filter is useful to speed up data extraction, which is essential when a large amount of data is taken into consideration by the report.
Then, on the same page of the report configuration, select the data you want to see in the report, browsing among different event categories:
- Power Users. Data regarding seat allocation and purchase.
- Courses. Data regarding changes and deletion of courses and sessions, training material, etc.
- Learning plan. Data regarding the creation, update, or deletion of learning plans.
- Custom reports. Data regarding the creation, deletion and publishing of reports.
- User management. Data related to user creation, deletion, suspension, and management.
- Enrollments. Data regarding the courses where users have been enrolled or unenrolled.
- Subscription plan, Bundle, Record and Seat association. Retrieve data related to Subscription Plans.
- Theme management. Data regarding the change of the theme of the platform. This event can be tracked for both single domains as well as subdomains created with the Extended Enterprise App.
- Query report. Data regarding the actions made on reports by the Query builder to manually create reports extracting data directly from the database. This functionality is available only on demand.
- Central repository. Data related to the platform's Central repository feature.
Managing Audit trail reports
Once you've created an Audit trail report, it will be listed on the main Reports page in your platform. A row dedicated to every report shows the report name, its author and creation date, the report visibility and whether the report is scheduled. Click on the magnifying glass icon at the end of the row to view the report, and on the download icon to export it in CSV, XLS or HTML format. From the ellipsis icon menu, you can schedule, edit or delete the report.
Events for the [GET] /manage/v1/trails API
Tip and tricks
You should refrain from creating a single Audit trail report containing all the events. It's better to have a single report for each category and limit the time period in order to ease the readability and use of the report itself.