{"componentChunkName":"component---src-templates-markdown-template-jsx","path":"/guides/settings/platform/audit-logs/","result":{"data":{"pageMetadata":{"title":"Audit Logs","path":"/guides/settings/platform/audit-logs/","sourceCode":null,"metadataParent":{"title":"Platform","path":"/guides/settings/platform/","sourceCode":null,"hasVersionPicker":null,"metadataChildren":[{"title":"Platform Configuration","path":"/guides/settings/platform/platform-configuration/","order":1,"label":null},{"title":"mParticle Users and Roles","path":"/guides/settings/platform/users/","order":2,"label":null},{"title":"Key Management","path":"/guides/settings/platform/key-management/","order":3,"label":null},{"title":"Notifications","path":"/guides/settings/platform/notifications/","order":4,"label":null},{"title":"Audit Logs","path":"/guides/settings/platform/audit-logs/","order":5,"label":null}],"metadataParent":{"title":"Settings","path":"/guides/settings/","metadataChildren":[{"title":"Platform","path":"/guides/settings/platform/","order":1,"label":null},{"title":"Billing","path":"/guides/settings/billing/","order":4,"label":null},{"title":"Usage metering for value-based pricing (VBP)","path":"/guides/settings/usage/","order":5,"label":null}],"metadataParent":{"title":"Guides","path":"/guides/","metadataChildren":[{"title":"Platform Overview","path":"/guides/platform-overview/","order":0.5,"label":null},{"title":"Getting Started","path":"/guides/getting-started/","order":1,"label":null},{"title":"mParticle Agent","path":"/guides/mparticle-agent/","order":1.5,"label":null},{"title":"Oversight","path":"/guides/oversight/","order":2,"label":null},{"title":"Data Platform","path":"/guides/data-platform/","order":3,"label":null},{"title":"Data Warehouse","path":"/guides/data-warehouse/","order":4,"label":null},{"title":"Customer 360","path":"/guides/customer-360/","order":5,"label":null},{"title":"Analytics","path":"/guides/analytics/","order":6,"label":null},{"title":"Audiences","path":"/guides/audiences/","order":7,"label":null},{"title":"Settings","path":"/guides/settings/","order":8,"label":null},{"title":"Troubleshooting mParticle","path":"/guides/troubleshooting/","order":10,"label":null},{"title":"Default Service Limits","path":"/guides/default-service-limits/","order":11,"label":null},{"title":"Glossary","path":"/guides/glossary/","order":12,"label":null}],"metadataParent":null}}}},"markdownRemark":{"html":"

Audit Logs help account admins maintain oversight of their mParticle organization by recording what changes are made, who made them, and what resources are affected. Audit Logs capture a wide range of features and activity, from updates to warehouse sync configurations to added API credentials.

\n

This visibility makes it easier to troubleshoot unexpected behavior and provides an auditable record for security and compliance purposes.

\n

\n \n \n \n \n \n \n \n Accessing Audit Logs

\n\n

To access Audit Logs:

\n
    \n
  1. Log into your mParticle account.
    2. \n
  2. Hover your cursor over the Settings icon in the left hand navigation, and select Platform.
    3. \n
  3. Select the Audit tab.
    4. \n
\n

\n \n \n \n \n \n \n \n Viewing Audit Logs

\n

The Audit Logs tab displays the most recent actions taken in your mParticle organization, sorted from most to least recent.

\n

\n\n

Each row pertains to a log for a single action, and includes the following details:

\n\n

See Resources and actions included in Audit Logs below for a complete list of the actions and resources recorded in audit logs.

\n

\n \n \n \n \n \n \n \n Search for a specific audit log

\n

Use the search bar to look for a specific audit log by resource name.

\n

\n\n

\n \n \n \n \n \n \n \n Filter audit logs

\n

To only view audit logs within a specific date range, click Date Range and select the start and end date.

\n

\n

You can further narrow the results shown by clicking Filters and selecting the specific resource, actions, and actors (or users) you want to see results for. After selecting your desired filters, click Apply.

\n

\n

If you download your audit logs as a CSV, only logs within the set date range and filters will be included in the CSV file.

\n

\n \n \n \n \n \n \n \n Audit log details

\n

You can see more technical information for a specific log by clicking on any row in the list.

\n

This opens a panel labeled Details containing a JSON formatted object that lists the following information about the request:

\n\n

\n

If any of the above fields aren’t applicable to the particular log you are viewing, they will be omitted from the log details.

\n

The log details for each action is included in audit log CSV exports.

\n

\n \n \n \n \n \n \n \n Exporting audit logs

\n

To export your audit logs to a comma separated values formatted file, click Download CSV.

\n

\n

The CSV will contain all logs within the selected date range and applied filters.

\n

\n \n \n \n \n \n \n \n Use cases and best practices

\n

You can use Audit Logs to monitor changes, help diagnose issues, and maintain a trusted record for compliance and security.

\n

\n \n \n \n \n \n \n \n Track configuration changes

\n

Audit Logs provide a complete history of configuration changes across your mParticle account over the previous 12 months. For example, if a data pipeline stops behaving as expected, you can review the logs to see whether a teammate recently deactivated a connection or updated a data plan.

\n

By monitoring these changes, you can maintain consistency across workspaces and prevent accidental misconfigurations from disrupting your data flow.

\n

\n \n \n \n \n \n \n \n Troubleshoot issues

\n

When something breaks (such as a connection unexpectedly failing, an audience not updating, or a data feed behaving differently), Audit Logs can help you identify the root cause. You can see who made changes, what was changed, and whether the action succeeded or failed. This context reduces the time it takes to diagnose problems and allows you to resolve them without unnecessary guesswork.

\n

\n \n \n \n \n \n \n \n Support compliance and security audits

\n

Many organizations need to demonstrate that data systems are being properly managed and monitored. Audit Logs give you an auditable trail of who accessed or updated critical settings and when. You can use this history to confirm that your team is following internal governance processes, and to provide evidence during external compliance reviews or security audits. Regularly exporting logs can also help you maintain a long-term archive beyond the retention window in the mParticle platform.

\n

\n \n \n \n \n \n \n \n Resources and actions included in Audit Logs

\n

Audit Logs covers a wide range of resources across Customer 360, Data Platform, Oversight, Segmentation, Settings, and Warehouse Sync. The table below lists every resource and the actions that are tracked.

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
Platform AreaResourceActions Logged
Customer 360Calculated AttributeCreating, updating, or deleting a calculated attribute. Updating includes cloning a calculated attribute.
Group DefinitionCreating, updating, or deleting a group definition.
Predictive AttributeCreating, updating, or deleting a predictive attribute.
User ProfileUpdating a user profile. This includes creating, updating, and deleting any attribute, identity or consent value for user profile via the UI or IDSync API.
Data PlatformBulk Profile Deletion RequestCreating a bulk deletion request.
ConnectionCreating, updating, or deleting a connection. Updating includes activating and deactivating a connection.
Data PlansCreating, updating, or deleting a data plan. Updating includes activating, deactivating, assigning a version to (and changing the version of) a data plan.
Data PointsCreating, updating, or deleting a data point. Updating includes updating the description, tags, or tier of a datapoint in the Data Catalog.
FiltersCreating, updating, or deleting a filter.
Input ConfigurationCreating, updating, or deleting an input configuration. Updating includes activating or deactivating an input configuration.
Output ConfigurationCreating, updating, or deleting an output configuration. Updating includes activating or deactivating an output configuration.
RulesCreating, updating, or deleting a rule. Updating includes applying a rule to, or removing a rule from, a connection.
OversightApple ATT SettingUpdating your Apple ATT settings, including updating your opt-in, opt-out, and default ATT settings.
Data Subject RequestCreating a data subject request.
DSR SettingEnabling or disabling Data Subject Requests.
Trace ConfigurationCreating, updating, or deleting a trace configuration.
SegmentationAudienceCreate, updating, or deleting an audience. Updating includes activating, deactivating, and connecting an audience.
Audience GroupCreating, updating, or deleting an audience group.
SessionSessionUser log-ins and log-outs on your mParticle account.
Settings & ConfigurationAccountCreating, updating, or deleting an account in your mParticle org.
API CredentialCreating or deleting an API credential.
Audience SettingUpdating your default audience sharing settings.
Custom RoleCreating, updating, or deleting a custom role.
KeyCreating or deleting an SSH key.
Notification DestinationsCreating, updating, or deleting a notification destination.
UserCreating, updating, or deleting a user. Updating includes assigning a standard or custom role to a user.
WorkspaceCreating, updating, or deleting a workspace in your mParticle account.
WarehouseComposable AudienceCreating, updating, or deleting a composable audience.
ConnectionCreating, updating, or deleting a connection with a warehouse.
Data ModelCreating, updating, or deleting a data model.
Field TransformationCreating, updating, or deleting a field transformation.
PipelineCreating, updating, or deleting a pipeline.
","frontmatter":{"title":"Audit Logs","order":5,"seoTitle":null,"seoDescription":null},"parent":{"__typename":"File","modifiedTime":"October 12, 2026"}}},"pageContext":{"slug":"/guides/settings/platform/audit-logs/"}},"staticQueryHashes":["2950460867"]}