Use Profile Change Auditing

SINCE 3.0.14

Introduction

The profile auditing feature tracks changes made to JEMH profile configuration. Changes to profile configuration can be viewed within an audit log which displays the profile XML before and after a change was made. A change to a profile can be reversed within the audit log by restoring the profile to the state it was in before the change was made.

Profile auditing is useful for reverting configuration changes that cause unexpected or unwanted behaviour, it is also useful for identifying who made a change to a profile when multiple administrators are working collaboratively on profile configuration.

How to enable profile auditing

Profile auditing is not enabled by default because it requires additional processing each time a configuration change is made. Profile auditing can be enabled within the Auditing section of JEMH via the Settings page.

Viewing the audit log

The profile audit log can be accessed within the Auditing section of JEMH within the Profile Auditing page.

To view the changes made to a profile, press the ... button in the actions column for an audit event and then press View changes.

Changes to the profile will be shown in XML format, this is the format that we export profiles in, XML also makes it easy to visualise changes to the profile as a whole.

The profile can be restored to the state that is was in prior to update by clicking the Restore profile button in the drop-down menu.

Modify the profile audit log retention period

By default changes to profiles will be stored for three months, this retention period can optionally be configured.

The profile audit log retention configuration can be found within the Auditing section of JEMH via the Settings page.