Skip to content

Audit Logs

Overview

GALE’s comprehensive Audit Logs on the Settings console provides full visibility into user actions and system interactions, tracking logins, role changes, and model updates through dynamic time-stamped logs and tracking capabilities.

This empowers admins to ensure compliance with internal policies and regulations, while proactively mitigating risks like data privacy breaches and algorithmic bias.

Each log entry includes the following to provide actionable insights on account and agent-level activities:

  • Event name and category.
  • The user who performed the action.
  • Date and time of the event.
  • Detailed description of the action.

audit logs metadata

The event metadata provides business users with actionable insights, helping them in efficiently identifying patterns in user activities within their accounts. It also aids in detecting anomalies, spotting unauthorized usage, and enhancing overall account security.

You can specify a current or past period to view the logs and have complete visibility into the activities and modifications in your account. Learn more.

Additionally, you can set custom filters based on a specific category, event, or user value to view only the required audit logs. Learn more.

Note

  • The IP Address is fetched from the user’s current network.
  • User ID, Role ID, Model ID, Agent ID, Guardrail ID, Integration ID, and Experiment ID pertain to the unique identifier associated with the module’s entity in the system.

Account-Level Audit Logs

Universal Metadata

The User ID and IP Address are shown for audit log entries across all modules, in addition to module and category-specific metadata listed in the table below.

Category: Login/Logout
Metadata: Email ID is displayed for all the category events below.
Event Description Additional Metadata
Login Tracks the account login activity.
  • Login method
Logout Tracks the account logout activity. -
Category: Roles
Metadata: Role ID is displayed for all the category events below, except Role Changed.
Event Description Additional Metadata
Role edited Tracks the edits done to a custom role. -
Role created Tracks the creation of custom roles.
  • Role Type
Role deleted Tracks the deletion of custom roles.
Role changed Tracks the role changes made for member users. This also includes role changes for multiple users (bulk change). -
Category: Integrations
Metadata: Integration Name, Integration ID, and Integration Type are displayed for all the category events below.
Event Description Additional Metadata
Integration added Tracks integrations added to the account. -
Integration deleted Tracks integration deletions in the account.
Category: Models

Metadata:

  • Model ID and Model Name are displayed for all the Model category events.
  • Model Type is displayed for Model Deleted, API Key created, API Key deleted, Model Finetuning, Model Deployed, and Model Undeployed events.
  • Hardware Type is displayed for Model Finetuning, Model Deployed, and Model Undeployed events.
Event Description Additional Metadata
Model added (external models only) Tracks the addition of external models to the account. -
Model deleted Tracks the deletion of external models from the account.
API Key created Tracks the creation of an API key for a model in the account.
API Key deleted Tracks the deletion of an API key for a model.
Model Finetuning Tracks the finetuning process for models done.
  • Training method
  • No. of epochs
  • Batch size
  • Learning rate
  • Training dataset
  • Test dataset
  • Weights and Biases.
Model deployed Tracks the open-source model deployments in the account.
  • Temperature
  • Max length
  • Top p
  • Top k
  • Stop Sequence
  • Inference batch size
  • Min Replicas
  • Max Replicas
  • Scale up Delay
  • Scale down Delay
Model undeployed Tracks the opensource model undeployments in the account.
  • Hours of usage
  • Temperature
  • Max length
  • Top p
  • Top k
  • Stop sequence
  • Inference batch size
  • Min replicas
  • Max replicas
  • Scale up delay
  • Scale down delay
Category: Agents
Metadata: Agent ID and Agent Name are displayed for all the category events below.
Event Description Additional Metadata
Agent created Tracks the creation of an agent in the account. -
Agent deleted Tracks the deletion of an agent in the account.
  • Model ID
  • Model Name
  • Model Type
Category: Users Management
Event Description Additional Metadata
User invited Tracks the invitation of new users to the account.
  • Added User IDs
  • Role Name
  • Role ID
User deleted Tracks the deletion of existing users from the account.
  • Removed User IDs
Category: Prompts

Metadata:

  • Prompt ID is displayed for all the Prompts category events.
  • Prompt Name is displayed for Prompt created, Versions Committed, Versions Restored, Prompt Shared, Endpoint Copied, and API Key Created category events.
Event Description Additional Metadata
Prompt created Tracks the creation of a prompt. -
Prompt deleted Tracks the deletion of a prompt.
Versions committed Tracks the prompt versions committed.
  • Version Name
Version Restored Tracks the prompt version restored.
Prompt Shared Tracks the prompts shared with other users. -
Endpoint Copied Tracks the prompt endpoint copy done.
Endpoint Consumed Tracks the prompt endpoint that was consumed externally.
API Key Created Tracks the API key creation for the prompt endpoint.
Generated Test Data Tracks the generation of test data.
  • Model name
  • Model ID
  • Tokens Consumed
Generated Prompt Tracks the prompt generation done by the accout user.
Category: Dataset
Event Description Additional Metadata
Dataset uploaded Tracks the dataset uploads in the account.
  • File type(extension)
Category: Guardrails
Metadata: Guardrail Name, Guardrail ID, and Hardware Type are displayed for all the category events below.
Event Description Additional Metadata
Guardrails deployed Tracks the guardrails deployment in the account. -
Guardrails undeployed Tracks the guardrails undeployment in the account.
  • Time of Usage

Agent-Level Audit Logs

Universal Metadata

The User ID, IP Address, and Agent ID are shown for audit log entries across all modules, in addition to module and category-specific metadata listed in the table below.

Category: User Management
Event Description Additional Metadata
Role Changed Tracks the change of an agent role for an account user by a user. -
Invited users Tracks the invitation of one or more users to the account at the agent level.
Removed Users Tracks the removal of one or more users from the account at the agent level.
Category: Agent Management
Agent version, API mode, sync/async, and URL are displayed for all the category events below.

Event Description Additional Metadata
Agent Deployed Tracks the agent deployments in the account. -
Agent Undeployed Tracks the agent undeployments in the account.
Version ID is displayed for all the category events below.
Event Description Additional Metadata
Version Created Tracks the agent version creation. -
Version Deleted Tracks the agent version deletion.
API Key created

Tracks the agent API Key creation.
API Key deleted Tracks the agent API Key deletion.
Agent description updated

Tracks the agent description update done.
Agent name updated

Tracks the agent name update done.
Agent exported

Tracks the agent export done.
API sync timeout updated Tracks the synchronous time update.
Event Description Additional Metadata
API async enabled

Tracks the enabling of the asynchronous mode.
  • URL
  • Access token
  • timeout: yes/no
  • timeout value (if yes)
API async updated

Tracks the update of the asynchronous mode configurations.
API async disabled

Tracks the disabling of the asynchronous mode. -
Environment variable added

Tracks the addition of an environment variable.
Environment variable deleted

Tracks the deletion of an environment variable.
Environment variable edited Tracks the modification of an environment variable.
Category: Guardrails
Event Description Additional Metadata
Input scanner added Tracks the addition of an input scanner. -
Input scanner edited Tracks the modification of an input scanner.
Input scanner removed Tracks the deletion of an input scanner.
Output scanner added Tracks the addition of an output scanner.
Output scanner edited Tracks the modification of an output scanner.
Output scanner removed Tracks the deletion of an output scanner.

Access Audit Logs

To access and view audit logs, follow the steps below:

  1. Sign in to your GALE account. To enable and sign in via SSO, click here.
  2. Navigate to the Settings console.
  3. Click Monitoring > Audit Logs on the left navigation menu. access audit logs

Dashboard Information

The Audit Logs dashboard displays the following information to collectively provide a comprehensive overview of activities within your GALE account:

  • Event Name: Describes the specific event or action that occurred.
  • Category: Identifies the module or entity affected by the event.
  • User Name: Specifies the name of the user who performed the action or triggered the event.
  • Date and Time: Represents when the event occurred.
  • Description: Provides detailed information about what was done. audit logs dashboard

Filter Audit Logs

You can narrow down the information displayed in your account's audit logs by applying custom filters.

These filters allow you to select specific categories, events, or users and then apply operators like Is Equal To or Is Not Equal To to specify the desired value.

This customization helps you focus on relevant audit logs, making it easier to track or investigate specific actions or users within your account.

Steps to Add a Custom Filter

  1. Navigate to the Audit Logs dashboard.
  2. Click the Filter icon.
  3. Click +Add Filter. add filter

  4. In the Filter By window, select the required option from the dropdown list for Select Column, Select Operator, and Enter Value. select filter

Note

When you use "Is Equal To," the audit logs only show entries that match the specified value. Conversely, when you use "Is Not Equal To," the logs display all entries except those that match the specified value.

For example, applying the filter Event Is Equal To Role Created, as shown below, displays only the logs for the role creation event.

example filter

To view the logs for all the events except role creation, you must set the filter as follows:

view all logs

  1. Click Apply.

All the log entries relevant to the applied filter(s) are displayed, as shown below. log entries

To clear the filter settings, click Clear All.

clear all fllters

The number of filters you have applied is displayed on the Filter icon. applied filters

Add Multiple Filters

You can enhance your audit log visibility by adding multiple filters. This capability allows you to specify detailed criteria such as specific categories, events, or users, enabling you to obtain fine-grained results.

By combining filters, you can precisely focus on and analyze the audit log entries that are most relevant to your requirements.

When adding multiple filters to refine your audit log queries, you can use the AND or OR operators in multiple filtering steps effectively.

Note

Consistency in operator usage is required for each filtering step. This means you need to use either the AND operator or the OR operator throughout all criteria. Both operators cannot be used together.

mutually exclusive operators

Using the AND operator ensures that all specified conditions must be met for an entry to be included in the results.

On the other hand, using the OR operator broadens the criteria, allowing entries that meet any of the specified conditions to be included. These operators provide flexibility in tailoring your audit log views.

Steps to Add Multiple Filters

  1. Follow Steps 1 to 3 mentioned here.
  2. Select the AND/OR operator tab in the Filter by window.

    filter operators

  3. Follow Steps 4 to 5 mentioned here.

The matched log entries are displayed in the dashboard.

Time-based Audit Logs

You can view and monitor audit logs within a specific period with the time selection feature. This capability allows you to focus on audit log entries that occurred within a defined time-frame, and track changes.

Time selection is available for past and current time periods, including the ones listed below:

Note

Last 30 Days is the default selection, which displays logs for the past 30 days from the current date.

  • All Time: Displays logs since the time the account was created.
  • Today: Includes audit logs generated on the current day.
  • Yesterday: Includes audit logs generated on the previous day.
  • This Week: Displays logs for all the days in the current week.
  • This Month: Displays logs for all the days in the current month.
  • Last Month: Displays logs for all the days in the previous month.
  • Last 30 Days: Displays logs for the past 30 days from the current date, if events’ data exists.
  • Last 90 Days: Displays logs for the past 90 days from the current date.
  • This Year: Displays logs for all the days in the current year.
  • Last Year: Displays logs for all the days in the past year.

Steps to Set Time Range for Audit Logs

  1. Navigate to the Audit Logs dashboard.
  2. Click the time selection button (displays Last 30 Days). time selection

  3. Select the required period on the left panel, or select a specific date, month or year on the calendar widget (the current day is the default selection).

  4. Click Apply. apply changes

The audit logs for events that occurred within the selected time period are displayed.

Key Considerations and Tips

The time range is automatically selected on the calendar widget once you select the period. Also, the date range is displayed at the bottom of the widget.

time range display

You can select a specific month or year from the relevant dropdown list and switch to different months by clicking the forward/backward arrows.

pagination arrows

To set a specific date as the start date for viewing audit logs, click on the desired date in the widget.

By default, the current day will be set as the end date. This feature allows you to easily customize the period for which you want to monitor and analyze audit logs.

custom start date

Export Audit Logs

The Export feature helps prepare and export account-level audit logs into a .csv file. The audit logs data for the following columns is downloaded. Learn more.

  • Date and Time
  • Event Name
  • Event Category
  • Description
  • User/App Name
  • IP Address: The user's network IP address linked to the specific event.

Exporting audit logs offers the following benefits:

  • Detailed Analysis: CSV format allows you to perform in-depth analysis of log data to identify patterns or anomalies over time, while supporting transparency and accountability.
  • Easy Sharing and Reporting: CSV files of audit logs are easy to share with other stakeholders or integrate them into reporting tools.
  • Compliance and Record-Keeping: Having a documented trail in a standardized format is useful for compliance and regulatory audits, ensuring data is readily available when needed.
  • Automation and Integration: CSVs can be imported into other tools or systems, enabling automation and integration into workflows for continuous monitoring and alerts.

To export audit logs, follow the steps below:

  1. Navigate to the Audit Logs dashboard.
  2. Click the Export icon next to the Filter By icon. export audit logs

The following message is displayed once the file is downloaded. The file can be found in the configured location in your system. success message

The downloaded .CSV file is automatically named as Account_Audit_Logs. The schema of the output file is shown below.

csv file example

GALE’s Audit Logs promotes transparency and accountability in AI operations, helping build trust internally and externally.

You can confidently scale AI initiatives with event-based user activity logs to manage compliance and ensure responsible use of generative AI.