Skip to main content

Audit Logs

The audit log is a paper trail of all notable activities on an Appsmith instance. It automatically captures and displays events by recording what activity was performed, who performed it, and when it occurred. With this information, you can ensure that you're able to follow up and address any unexpected or undesirable events.

There are several kinds of events that are logged:

  • App-specific activity
    • Changes to pages
    • Datasource configuration
    • Query configuration and execution
    • Deleting apps
    • Exporting a page's resources to a file and importing them into a page
  • Changes to Administrator settings
    • Instance configuration changes
  • User sign-up and login activity

To access the audit logs, on the homepage, go to Admin Settings > Others > Audit logs. Within this tab, you can see a list of events that have been tracked under your organization's account. To view the details of a specific event, click on the event description to expand the event and display a complete set of details in JSON format.

Audit logs
Audit logs

Log contents​

Each logged item has several data points that describe that event, including references to related apps, datasources, queries, and workspaces. This data is served in JSON format.

DataDescriptionDetails
eventEach action performed on Appsmith app (edit or view mode) is classified as event
timestampDisplays the date and time of a logged event.
userDisplays the user who made performed this eventid, email, name
resourceThe type of resource on which this event was performed (Query, Datasource, etc.)id, type, name
appApplication on which the action is performed.id, name, git default
workspaceWorkspace on which the action is performed.id, name
pagePage on which the action is performed. Set for page-scoped events, such as partial imports and exports.id, name
partialResourceCountsNumber of resources included in a partial import or export. Set only on application.partial_exported and application.partial_imported events.actionCount, actionCollectionCount, datasourceCount, jsLibCount, hasWidgets
instanceSettingsNames of the instance settings that changed. Set on instance_setting.updated events.List of setting names, such as anvilTheme
anvilThemeThe organization theme for Responsive apps before and after the change. Set only on instance_setting.updated events that change the theme, including a restore of the previous theme. An empty object means there was no theme.oldValue, newValue
allowCustomCssWhether builders can add custom CSS to Responsive widgets, before and after the change. Set only on instance_setting.updated events that change this setting. A setting that was never changed counts as true.oldValue, newValue
metadataPlatform details, such as the Appsmith version.appsmithVersion, createdAt

An example of a log item is given below:

{
"event": "datasource.created",
"timestamp": "2022-06-29T08:36:33.507+00:00",
"user": {
"id": "62bc0f11545c4c00b19d5c65",
"email": "john@appsmith.com",
"name": "John Doe"
},
"resource": {
"id": "62bc0f11545c4c00b19d5c59",
"type": "Datasource",
"name": "Movies"
},
"app": {
"id": "62bc0f11545c4c00b19d5c68",
"name": "Standup App",
"git": {
"branch": "feat/new-ui",
"default": "master"
}
},
"workspace": {
"id": "62bc0f11545c4c00b19d5c64",
"name": "Appsmith Internal Apps"
},
"metadata": {
"appsmithVersion": "1.7.5",
"createdAt": "2022-06-29T08:36:33.507+00:00"
}
}

A partial export or import record also includes the page and the number of resources in the file. In partialResourceCounts, actionCount is the number of queries, actionCollectionCount is the number of JS objects, jsLibCount is the number of JS libraries, and hasWidgets is true when the file includes widgets. For example:

{
"event": "application.partial_exported",
"resource": {
"id": "<application-id>",
"type": "Application",
"name": "Sample App"
},
"workspace": {
"id": "<workspace-id>",
"name": "Sample Workspace"
},
"page": {
"id": "<page-id>",
"name": "Page1"
},
"partialResourceCounts": {
"actionCount": 3,
"actionCollectionCount": 0,
"datasourceCount": 1,
"jsLibCount": 0,
"hasWidgets": true
}
}

In the audit log list, these records show as partially exported or partially imported, followed by the page, the workspace, and the resources that were included. Resource types with a count of zero are left out. For example: from Page1 in Sample Workspace · 3 queries, 1 datasource, widgets.

A change to the organization theme for Responsive apps writes one instance_setting.updated record. instanceSettings lists the settings that changed, and anvilTheme holds the theme values before and after the change. If the same save also changes the custom CSS setting, the record lists allowCustomCss too and includes its old and new value. For example:

{
"event": "instance_setting.updated",
"instanceSettings": ["anvilTheme"],
"anvilTheme": {
"oldValue": {
"enabled": true,
"accentColor": "#553DE9",
"colorMode": "LIGHT"
},
"newValue": {
"enabled": true,
"accentColor": "#0B8A5F",
"colorMode": "DARK",
"anvilFont": "inter"
}
}
}

Tracked events​

The following table shows the events that appear in Appsmith's audit logs. In any given log record, you can find the event's name on the record's event property.

Event NameDescription
workspace.createdLogged when a new workspace is created.
workspace.updatedLogged when the details of an existing workspace are changed.
workspace.deletedLogged when a workspace is deleted.
application.createdLogged when a new application is created.
application.updatedLogged when a user edits an existing application.
application.deletedLogged when an application is deleted.
application.importedLogged when a new application is created via importing with Git or JSON.
application.exportedLogged when an existing application is exported via Git or JSON.
application.partial_exportedLogged when a user exports selected resources (widgets, queries, JS objects, datasources, or JS libraries) from a page to a JSON file. A partial export logs this event instead of application.exported.
application.partial_importedLogged when a user imports resources from a partial export JSON file into a page. Only imports from an uploaded file log this event.
application.clonedLogged when a new application is created via cloning.
application.forkedLogged when an existing application is forked.
application.deployedLogged when a new version of an application is deployed/published.
page.createdLogged when a new page is created.
page.viewedLogged when a user, including any anonymous public users, views a page.
page.updatedLogged when a user edits a page.
page.deletedLogged when a page is deleted.
datasource.createdLogged when a new datasource is created. Also creates a separate event per environment.
datasource.updatedLogged when a user edits an existing datasource's configuration. Creates a separate event per environment.
datasource.deletedLogged when a datasource is deleted. Only logs a single event for all environments.
query.createdLogged when a new query is created.
query.updatedLogged when a user edits an existing query's configuration.
query.deletedLogged when a query is deleted.
query.executedLogged when an existing query runs. This applies both in Edit and View modes. The execution parameters of the query are included in the log up to a limit of 5 MB.
user.logged_inLogged when a user signs in.
user.logged_outLogged when a user signs out.
user.invitedLogged when someone invites another user to the app or workspace.
user.signed_upLogged when a new user logs in for the first time.
instance_setting.updatedLogged when a change is made to the Appsmith instance's configuration. A change to the organization theme for Responsive apps, or to whether custom CSS is allowed in Responsive apps, also records the old and new value.
role.createdLogged when a new role is created in granular access controls.
role.updatedLogged when a role configuration is updated in granular access controls.
role.deletedLogged when a role is deleted from granular access controls.
role.assigned_usersLogged when a role is assigned to users.
role.unassigned_usersLogged when a role is unassigned from users.
role.assigned_groupsLogged when a role is assigned to user groups.
role.unassigned_groupsLogged when a role is unassigned from user groups.
group.createdLogged when new group is created in granular access controls.
group.updatedLogged when a group's information is updated in granular access controls.
group.deletedLogged when a group is deleted from granular access controls.
group.invite_usersLogged when users are added to a user group.
group.remove_usersLogged when users are removed from a user group.
approved_analytics_policy.updatedLogged when an administrator changes the approved analytics switch or the list of approved measurement IDs.
approved_analytics_settings.updatedLogged when an app author changes an app's or a page's approved analytics settings.

Export logs​

You can export audit logs from the Appsmith instance to your system as a JSON file. To export logs as a JSON file, go to Admin Settings > Others > Audit logs, click the ⋮ icon at the top right corner and click Download.