Skip to main content

Audit history

Understanding the audit history screen​

The audit history screen is where you browse, search and filter the events that MintPress records. It provides a chronological record of every change to MintPress data - user actions, system-generated events and errors - so you can monitor activity, troubleshoot issues and maintain accountability.

A table view is presented upon accessing the audit history screen.

Audit history screen

Each row includes:

ColumnDescription
SourceThe specific source affected by the event (e.g. project, agent, asset, scheduled activity, properties, settings, etc.)
TypeThe event type, with its level shown as a badge and a one-line summary underneath where the event has one. See system event types.
Created atTimestamp for when the event was created.
SystemWhether it is a system-generated event or a user-generated one.
UserThe user responsible for triggering the event.
Event dataA button that opens the event's data without leaving the table.
Buttons & linksFunction
Search event typeFilter the events by their type. Press Enter to apply.
UserFilter the events by the users who raised them.
Event typeLimit the events to Error events, Info events or API events.
CreatedFilter the events by when they were created.
SystemShow All events, or only System generated or User generated ones.
ClearClears all the filters and refreshes the table contents. Shown while a filter is applied.
ApplyApplies the filters to the table and refreshes the table contents.

View the details of an event​

Click a row in the audit history table to open that event's details page, which has its own URL to bookmark or share. It shows the event's source, creation time, user and path, and the event's message, progress logs and data in separate tabs. The Event data button in the table opens the same tabs in a dialog.

Audit event details

Node & agent audit history​

Projects, environments, assets and agents each have an Audit history tab showing the most recent events generated for them. It presents the same table, columns and filters as the main audit history screen, but is automatically scoped to the current node or agent — any filters you apply narrow that list further.

Changes and workflow runs have an Audit history tab too. A change's tab lists the events raised by the change and its steps; a workflow run's tab lists those raised by the run, its steps, and the changes it started and their steps. See activity details.

note

The audit history screen and the event details page read from the /api/events endpoint. See filtering events on the API to query the same events from a script.