Skip to content

Audit Trail

An Audit Trail allows you to record and track any create, delete, or update action performed within a project by any user. Once enabled, it records data from this moment going forward.

In addition to tracking changes to a project, it also tracks responses from subjects, such as survey answers.

By default, Audit Trail is not enabled as it stores a lot of data.

Access Control

Audit Trail can be enabled by users with projectAdmin> Access. To grant control privileges, see Access Control.

How to enable Audit Trail

  1. Find your project - At the top left of the PHC interface, click the expand chevron beside the project name (see image below). Scroll through the Projects dropdown menu and find your project.

    Alternatively, you can scroll to the bottom of the list and click the See All button (see image below)to open the Projects page where you can locate your project.

  2. Access the Project Settings page - Click the Project settings icon beside the project name (as shown below). This will open the Project Settings page.

    Projects settings

  3. On the Project Settings page, toggle the Audit Trail switch ON to enable the flow. Then click Save.

    Audit Trail

The Audit Trail is now enabled and will track all changes from this point going forward.

How to access the Audit Trail

You can access the Audit Trail through the Project Settings (step 1 of how to enable Audit Trail) or via the Audit Trail tab on the Project page (see image below).

Audit Trail tab

Audit Trail interface

Any data collected since enabling the Audit Trail is viewable on the Project settings page beneath the toggle button.

Audit Trail in Action

The Audit Trail Search is a powerful search engine for finding Audit Events.

Typing in the query string syntax will help you find issues that occurred on specific dates, resource types, specific actions, IDs. For example, typing “create” in this search box will filter the table beneath with all of the create action events. The search engine supports the boolean operations (AND, OR, NOT), exact string matching using quotations ("), wildcard matching using the * operator. That is, a search using “create AND condition” will filter for any events that match both create and condition.

When using the search box, the # of events being viewed changes to reflect what you are querying on and the histogram also changes to reflect the data queried.

“Fuzzy match” is used to catch misspellings. It is often the reason your query may pull some data that relates to the search items but is not an exact match.

Audit Trail Search examples

Search for changes made to Patient FHIR resources

patient

Search for changes made by my user

"myuser"

Search for changes NOT made by my user

NOT myuser

Search for all deletions of Patient FHIR resources

delete AND patient

Search for all create or updates made by a user with a lifeomic.com email address.

(create OR update) AND *@lifeomic.com

Audit Trail Histogram

The Audit Trail Histogram is a tool that allows visualization of when Audit Events have been created over the project's history since the Audit Trail was enabled. The histogram also provides a simple way to filter Audit Events by time. If you’ve been recording for years, the histogram will scale out for readability. Clicking and dragging on the histogram allows you to zoom in by applying a time filter across the Audit Event data, as seen in the clip below.

Histogram

You can remove this time filter and reset the histogram to the overall view (from beginning of Audit Trail being enabled to present moment) by clicking the x on the filtered date range above the search bar (see image below).

Time Reset

When searching for specific events using the Audit Trail search, the graphs will change to reflect the data queried.

Events being viewed

The number above the search box indicates which events you are viewing (10 per page)/total # of events recorded For example, 20/46 would mean you are viewing events #20-29 out of the total 46 events. You can advance to the next or previous selection of events by clicking the forward or back chevrons.

Data Table

Table of Events

The Table of Events displays the following data:

  • Date (when the even happened)
  • Action (what action occurred
    • Create
    • Update
    • Delete
  • Resource Type (what resource was affected) – there are over 50 but these are the most common FHIR resource page link
    • Medication Administration
    • Condition
    • Document Reference (OCR doc, PDF, PPT, and so on)
    • Patient (name, demographics)
    • Questionnaire (survey)
    • Questionnaire Response (survey answer)
    • Observation
  • ID (who performed the action)

How to view changed FHIR data

You can view the details (JSON format) of a changed FHIR resource referenced by each Audit Event by clicking on the event line in the Audit Trail table.

Event Coding

If the Audit Event refers to an updated resource, the two versions of the FHIR resource will be displayed side by side. You can toggle the button in the upper right corner of the screen to switch from JSON view to “diff view” to see the changes highlighted for easier viewing (see clip below).

Diff View

To close out of this view and return to the Audit Trail page, click the "x" in the top right corner of the page.


Last update: 2021-06-24