Skip to main content

​
Overview

Audit logs provide a detailed record of actions taken within your organization. Track who did what, when, and where for security, compliance, and troubleshooting purposes.
Audit logs functionality is coming soon. This page describes the planned features.
Audit Logs Settings

​
Accessing Audit Log Settings

1

Go to Settings

Navigate to your organization’s Settings.
2

Click Security

Select the Security tab.
3

View Audit Logs Section

The Audit Logs section is below SSO settings.

​
What Are Audit Logs?

Audit logs capture:
InformationDescription
WhoThe user who performed the action
WhatThe specific action taken
WhenTimestamp of the action
WhereWhich project or organization area
DetailsAdditional context about the action

​
Enabling Audit Logs

These steps will be available when audit logs launch.
1

Enable Audit Logs Toggle

Turn on the Enable Audit Logs switch.
2

Configure Retention

Set how long to retain audit log data.
3

Save Settings

Click Save to enable logging.

​
Logged Events

​
Organization Events

EventDescription
Member invitedNew member invitation sent
Member joinedMember accepted invitation
Member removedMember removed from organization
Role changedMember role updated
Settings updatedOrganization settings modified
SSO configuredSSO settings changed

​
Project Events

EventDescription
Project createdNew project created
Project deletedProject permanently deleted
Project settings updatedProject configuration changed
Member added to projectUser granted project access
Member removed from projectUser access revoked

​
Data Events

EventDescription
Contract uploadedNew contract added
Contract deletedContract removed
Catalog item createdRecording or composition added
Statement uploadedRoyalty statement added
Data exportedData exported from platform

​
Authentication Events

EventDescription
Login successfulUser logged in
Login failedFailed login attempt
LogoutUser logged out
Password changedUser changed password
SSO loginUser authenticated via SSO

​
Viewing Audit Logs

The audit log viewer will be available when the feature launches.

​
Log Entry Details

Each log entry includes:
FieldDescription
TimestampWhen the event occurred
UserWho performed the action
Event TypeCategory of the event
ActionSpecific action taken
ResourceWhat was affected
IP AddressUser’s IP address
User AgentBrowser/client information

​
Filtering Logs

Filter audit logs by:
  • Date range
  • User
  • Event type
  • Project
  • Action

​
Searching Logs

Search for specific:
  • User names or emails
  • Resource names
  • IP addresses
  • Keywords

​
Exporting Audit Logs

Export logs for compliance or analysis:
FormatDescription
CSVSpreadsheet-compatible format
JSONMachine-readable format
1

Set Filters

Apply date range and other filters.
2

Click Export

Select the export format.
3

Download

Download the exported file.

​
Retention Settings

Configure how long audit logs are retained:
PeriodDescription
30 daysShort-term retention
90 daysStandard retention
1 yearExtended retention
CustomSet your own retention period
Longer retention periods may affect storage costs. Contact support for enterprise retention options.

​
Permission Requirements

ActionRequired Role
View audit log settingsAdmin, Owner
Enable/disable audit logsAdmin, Owner
View audit logsAdmin, Owner
Export audit logsAdmin, Owner
Configure retentionAdmin, Owner

​
Compliance Use Cases

​
SOC 2 Compliance

Audit logs help demonstrate:
  • Access controls
  • Change management
  • Security monitoring

​
GDPR Compliance

Track:
  • Data access
  • Data exports
  • User consent changes

​
Internal Audits

Document:
  • Who accessed sensitive data
  • Configuration changes
  • User activity patterns

​
Best Practices

Turn on audit logs when you set up your organization to capture all activity from the start.
Balance compliance requirements with storage costs when setting retention periods.
Periodically review audit logs for unusual activity or security concerns.
Export logs before they expire if you need to retain them longer than your retention period.
Consider exporting logs to your security information and event management (SIEM) system.

​
Troubleshooting

Audit logs only capture events after the feature is enabled. Historical events before enabling are not logged.
Try adjusting your filters or search terms. Some events may be categorized differently than expected.
Large date ranges may time out. Try exporting smaller date ranges.
Logs older than your retention period are automatically deleted. Export important logs before they expire.

SSO

Configure Single Sign-On.

Member Roles

Understanding organization roles.

General Settings

Basic organization configuration.

Data Separation

How data is isolated between projects.