Audit Log

Overview

The Audit Log shows a list of significant activity within a Matillion Instance. Most actions by users are logged here in detail such that they are accountable for any changes made.

Note: The Audit Log is an Enterprise-only feature, meaning it is only available to customers on m4.large and m4.xlarge instances.

The Audit Log can be reached through the Admin menu, Admin → Audit. Each row in the Audit Log is a unique action taken by a user on the instance. Only 25 results are shown per page and more records can be found by browsing between pages using the arrows at the bottom-left of the window.

The Audit Log is also available as a JSON export via the v1 API.

Note that the Audit Log might not automatically update if it has already been opened. Use the circular reload arrow at the bottom-left of the panel to refresh the logs.

 

Columns

Each record (row) in the Audit Log is defined by 5 pieces of information, each given in its own column. These columns can be made visible or hidden by hovering the top-right of any column and using the checkboxes in the dropdown menu.

ID: The ID of the audited action.

Specifier: A hierarchical path to the point of action. For example: If a user changes a component parameter, the specifier will give the parameter change, the component, the job, the version and the project that it belongs to. Thus, the specifier can give a direct path to recreate the change the user enacted.

Command Type: A quick reference for the type of action performed. Command Types are named in a self-explanatory matter. For example, deleting a job yields the Command Type 'DeleteJobs' and creating an orchestration component yields 'CreateOrchestrationComponent'.

User: The name of the user than enacted this change.

Time: The time (based on the server's timezone) that the change occurred.

 

Filter

Records in the Audit Log can be filtered according to their values in each column. The filters can be accessed by hovering the top-right of any column and using the dropdown menu. Each column has its own specialised filter.

ID: The ID filter comes with 3 arguments that can filter all rows with an ID above, below or equal to a specified value (integer).

Specifier: Allows the user to filter based on almost any part of a Matillion workflow, such as the names, IDs and types of components, jobs,version and projects. If the filtered property is an integer (such as a component ID), the filter will allow the option to filter rows above, below or equal to a specified value. If the filtered property is a text value (such as a component name), the user can input a string to include only rows that give a partial match.

Command Type: Filters via a text box that allows the user to make a partial match of the Command Type to a specified string. Matched values are not filtered.

User: Filters via a text box that allows the user to make a partial match of the user's name to a specified string. Matched values are not filtered.

Time: Gives a set of calendars allowing users to filter rows if they occurred before, after or on a specified date.
 

Command Types

Many command types exist in the Audit Log and we give examples of a small selection below. Each type is named to be as self-explanatory as possible.


CreateOrchestrationComponent: Creation of a component inside an Orchestration job. Expanding this entry will expose the Project Group, Project, Version and Job that the new component belongs to.

SetParameterElements: Changing the parameters (properties) of a component. This will occur every time a parameter is changed. Expanding this will expose the Project Group, Project, Version, Job, Component and Parameter.

CleanEnvironmentViews: The user has cleaned all views in an environment by right-clicking the environment and selected 'Delete Views'. Expanding this will expose the Project Group, Project and Version this environment belong to.