JuliaHub Audit Events: A User Guide

JuliaHub's Audit Events feature offers administrators detailed logs of platform activities, crucial for traceability, compliance, security, and usage insights. These logs record actions like resource modifications (datasets, projects, packages, notebooks, registries, jobs - covering creation, deletion, versioning), permission changes, and other key operations, enabling tracing of an artifact's lifecycle. This guide explains how to use the JuliaHub UI to access, view, filter, and download these audit logs.

Step 1: Accessing Audit Events

To begin, log into your JuliaHub account with administrative privileges.

  1. Navigate to the Admin section using the left-hand sidebar menu.
  2. Click on "Audit Events" within the Admin section to access the Audit Event page.

Step 2: Understanding the Audit Events Dashboard

Once on the Audit Events page, you'll see a dashboard designed for easy inspection of logs.

  1. Across the top of the audit events section, you'll find tabs for different resource categories: dataset, project, package, notebook, registry, job, application, provider, coupon, and unclassified.
  2. The main area displays a table listing individual audit events. You can scroll horizontally to view all available columns. The columns can also be dragged to reposition them, and their widths can be adjusted to customize your view. The table includes the following columns: Date, User, Activity, Resource, Message, UUID, Version ID, Visibility, Dtype, Tags, Description, and License ID.

Step 3: Filtering Events by Resource Type

You can easily narrow down the audit logs to a specific type of resource.

  1. Simply click on one of the resource category tabs (e.g., package, project, dataset) located directly beneath the "Audit Events" title.
  2. The table will update to display only the audit events relevant to the selected resource type. For instance, selecting the notebook tab will show notebook-specific activities, such as updates to notebooks, deletions of notebook folders, etc.

Step 4: Filtering Events Using Column Criteria

For more granular filtering, you can apply filters directly to the data in the columns.

1. Date Filtering and Sorting

You can sort events by date by clicking the up/down arrow next to the Date column header. To filter events for a specific date, click the filter icon next to the date header. A calendar will pop up, allowing you to select a date, or you can type it in $dd/mm/yyy$ format.

Further date filtering options are available, such as Equals, Does not equal, Before, After, Between, Blank, or Not blank, enabling you to define precise date ranges or conditions.

2. Filtering Other Columns

Columns such as User, Activity, Resource and others also feature a filter icon. Clicking this icon for a specific column opens a pop-up with filter conditions relevant to that column's data type. For text-based fields, these conditions typically include options like Equals, Does not equal, Contains, Begins with, Ends with, Blank, or Not blank, along with a text field to input your search value. This allows you to precisely target events based on user actions, specific activities, resource names, and more.

3. Targeted Cell Value Filtering

For quick filtering, hovering over an individual cell in the table will reveal a small filter icon within that cell. Clicking this icon instantly applies a filter using the value of that specific cell, refining the displayed events to only those that match this value. This is useful for quickly isolating events related to a particular date, user, resource, activity, etc seen in the table.

4. Clearing Filters

When one or more filters are active, the "Clear filters" button, located in the top right area of the page, will become highlighted and clickable. Clicking this button will remove all applied filters, resetting the view to show all logs for the currently selected resource tab.

Step 5: Downloading Audit Events

JuliaHub allows you to download the audit logs for offline analysis or archival. The download options adapt based on whether filters are applied:

Downloading All Events for a Resource Tab: If no filters are currently applied, you will see a "Download" button. Clicking this will download all audit events for the currently selected resource tab.

Downloading Filtered Events: If you have applied one or more filters to narrow down your view, the button will change to "Download filtered data". Clicking this will download only the events that match your active filter criteria.

Export Format: In both cases, the audit logs are exported in CSV (Comma Separated Values) format, which can be easily opened in spreadsheet software or used for further analysis.

By following these steps, administrators can effectively leverage JuliaHub's Audit Events. This easy-to-use dashboard, with its comprehensive audit trail and intuitive filtering, empowers users to enhance security, ensure compliance, and maintain a clear understanding of all platform activities. The ability to quickly trace actions and resource modifications provides invaluable support for governance and operational integrity.