Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
Note
This feature requires the Premium plan.
This page provides a comprehensive reference of audit log services and events. The availability of these services depends on how you access the logs:
- The audit log system table records all events and services listed in this article.
- Azure Monitor's diagnostic settings service does not log all of these services. Services that are unavailable on Azure's diagnostic settings are labeled accordingly.
- The workspace-level and account-level designations only apply to the audit logs system table. Azure diagnostic logs do not include account-level events.
Azure Databricks highly discourages you from moving this data outside the platform because it can expose sensitive data and put your deployment at risk. Due to the nature of audit log contents, you are reminded that you are responsible to maintain the security, and prevent misuse, of any exported audit logs.
Note
Azure Databricks retains a copy of audit logs for up to 1 year for security and fraud analysis purposes.
Workspace-level events
The following services log audit events at the workspace level.
Authentication events
These events are related to user authentication.
These events are logged under the service_name of accounts.
| action_name | Description | request_params |
|---|---|---|
accountInHouseOAuthClientAuthentication |
An OAuth client is authenticated using an in-house OAuth token. |
|
accountLoginCodeAuthentication |
A user's account login code is authenticated. |
|
aadBrowserLogin |
A user logs in to Databricks using a Microsoft Entra ID browser workflow. |
|
aadTokenLogin |
A user logs in to Databricks through the Microsoft Entra ID token. |
|
jwtLogin |
User logs into Databricks using a JWT. |
|
login |
User logs into the workspace. |
|
logout |
User logs out of the workspace. |
|
mfaAddKey |
User registers a new security key. | |
mfaDeleteKey |
User deletes a security key. |
|
mfaLogin |
User logs into Databricks using MFA. |
|
mintOAuthAuthorizationCode |
An in-house OAuth authorization code is minted. |
|
mintOAuthToken |
An in-house OAuth token is minted. |
|
multiFactorAuthenticationLogin |
A user logs in to Databricks using multi-factor authentication. |
|
oidcBrowserLogin |
A user logs in to Databricks using an OpenID Connect browser workflow. |
|
oidcTokenAuthorization |
When an API call is authorized through a generic OIDC/OAuth token. |
|
samlLogin |
User logs in to Databricks through SAML SSO. |
|
tokenLogin |
A user logs into Databricks using a token. |
|
workspaceLoginCodeAuthentication |
A user's workspace-scoped login code is authenticated. |
|
User and group management events
These events are related to user and group management.
These events are logged under the service_name of accounts.
| action_name | Description | request_params |
|---|---|---|
activateUser |
A user is reactivated after being deactivated. See Deactivate users in workspace. |
|
add |
A user is added to an Azure Databricks workspace. |
|
addPrincipalToGroup |
A user is added to a workspace-level group. |
|
addPrincipalsToGroup |
Multiple users are added to a workspace-level group. |
|
changeDatabricksSqlAcl |
A user's Databricks SQL permissions are changed. |
|
changeDatabricksWorkspaceAcl |
Permissions to a workspace are changed. |
|
changeDatabricksWorkspaceDirectoryAcl |
Permissions to a workspace directory are changed. |
|
changePassword |
A user's password is changed. |
|
changePasswordAcl |
Password changing permissions are changed in the account. |
|
changeServicePrincipalAcls |
When a service principal's permissions are changed. |
|
createGroup |
A workspace-level group is created. |
|
deactivateUser |
A user is deactivated in the workspace. See Deactivate users in workspace. |
|
delete |
A user is deleted from the Azure Databricks workspace. |
|
deleteUser |
A user's personally identifiable information is purged after they have not belonged to any running workspaces for at least 7 days. | |
disableClusterAcls |
Cluster access control is disabled for the workspace. |
|
disableTableAcls |
Table access control is disabled for the workspace. |
|
disableWorkspaceAcls |
Workspace access control is disabled for the workspace. |
|
enableClusterAcls |
Cluster access control is enabled for the workspace. |
|
enableTableAcls |
Table access control is enabled for the workspace. |
|
enableWorkspaceAcls |
Workspace access control is enabled for the workspace. |
|
removeAdmin |
A user is revoked of workspace admin permissions. |
|
removeGroup |
A group is removed from the workspace. |
|
removePrincipalFromGroup |
A user is removed from a group. |
|
removePrincipalsFromGroup |
Multiple users are removed from a workspace-level group. |
|
resetPassword |
A user's password is reset. |
|
setAdmin |
A user is granted account admin permissions. |
|
updateGroup |
A group's properties are updated. |
|
updateUser |
A change is made to a user's account. |
|
usernameDomainDenied |
A user sign-up attempt is denied because the email domain is not allowed. |
|
validateEmail |
When a user validates their email after account creation. |
|
Token management events
These events are related to token management.
These events are logged under the service_name of accounts.
| action_name | Description | request_params |
|---|---|---|
autoScopeDbToken |
A batch operation reduces token scopes as part of automated scope enforcement. |
|
changeDbTokenAcl |
Permissions on an access token are changed. |
|
changeDbTokenState |
A Databricks access token is disabled. |
|
garbageCollectDbToken |
A user runs a garbage collect command on expired tokens. |
|
generateDbToken |
When someone generates a token from User Settings or when the service generates the token. |
|
reachMaxQuotaDbToken |
When the current number of non-expired tokens exceeds the token quota. | |
revokeDbToken |
A user's token is dropped from a workspace. Can be triggered by a user being removed from the Databricks account. |
|
revokeOutOfQuotaDbToken |
A Databricks access token is revoked because the token quota was exceeded. | |
updateDbToken |
A Databricks access token is updated. |
|
updateOnBehalfOfToken |
An on-behalf-of token is updated. |
|
IP access list events
These events are related to IP access lists.
These events are logged under the service_name of accounts.
| action_name | Description | request_params |
|---|---|---|
createIpAccessList |
An IP access list is added to the workspace. |
|
deleteIpAccessList |
An IP access list is deleted from the workspace. |
|
IpAccessDenied |
A user attempts to connect to the service through a denied IP. |
|
ipAccessListQuotaExceeded |
|
|
updateIpAccessList |
An IP access list is changed. |
|
Groups events
Note
This service is unavailable through Azure diagnostic settings. Enable the audit log system table to access these events.
These events are logged at the workspace level. This service includes events related to account and workspace groups. These actions are related to legacy ACL groups. For actions related to account- and workspace-level groups, see Authentication events and Account-level authentication events.
These events are logged under the service_name of groups.
| action_name | Description | request_params |
|---|---|---|
addPrincipalToGroup |
An admin adds a user to a group. |
|
createGroup |
An admin creates a group. |
|
getGroupMembers |
An admin views group members. |
|
getGroups |
An admin views a list of groups | none |
getInheritedGroups |
An admin views inherited groups | none |
removeGroup |
An admin removes a group. |
|
IAM role events
The following event is logged at the workspace level.
These events are logged under the service_name of iamRole.
| action_name | Description | request_params |
|---|---|---|
changeIamRoleAcl |
A workspace admin changes permissions for an IAM role. |
|
AI/BI dashboard events
These events are logged at the workspace level. This service includes events related to AI/BI dashboards.
These events are logged under the service_name of dashboards.
| action_name | Description | request_params |
|---|---|---|
getDashboard |
A user accesses the draft version of a dashboard either by viewing it in the UI or requesting the dashboard definition using the API. Only workspace users can access the draft version of a dashboard. |
|
getPublishedDashboard |
A user accesses the published version of a dashboard by viewing in the UI or requesting the dashboard definition using the API. Includes activity from both workspace users and account users. Excludes receiving a PDF snapshot of a dashboard using scheduled email. |
|
executeQuery |
A user executes a query from a dashboard. |
|
cancelQuery |
A user cancels a query from a dashboard. |
|
getQueryResult |
A user receives the results of a query from a dashboard. |
|
triggerDashboardSnapshot |
A user downloads a PDF snapshot of a dashboard. |
|
sendDashboardSnapshot |
A PDF snapshot of a dashboard is sent through a scheduled email or notification destination. The request parameters values depend on the type of recipient. For a Databricks notification destination, only the destination_id is shown. For a Databricks user, the subscriber's user ID and email address are shown. If the recipient is an email address, only the email address is shown. |
|
getDashboardDetails |
A user accesses details of a draft dashboard, such as datasets and widgets. getDashboardDetails is always emitted when a user views a draft dashboard using UI or requests the dashboard definition using the API. |
|
createDashboard |
A user creates a new AI/BI dashboard using the UI or API. |
|
updateDashboard |
A user makes an update to an AI/BI dashboard using the UI or API. |
|
cloneDashboard |
A user clones an AI/BI dashboard. |
|
publishDashboard |
A user publishes an AI/BI dashboard with shared or individual data permissions using the UI or API. |
|
unpublishDashboard |
A user unpublishes a published AI/BI dashboard using the UI or API. |
|
trashDashboard |
A user moves a dashboard to the trash using the dashboard UI or Lakeview API commands. This event is logged only when performed through these channels, not for workspace actions. To audit workspace actions, see Workspace events. |
|
restoreDashboard |
A user restores an AI/BI dashboard from the trash using the dashboard UI or Lakeview API commands. This event is logged only when performed through these channels, not for workspace actions. To audit workspace actions, see Workspace events. |
|
migrateDashboard |
A user migrates a DBSQL dashboard to an AI/BI dashboard. |
|
createSchedule |
A user creates an email subscription schedule. |
|
updateSchedule |
A user makes an update to an AI/BI dashboard's schedule. |
|
deleteSchedule |
A user deletes an AI/BI dashboard's schedule. |
|
createSubscription |
A user subscribes an email destination to an AI/BI dashboard schedule. |
|
deleteSubscription |
A user deletes an email destination from an AI/BI dashboard schedule. |
|
Alerts events
Important
This feature is in Beta. Workspace admins can control access to this feature from the Previews page. See Manage Azure Databricks previews.
These events are logged at the workspace level. This service includes events related to alerts.
Note
This service does not record legacy alert events. Legacy alert events are logged under the databrickssql service.
These events are logged under the service_name of alerts.
| action_name | Description | request_params |
|---|---|---|
apiCreateAlert |
A user creates an alert using the Alerts V2 API. |
|
apiGetAlert |
A user gets an alert using the Alerts V2 API. |
|
apiTrashAlert |
A user deletes an alert using the Alerts V2 API. |
|
apiUpdateAlert |
A user updates an alert using the Alerts V2 API. |
|
cloneAlert |
A user clones an existing alert. |
|
createAlert |
A user creates a new alert. |
|
getAlert |
A user gets information about an alert using the UI. |
|
previewAlertEvaluate |
The Test condition feature returns the results of the alert test. |
|
previewAlertExecute |
A user uses the Test condition feature to preview and test their alert. |
|
runNowAlert |
A user clicks the Run now button to run the alert query immediately. |
|
updateAlert |
A user updates the details of an alert. |
|
Clusters events
These events are logged at the workspace level. This service includes events related to classic clusters.
These events are logged under the service_name of clusters.
| action_name | Description | request_params |
|---|---|---|
changeClusterAcl |
A user changes the cluster ACL. |
|
changeOwner |
A user changes the owner of a cluster. |
|
create |
A user creates a cluster. |
|
createResult |
Results from cluster creation. In conjunction with create. |
|
delete |
A cluster is terminated. |
|
deleteResult |
Results from cluster termination. In conjunction with delete. |
|
edit |
A user makes changes to cluster settings. This logs all changes except for changes in cluster size or autoscaling behavior. |
|
permanentDelete |
A cluster is deleted from the UI. |
|
resize |
Cluster resizes. This is logged on running clusters where the only property that changes is either the cluster size or autoscaling behavior. |
|
resizeResult |
Results from cluster resize. In conjunction with resize. |
|
restart |
A user restarts a running cluster. |
|
restartResult |
Results from cluster restart. In conjunction with restart. |
|
start |
A user starts a cluster. |
|
startResult |
Results from cluster start. In conjunction with start. |
|
Cluster libraries events
These events logged at the workspace level. This service includes events related to compute-scoped libraries.
These events are logged under the service_name of clusterLibraries.
| action_name | Description | request_params |
|---|---|---|
installLibraries |
User installs a library on a cluster. |
|
uninstallLibraries |
User uninstalls a library on a cluster. |
|
Cluster policy events
Note
This service is unavailable through Azure diagnostic settings. Enable the audit log system table to access these events.
These events are logged at the workspace level. This service includes events related to compute policies.
These events are logged under the service_name of clusterPolicies.
| action_name | Description | request_params |
|---|---|---|
create |
A user created a cluster policy. |
|
edit |
A user edited a cluster policy. |
|
delete |
A user deleted a cluster policy. |
|
changeClusterPolicyAcl |
A workspace admin changes permissions for a cluster policy. |
|
Instance pool events
These events are logged at the workspace level. This service includes events related to pools.
These events are logged under the service_name of instancePools.
| action_name | Description | request_params |
|---|---|---|
changeInstancePoolAcl |
A user changes an instance pool's permissions. |
|
create |
A user creates an instance pool. |
|
delete |
A user deletes an instance pool. |
|
edit |
A user edits an instance pool. |
|
Job events
These events are logged at the workspace level. This service includes events related to jobs.
These events are logged under the service_name of jobs.
| action_name | Description | request_params |
|---|---|---|
cancel |
A job run is cancelled. |
|
cancelAllRuns |
A user cancels all runs on a job. |
|
changeJobAcl |
A user updates permissions on a job. |
|
create |
A user creates a job. |
|
delete |
A user deletes a job. |
|
deleteRun |
A user deletes a job run. |
|
deleteTaskValues |
A user deletes task values for a job run. |
|
getRunOutput |
A user makes an API call to get a run output. |
|
repairRun |
A user repairs a job run. |
|
reset |
A job is reset. |
|
resetJobAcl |
A user requests the change of a job's permissions. |
|
runCommand |
Available when verbose audit logs are enabled. Emitted after a command in a notebook is executed by a job run. A command corresponds to a cell in a notebook. |
|
runFailed |
A job run fails or is canceled. |
|
runNow |
A user triggers an on-demand job run. |
|
runStart |
Emitted when a job run starts after validation and cluster creation. The request parameters emitted from this event depend on the type of tasks in the job. In addition to the parameters listed, they can include:
|
|
runSucceeded |
A job run is successful. |
|
runTriggered |
A job schedule is triggered automatically according to its schedule or trigger. |
|
sendRunWebhook |
A webhook is sent either when the job begins, completes, or fails. |
|
setTaskValue |
A user sets values for a task. |
|
submitRun |
A user submits a one-time run via the API. |
|
update |
A user edits a job's settings. |
|
Lakeflow Spark Declarative Pipelines events
These events are logged at the workspace level. This service includes events related to Lakeflow Spark Declarative Pipelines.
These events are logged under the service_name of deltaPipelines.
| action_name | Description | request_params |
|---|---|---|
changePipelineAcls |
A user changes permissions on a pipeline. |
|
create |
A user creates a declarative pipeline. |
|
delete |
A user deletes a declarative pipeline. |
|
edit |
A user edits a declarative pipeline. |
|
startUpdate |
A user restarts a declarative pipeline. |
|
stop |
A user stops a declarative pipeline. |
|
Cloud storage metadata events
These events are logged at the workspace level. This service includes events related to cloud storage metadata operations used by Auto Loader and file arrival triggers.
These events are logged under the service_name of cloudStorageMetadata.
| action_name | Description | request_params |
|---|---|---|
listObjects |
A user or Auto Loader job fetches a paginated list of file changes (new, updated, or deleted files) from a cloud storage location or Unity Catalog volume. Clients use continuation tokens to incrementally fetch only files that changed since their last read. |
|
validateFileEventsPermissions |
Validates that credentials and cloud resources (queues, subscriptions) are properly configured for file event notifications on a cloud storage location. Called when a user enables managed file notifications for an external location in Unity Catalog. |
|
Ingestion events
The following event is logged at the workspace level and is related to file uploads.
These events are logged under the service_name of ingestion.
| action_name | Description | request_params |
|---|---|---|
proxyFileUpload |
A user uploads a file to their Azure Databricks workspace. |
|
Request for access events
These events are logged at the workspace level. This service includes events related to access request destinations (Public Preview).
These events are logged under the service_name of request-for-access.
| action_name | Description | request_params |
|---|---|---|
updateAccessRequestDestinations |
A user updates access request destinations for a Unity Catalog securable. |
|
getAccessRequestDestinations |
A user gets access request destinations for a Unity Catalog securable. |
|
listDestinations |
A user gets access request destinations for a Unity Catalog securable. This is a legacy version of the getAccessRequestDestinations action. |
|
getStatus |
A user gets status information for a Unity Catalog securable. Request for access is considered enabled for a Unity Catalog securable if at least one access request destination exists. |
|
batchCreateAccessRequests |
A user requests access for one or more Unity Catalog securables. |
|
requestAccess |
A user requests access for a single Unity Catalog securable. This is a legacy version of the batchCreateAccessRequests action. |
|
updateDefaultDestinationStatus |
A user updates the status of a workspace-level setting that controls whether all Unity Catalog securables have a default destination assigned. | none |
getDefaultDestinationStatus |
A user gets the status of the default destination setting. | none |
Uniform Iceberg REST API events
These events are logged at the workspace level. These events are logged when users interact with managed Apache Iceberg tables using an external Iceberg-compatible engine that supports the Iceberg REST Catalog API.
These events are logged under the service_name of uniformIcebergRestCatalog.
| action_name | Description | request_params |
|---|---|---|
config |
User gets a catalog configuration. |
|
createNamespace |
User creates a namespace, with an optional set of properties. |
|
createTable |
User creates a new Iceberg table. |
|
deleteNamespace |
User deletes an existing namespace. |
|
deleteTable |
User deletes an existing table. |
|
getNamespace |
User gets properties of a namespace. |
|
listNamespaces |
User makes a call to list all namespaces at a specified level. |
|
listTables |
User lists all tables under a given namespace. |
|
loadTableCredentials |
User loads vended credentials for a table from the catalog. |
|
loadTable |
User loads a table from the catalog. |
|
loadView |
User loads a view from the catalog. |
|
namespaceExists |
User checks if a namespace exists. |
|
renameTable |
User renames an existing table. |
|
reportMetrics |
User sends a metrics report. |
|
tableExists |
User checks if a table exists within a given namespace. |
|
updateNamespaceProperties |
User updates properties for a namespace. |
|
updateTable |
User updates table metadata. |
|
viewExists |
User checks if a view exists within a given namespace. |
|
DBFS events
These events are logged at the workspace level. This service includes events related to DBFS.
There are two types of DBFS events: API calls and operational events.
DBFS API events
These audit events are only logged when written through the DBFS REST API.
These events are logged under the service_name of dbfs.
| action_name | Description | request_params |
|---|---|---|
addBlock |
User appends a block of data to the stream. This is used in conjunction with dbfs/create to stream data to DBFS. |
|
close |
User closes a stream specified by the input handle. |
|
create |
User opens a stream to write a file to DBFS. |
|
delete |
User deletes the file or directory from DBFS. |
|
getStatus |
User gets information for a file or directory. |
|
mkdirs |
User creates a new DBFS directory. |
|
move |
User moves a file from one location to another location within DBFS. |
|
put |
User uploads a file through the use of a multipart form post to DBFS. |
|
read |
User reads the contents of a file. |
|
DBFS operational events
These audit events occur at the compute plane.
These events are logged under the service_name of dbfs.
| action_name | Description | request_params |
|---|---|---|
mount |
User creates a mount point at a certain DBFS location. |
|
unmount |
User removes a mount point at a certain DBFS location. |
|
Files events
These events are logged at the workspace level. This service includes events related to file management, which includes interacting with files using the Files API or in the volumes UI.
These events are logged under the service_name of filesystem.
| action_name | Description | request_params |
|---|---|---|
directoriesDelete |
A user deletes a directory using the Files API or the volumes UI. |
|
directoriesGet |
A user lists the contents of a directory using the Files API or the volumes UI. |
|
directoriesHead |
A user gets information about a directory using the Files API or the volumes UI. |
|
directoriesPut |
A user creates a directory using the Files API or the volumes UI. |
|
filesDelete |
User deletes a file using the Files API or the volumes UI. |
|
filesGet |
User downloads a file using the Files API or the volumes UI. |
|
filesHead |
User gets information about a file using the Files API or the volumes UI. |
|
filesPut |
User uploads a file using the Files API or the volumes UI. |
|
Workspace files events
These events are logged at the workspace level. This service includes events related to workspaces files.
These events are logged under the service_name of workspaceFiles.
| action_name | Description | request_params |
|---|---|---|
wsfsStreamingRead |
A workspace file is read by a user or programmatically as part of a workflow. |
|
wsfsStreamingWrite |
A workspace file is written to by a user or programmatically as part of a workflow. |
|
wsfsImportFile |
A user imports a file into the workspace. |
|
Agent evaluation events
These events are logged at the workspace level. This service includes events related to agent evaluation, including production monitoring, evaluation datasets, human evaluation, and synthetic evaluation data generation .
Production monitoring events
These events are related to production monitoring, including scorers, metric backfill, and trace archival.
These events are logged under the service_name of agentEvaluation.
| action_name | Description | request_params |
|---|---|---|
getChatAssessments |
A user requests LLM-judge assessments on an agent response. |
|
getChatCompletions |
A user requests an LLM to evaluate an agent response. For example, by invoking a judge created by make_judge. | none |
createScheduledScorers |
A user creates scorers for an experiment. |
|
getScheduledScorers |
A user retrieves scorers for an experiment. |
|
updateScheduledScorers |
A user updates scorers for an experiment. |
|
deleteScheduledScorers |
A user deletes scorers for an experiment. |
|
runMetricBackfill |
A user runs a metric backfill for an experiment. |
|
startTraceArchival |
A user starts trace archival for an experiment. |
|
stopTraceArchival |
A user stops trace archival for an experiment. |
|
Evaluation dataset events
These events are related to evaluation datasets, including CRUD operations for datasets and dataset records, batch operations, and expectations management.
These events are logged under the service_name of agentEvaluation.
| action_name | Description | request_params |
|---|---|---|
createDataset |
A user creates an evaluation dataset. |
|
getDataset |
A user retrieves an evaluation dataset. |
|
listDatasets |
A user lists evaluation datasets. |
|
updateDataset |
A user updates an evaluation dataset. |
|
deleteDataset |
A user deletes an evaluation dataset. |
|
createDatasetRecord |
A user creates a record in an evaluation dataset. |
|
getDatasetRecord |
A user retrieves a record from an evaluation dataset. |
|
listDatasetRecords |
A user lists records in an evaluation dataset. |
|
updateDatasetRecord |
A user updates a record in an evaluation dataset. |
|
deleteDatasetRecord |
A user deletes a record from an evaluation dataset. |
|
batchCreateDatasetRecords |
A user creates multiple records in an evaluation dataset in a single batch operation. |
|
upsertExpectations |
A user upserts expectations for a record in an evaluation dataset. |
|
Synthetic data generation events
These events are related to synthetic evaluation data generation .
These events are logged under the service_name of agentEvaluation.
| action_name | Description | request_params |
|---|---|---|
generateQuestions |
A user generates synthetic questions for evaluation. |
|
generateAnswer |
A user generates synthetic answers for evaluation. |
|
Review app events
These events are related to review apps for human evaluation, including review app management, labeling sessions, and item management.
These events are logged under the service_name of agentEvaluation.
| action_name | Description | request_params |
|---|---|---|
createReviewApp |
A user creates a review app for human evaluation. |
|
getReviewApp |
A user retrieves a review app. |
|
listReviewApps |
A user lists review apps. | none |
updateReviewApp |
A user updates a review app. |
|
createLabelingSession |
A user creates a labeling session in a review app. |
|
getLabelingSession |
A user retrieves a labeling session from a review app. |
|
listLabelingSessions |
A user lists labeling sessions in a review app. |
|
updateLabelingSession |
A user updates a labeling session in a review app. |
|
deleteLabelingSession |
A user deletes a labeling session from a review app. |
|
batchCreateItems |
A user creates multiple items in a labeling session in a single batch operation. |
|
getItem |
A user retrieves an item from a labeling session. |
|
listItems |
A user lists items in a labeling session. |
|
updateItem |
A user updates an item in a labeling session. |
|
batchDeleteItems |
A user deletes multiple items from a labeling session in a single batch operation. |
|
MLflow experiment events
These events are logged at the workspace level. This service includes events related to MLflow experiments.
These events are logged under the service_name of mlflowExperiment.
| action_name | Description | request_params |
|---|---|---|
createMlflowExperiment |
A user creates an MLflow experiment. |
|
deleteMlflowExperiment |
A user deletes an MLflow experiment. |
|
moveMlflowExperiment |
A user moves an MLflow experiment. |
|
restoreMlflowExperiment |
A user restores an MLflow experiment. |
|
renameMlflowExperimentEvent |
A user renames an MLflow experiment. |
|
MLflow artifacts with ACL events
These events are logged at the workspace level. This service includes events related to MLflow artifacts with ACLs.
These events are logged under the service_name of mlflowAcledArtifact.
| action_name | Description | request_params |
|---|---|---|
readArtifact |
A user makes call to read an artifact. |
|
writeArtifact |
A user makes call to write to an artifact. |
|
MLflow model registry events
These events are logged at the workspace level. This service includes events related to the workspace model registry. For activity logs for models in Unity Catalog, see Unity Catalog events.
These events are logged under the service_name of modelRegistry.
| action_name | Description | request_params |
|---|---|---|
approveTransitionRequest |
A user approves a model version stage transition request. |
|
changeRegisteredModelAcl |
A user updates permissions for a registered model. |
|
createComment |
A user posts a comment on a model version. |
|
createModelVersion |
A user creates a model version. |
|
createRegisteredModel |
A user creates a new registered model. |
|
createRegistryWebhook |
User creates a webhook for Model Registry events. |
|
createTransitionRequest |
A user creates a model version stage transition request. |
|
deleteComment |
A user deletes a comment on a model version. |
|
deleteModelVersion |
A user deletes a model version. |
|
deleteModelVersionTag |
A user deletes a model version tag. |
|
deleteRegisteredModel |
A user deletes a registered model. |
|
deleteRegisteredModelTag |
A user deletes the tag for a registered model. |
|
deleteRegistryWebhook |
User deletes a Model Registry webhook. |
|
deleteTransitionRequest |
A user cancels a model version stage transition request. |
|
finishCreateModelVersionAsync |
Completed asynchronous model copying. |
|
generateBatchInferenceNotebook |
Batch inference notebook is autogenerated. |
|
generateDltInferenceNotebook |
Inference notebook for a declarative pipeline is autogenerated. |
|
getModelVersionDownloadUri |
A user gets a URI to download the model version. |
|
getModelVersionSignedDownloadUri |
A user gets a URI to download a signed model version. |
|
listModelArtifacts |
A user makes a call to list a model's artifacts. |
|
listRegistryWebhooks |
A user makes a call to list all registry webhooks in the model. |
|
rejectTransitionRequest |
A user rejects a model version stage transition request. |
|
renameRegisteredModel |
A user renames a registered model. |
|
setEmailSubscriptionStatus |
A user updates the email subscription status for a registered model. |
|
setModelVersionTag |
A user sets a model version tag. |
|
setRegisteredModelTag |
A user sets a model version tag. |
|
setUserLevelEmailSubscriptionStatus |
A user updates their email notifications status for the whole registry. |
|
testRegistryWebhook |
A user tests the Model Registry webhook. |
|
transitionModelVersionStage |
A user gets a list of all open stage transition requests for the model version. |
|
triggerRegistryWebhook |
A Model Registry webhook is triggered by an event. |
|
updateComment |
A user post an edit to a comment on a model version. |
|
updateRegistryWebhook |
A user updates a Model Registry webhook. |
|
Feature store events
These events are logged at the workspace level. This service includes events related to the Databricks Feature Store.
These events are logged under the service_name of featureStore.
| action_name | Description | request_params |
|---|---|---|
addConsumer |
A consumer is added to the feature store. |
|
addDataSources |
A data source is added to a feature table. |
|
addProducer |
A producer is added to a feature table. |
|
changeFeatureTableAcl |
Permissions are changed in a feature table. |
|
createFeatureSpec |
A feature specification is created. |
|
createFeatureTable |
A feature table is created. |
|
createFeatures |
Features are created in a feature table. |
|
deleteFeatureTable |
A feature table is deleted. |
|
deleteTags |
Tags are deleted from a feature table. |
|
generateFeatureSpecYaml |
A feature specification YAML is generated. |
|
getBrickstoreOnlineTableMetadata |
A user gets Brickstore online table metadata. |
|
getConsumers |
A user makes a call to get the consumers in a feature table. |
|
getFeatureStoreWidePermissions |
A user gets feature store-wide permissions. | none |
getFeatureTable |
A user makes a call to get feature tables. |
|
getFeatureTablesById |
A user makes a call to get feature table IDs. |
|
getFeatures |
A user makes a call to get features. |
|
getModelServingMetadata |
A user makes a call to get Model Serving metadata. |
|
getOnlineFeatureTables |
A user gets online feature tables. |
|
getOnlineStore |
A user makes a call to get online store details. |
|
getOnlineStores |
A user gets online stores. |
|
getTags |
A user makes a call to get tags for a feature table. |
|
logFeatureStoreClientEvent |
A feature store client event is logged. |
|
publishFeatureTable |
A feature table is published. |
|
searchFeatureTables |
A user searches for feature tables. |
|
setTags |
Tags are added to a feature table. |
|
updateFeatureTable |
A feature table is updated. |
|
Unity Catalog HTTP connection events
These events are logged at the workspace level when requests are proxied through a Unity Catalog HTTP connection, such as when calling external functions or connecting to external MCP servers.
These events are logged under the service_name of ucHttpConnection.
| action_name | Description | request_params |
|---|---|---|
ucHttpConnectionProxiedRequest |
A request is proxied through a Unity Catalog HTTP connection to an external endpoint. |
|
Databricks SQL events
These events are logged at the workspace level. This service includes events related to Databricks SQL.
Note
If you manage your SQL warehouses using the legacy SQL endpoints API, your SQL warehouse audit events will have different action names. See SQL endpoint logs.
These events are logged under the service_name of databrickssql.
| action_name | Description | request_params |
|---|---|---|
cancelQueryExecution |
A query execution is cancelled from the SQL editor UI. This does not include cancellations that originate from the Query History UI or Databricks SQL Execution API. |
|
changeEndpointAcls |
A warehouse manager updates permissions on a SQL warehouse. |
|
cloneFolderNode |
A user clones a folder in the workspace browser. |
|
commandFinish |
Only in verbose audit logs. Generated when a command on a SQL warehouse completes or is canceled, regardless of the origin of the cancellation request. |
|
commandSubmit |
Only in verbose audit logs. Generated when a command is submitted to a SQL warehouse, regardless of origin of the request. |
|
createAlert |
A user creates a legacy alert. |
|
createQuery |
A user creates a new query. |
|
getQuery |
A user opens a query in SQL editor page or calls the Databricks SQL Get a query API. Only emitted when the legacy SQL editor or Databricks SQL REST API is used. |
|
createQueryDraft |
A user creates a query draft. Only emitted when the legacy SQL editor is used. |
|
createQuerySnippet |
A user creates a query snippet. |
|
createVisualization |
A user generates a visualization using the SQL editor. Excludes default results tables and visualizations in notebooks that utilize SQL warehouses. Only emitted when the legacy SQL editor is used. |
|
createWarehouse |
A user with the cluster create entitlement creates a SQL warehouse. |
|
deleteAlert |
A user deletes a legacy alert through the API. Excludes deletions from the file browser UI or from the legacy alert interface. |
|
deleteNotificationDestination |
A workspace admin deletes a notification destination. |
|
deleteWarehouse |
A warehouse manager deletes a SQL warehouse. |
|
deleteQuery |
A user deletes a query, either from the query interface or through API. Excludes deletion via the file browser UI. |
|
deleteQueryDraft |
A user deletes a query draft. Only emitted when the legacy SQL editor is used. |
|
deleteQuerySnippet |
A user deletes a query snippet. |
|
deleteVisualization |
A user deletes a visualization from a query in the SQL Editor. Only emitted when the legacy SQL editor is used. |
|
downloadQueryResult |
A user downloads a query result from the SQL Editor. Excludes downloads from dashboards. |
|
editWarehouse |
A warehouse manager makes edits to a SQL warehouse. |
|
executeAdhocQuery |
Generated by one of the following:
|
|
executeSavedQuery |
A user runs a saved query. Only emitted when the legacy SQL editor is used. |
|
favoriteQuery |
A user favorites a query. |
|
forkQuery |
A user clones a query. |
|
getAlert |
A user opens a legacy alert's details page or calls the legacy get alert API. |
|
getHistoryQueriesByLookupKeys |
A user gets details for one or more query executions using lookup keys. |
|
getHistoryQuery |
A user gets details for a query execution using the UI. |
|
listHistoryQueries |
A user opens the query history page or calls the Query History List Queries API. |
|
moveAlertToTrash |
A user moves an legacy alert to the trash using the API. Excludes deletions from the file browser UI or from the legacy alert interface. |
|
moveQueryToTrash |
A user moves a query to the trash. |
|
restoreAlert |
A user restores a legacy alert from the trash. |
|
restoreQuery |
A user restores a query from the trash. |
|
setWarehouseConfig |
A workspace admin updates their workspace's SQL warehouse settings, including configuration parameters and data access properties. |
|
startWarehouse |
A SQL warehouse is started. |
|
stopWarehouse |
A warehouse manager stops a SQL warehouse. Excludes autostopped warehouses. |
|
transferObjectOwnership |
A workspace admin transfers the ownership of a dashboard, query, or legacy alert to an active user through the transfer object ownership API. Ownership transfer done through the UI or update APIs is not captured by this audit log event. |
|
unfavoriteQuery |
A user removes a query from their favorites. |
|
updateAlert |
A user makes updates to a legacy alert. ownerUserName is populated if the legacy alert ownership is transferred using the API. |
|
updateNotificationDestination |
A workspace admin makes an update to a notification destination. |
|
updateFolderNode |
A user updates a folder node in the workspace browser. |
|
updateOrganizationSetting |
A workspace admin makes updates to the workspace's SQL settings. |
|
updateQuery |
A user makes an update to a query. ownerUserName is populated if the query ownership is transferred using the API. |
|
updateQueryDraft |
A user makes an update to a query draft. Only emitted when the legacy SQL editor is used. |
|
updateQuerySnippet |
A user makes an update to a query snippet. |
|
updateVisualization |
A user updates a visualization from the SQL Editor. Only emitted when the legacy SQL editor is used. |
|
Notebook events
These events are logged at the workspace level. This service includes events related to notebooks.
These events are logged under the service_name of notebook.
| action_name | Description | request_params |
|---|---|---|
attachNotebook |
A notebook is attached to a cluster. Also emitted when the new SQL editor is attached to a SQL warehouse. |
|
cloneNotebook |
A user clones a notebook. |
|
createFolder |
A user system folder (for example, a home folder or trash folder) is auto-created. |
|
createNotebook |
A notebook is created. |
|
deleteFolder |
A notebook folder is deleted. |
|
deleteNotebook |
A notebook is deleted. |
|
deleteRepo |
A repository is deleted. |
|
detachNotebook |
A notebook is detached from a cluster. Also emitted when the new SQL editor is detached from a SQL warehouse. |
|
downloadLargeResults |
A user downloads query results too large to display in the notebook. Also emitted when the new SQL editor is used to download query results. |
|
downloadPreviewResults |
A user downloads query results from a notebook or the new SQL editor. Also emitted when a user views a previous result in execution history. If the log is from a view, fileType is set to json. |
|
importNotebook |
A user imports a notebook. |
|
modifyNotebook |
A notebook is modified. |
|
moveFolder |
A notebook folder is moved from one location to another. |
|
moveNotebook |
A notebook is moved from one location to another. |
|
openNotebook |
A user opens a notebook using the UI. |
|
renameFolder |
A notebook folder is renamed. |
|
renameNotebook |
A notebook is renamed. |
|
restoreFolder |
A deleted folder is restored. |
|
restoreNotebook |
A deleted notebook is restored. |
|
restoreRepo |
A deleted repository is restored. |
|
runCommand |
Available when verbose audit logs are enabled. Emitted after Databricks runs a command in a notebook or the new SQL editor. A command corresponds to a cell in a notebook or the query text in the new SQL editor.executionTime is measured in seconds. |
|
submitCommand |
Generated when a command is submitted for execution in a notebook or the new SQL editor. A command corresponds to a cell in a notebook or the query text in the new SQL editor. |
|
takeNotebookSnapshot |
Notebook snapshots are taken when either the job service or mlflow is run. |
|
Git folder events
These events are logged at the workspace level. This service includes events related to Databricks Git folders. See also gitCredentials.
These events are logged under the service_name of repos.
| action_name | Description | request_params |
|---|---|---|
checkoutBranch |
A user checks out a branch on the repo. |
|
commitAndPush |
A user commits and pushes to a repo. |
|
createRepo |
A user creates a repo in the workspace. |
|
deleteRepo |
A user deletes a repo. |
|
discard |
A user discards a commit to a repo. |
|
getRepo |
A user makes a call to get information about a single repo. |
|
listRepos |
A user makes a call to get all repos they have Manage permissions on. |
|
pull |
A user pulls the latest commits from a repo. |
|
updateRepo |
A user updates the repo to a different branch or tag, or to the latest commit on the same branch. |
|
Git credential events
These events are logged at the workspace level. This service includes events related to Git credentials for Databricks Git folders.
These events are logged under the service_name of gitCredentials.
| action_name | Description | request_params |
|---|---|---|
createGitCredential |
A user creates a git credential. |
|
deleteGitCredential |
A user deletes a git credential. |
|
getGitCredential |
A user gets a git credentials. |
|
linkGitProvider |
A user links a git provider. |
|
listGitCredentials |
A user lists all git credentials. |
|
updateGitCredential |
A user updates a git credential. |
|
Global init scripts events
These events are logged at the workspace level. This service includes events related global init scripts.
These events are logged under the service_name of globalInitScripts.
| action_name | Description | request_params |
|---|---|---|
batch-reorder |
A workspace admin reorders global initialization scripts. |
|
create |
A workspace admin creates a global initialization script. |
|
update |
A workspace admin updates a global initialization script. |
|
delete |
A workspace admin deletes a global initialization script. |
|
Remote history service events
These events are logged at the workspace level. This service includes events related to adding and removing GitHub Credentials.
These events are logged under the service_name of RemoteHistoryService.
| action_name | Description | request_params |
|---|---|---|
addUserGitHubCredentials |
User adds Github Credentials | none |
deleteUserGitHubCredentials |
User removes Github Credentials | none |
updateUserGitHubCredentials |
User updates Github Credentials | none |
Workspace events
These events are logged at the workspace level. This service includes events related to workspace management.
These events are logged under the service_name of workspace.
| action_name | Description | request_params |
|---|---|---|
addPermissionAssignment |
An account admin adds a principal to a workspace. |
|
changeWorkspaceAcl |
Permissions to the workspace are changed. |
|
createWorkspaceNode |
A user creates a workspace node, such as a folder, repository, or dashboard. |
|
deletePermissionAssignment |
A workspace admin removes a principal from a workspace. |
|
deleteSetting |
A setting is deleted from the workspace. |
|
fileCreate |
User creates a file in the workspace. |
|
fileDelete |
User deletes a file in the workspace. |
|
fileEditorOpenEvent |
User opens the file editor. |
|
getPermissionAssignment |
An account admin gets a workspace's permission assignments. |
|
getRoleAssignment |
User gets a workspace's user roles. |
|
mintOAuthAuthorizationCode |
Recorded when in-house OAuth authorization code is minted at the workspace level. |
|
mintOAuthToken |
OAuth token is minted for workspace. |
|
moveWorkspaceNode |
A workspace admin moves workspace node. |
|
purgeWorkspaceNodes |
A workspace admin purges workspace nodes. |
|
reattachHomeFolder |
An existing home folder is re-attached for a user that is re-added to the workspace. |
|
renameWorkspaceNode |
A workspace admin renames workspace nodes. |
|
unmarkHomeFolder |
Home folder special attributes are removed when a user is removed from the workspace. |
|
updateRoleAssignment |
A workspace admin updates a workspace user's role. |
|
updatePermissionAssignment |
A workspace admin adds a principal to the workspace. |
|
setSetting |
A workspace admin configures a workspace setting. |
|
workspaceConfEdit |
Workspace admin makes updates to a setting, for example enabling verbose audit logs. |
|
workspaceExport |
User exports a notebook from a workspace. |
|
workspaceInHouseOAuthClientAuthentication |
OAuth client is authenticated in workspace service. |
|
Secrets events
These events are logged at the workspace level. This service includes events related to secrets.
These events are logged under the service_name of secrets.
| action_name | Description | request_params |
|---|---|---|
createScope |
User creates a secret scope. |
|
deleteAcl |
User deletes ACLs for a secret scope. |
|
deleteScope |
User deletes a secret scope. |
|
deleteSecret |
User deletes a secret from a scope. |
|
getAcl |
User gets ACLs for a secret scope. |
|
getSecret |
User gets a secret from a scope. |
|
listAcls |
User makes a call to list ACLs for a secret scope. |
|
listScopes |
User makes a call to list secret scopes. | none |
listSecrets |
User makes a call to list secrets within a scope. |
|
putAcl |
User changes ACLs for a secret scope. |
|
putSecret |
User adds or edits a secret within a scope. |
|
SSH events
These events are logged at the workspace level. This service includes events related to SSH access.
These events are logged under the service_name of ssh.
| action_name | Description | request_params |
|---|---|---|
login |
Agent login of SSH into Spark driver. |
|
logout |
Agent logout of SSH from Spark driver. |
|
Web terminal events
These events are logged at the workspace level. This service includes events related to the web terminal feature.
These events are logged under the service_name of webTerminal.
| action_name | Description | request_params |
|---|---|---|
startSession |
User starts a web terminal sessions. |
|
closeSession |
User closes a web terminal session. |
|
Webhook events
These events are logged at the workspace level. This service includes events related to notification destinations.
These events are logged under the service_name of webhookNotifications.
| action_name | Description | request_params |
|---|---|---|
createWebhook |
An admin creates a new notification destination. |
|
deleteWebhook |
An admin deletes a notification destination. |
|
getWebhook |
A user views information about a notification destination using the UI or API. |
|
notifyWebhook |
A webhook is triggered and sends a notification payload to the target URL. |
|
testWebhook |
A test payload is sent to a webhook URL to verify the configuration and ensure it can receive notifications successfully. |
|
updateWebhook |
An admin updates a notification destination. |
|
Account-level services
The following services log audit events at the account level.
Account access control events
Note
This service is unavailable through Azure diagnostic settings. Enable the audit log system table to access these events.
These events are logged at the account level and are related to the Account Access Control API (Public Preview).
These events are logged under the service_name of accountsAccessControl.
| action_name | Description | request_params |
|---|---|---|
updateRuleSet |
A user updates a rule set using the Account Access Control API. |
|
Federation policy events
These events are logged at the account level and are related to federation policies.
These events are logged under the service_name of accounts.
| action_name | Description | request_params |
|---|---|---|
createFederationPolicy |
An account admin creates an account or service principal federation policy. |
|
deleteFederationPolicy |
An account admin deletes an account or service principal federation policy. |
|
updateFederationPolicy |
An account admin updates an account or service principal federation policy. |
|
Note
This service is unavailable through Azure diagnostic settings. Enable the audit log system table to access these events.
These events are logged at the account level. This service includes events related to account-level management.
Account-level authentication events
These events are related to account console authentication.
These events are logged under the service_name of accounts.
| action_name | Description | request_params |
|---|---|---|
accountInHouseOAuthClientAuthentication |
An OAuth client is authenticated. |
|
accountLoginCodeAuthentication |
A user's account login code is authenticated. |
|
accountlessToAccountLoginAuthentication |
A user logs in through the accountless-to-account upgrade flow. |
|
deletePasskeyCredential |
A user deletes a passkey credential. |
|
deleteTotpCredential |
A user deletes a TOTP authenticator app setup key. | |
login |
A user logs into the account console. |
|
logout |
A user logs out of the account console. |
|
mfaLogin |
A user logs in to the account console using multi-factor authentication. |
|
mintOAuthAuthorizationCode |
Recorded when in-house OAuth authorization code is minted at the account level. |
|
mintOAuthToken |
An account-level OAuth token is issued to the service principal. |
|
multiFactorAuthenticationLogin |
A user logs in to the account console using multi-factor authentication. |
|
multiFactorAuthenticationUpdateUserAuthPolicy |
A user's multi-factor authentication policy is updated. |
|
oidcBrowserLogin |
A user logs into their account with the OpenID Connect browser workflow. |
|
oidcTokenAuthorization |
An OIDC token is authenticated for an account admin login. |
|
registerPasskeyCredential |
A user registers a passkey credential for multi-factor authentication. | |
registerTotpCredential |
A user registers a TOTP authenticator app credential for multi-factor authentication. | |
skipRegistration |
A user skips multi-factor authentication registration. | |
tokenLogin |
A user logs into Databricks using a token. |
|
Account-level user and group management events
These events are related to account-level user and group management.
These events are logged under the service_name of accounts.
| action_name | Description | request_params |
|---|---|---|
activateUser |
A user is reactivated after being deactivated. See Deactivate users in account. |
|
add |
A user is added to the Azure Databricks account. |
|
addPrincipalToGroup |
A user is added to an account-level group. |
|
addPrincipalsToGroup |
Users are added to an account-level group using SCIM provisioning. |
|
createGroup |
An account-level group is created. |
|
deactivateUser |
A user is deactivated. See Deactivate users in account. |
|
delete |
A user is deleted from the Azure Databricks account. |
|
removeAccountAdmin |
An account admin removes account admin permissions from another user. |
|
removeGroup |
A group is removed from the account. |
|
removePrincipalFromGroup |
A user is removed from an account-level group. |
|
removePrincipalsFromGroup |
Users are removed from an account-level group using SCIM provisioning. |
|
setAccountAdmin |
An account admin assigns the account admin role to another user. |
|
updateGroup |
An account admin updates an account-level group. |
|
updateUser |
An account admin updates a user account. |
|
usernameDomainDenied |
A user sign-up attempt is denied because the email domain is not allowed. |
|
validateEmail |
When a user validates their email after account creation. |
|
Account-level token and settings events
These events are related to token management and account settings.
These events are logged under the service_name of accounts.
| action_name | Description | request_params |
|---|---|---|
accountIpAclsValidationFailed |
IP permissions validation fails. Returns statusCode 403. |
|
deleteSetting |
Account admin removes a setting from the Azure Databricks account. |
|
garbageCollectDbToken |
A user runs a garbage collect command on expired tokens. |
|
generateDbToken |
User generates a token from User Settings or when the service generates the token. |
|
setSetting |
An account admin updates an account-level setting. |
|
Service principal credentials events
These events are logged at the account level. These events are related to service credentials.
These events are logged under the service_name of servicePrincipalCredentials.
| action_name | Description | request_params |
|---|---|---|
create |
Account admin generates an OAuth secret for the service principal. |
|
list |
Account admin lists all OAuth secrets under a service principal. |
|
delete |
Account admin deletes a service principal's OAuth secret. |
|
Account provisioning events
Note
This service is unavailable through Azure diagnostic settings. Enable the audit log system table to access these events.
These events are logged at the account level. These events have to do with cloud configurations made by account admins in the account console.
Network configuration events
These events are related to network configuration, including network connectivity and network policies.
These events are logged under the service_name of accountsManager.
| action_name | Description | request_params |
|---|---|---|
createNetworkConnectivityConfig |
Account admin created a network connectivity configuration. |
|
getNetworkConnectivityConfig |
Account admin requests details about a network connectivity configuration. |
|
listNetworkConnectivityConfigs |
Account admin lists all network connectivity configurations in the account. |
|
deleteNetworkConnectivityConfig |
Account admin deleted a network connectivity configuration. |
|
createNetworkConnectivityConfigPrivateEndpointRule |
Account admin created a private endpoint rule. |
|
getNetworkConnectivityConfigPrivateEndpointRule |
Account admin requests details about a private endpoint rule. |
|
listNetworkConnectivityConfigPrivateEndpointRules |
Account admin lists all private endpoint rules under a network connectivity config. |
|
deleteNetworkConnectivityConfigPrivateEndpointRule |
Account admin deleted a private endpoint rule. |
|
updateNetworkConnectivityConfigPrivateEndpointRule |
Account admin updated a private endpoint rule. |
|
createEndpoint |
Account admin created an inbound PrivateLink endpoint for performance-intensive services. |
|
getEndpoint |
Account admin retrieved details for an inbound PrivateLink endpoint for performance-intensive services. |
|
listEndpoints |
Account admin listed all inbound PrivateLink endpoints for performance-intensive services in the account. |
|
deleteEndpoint |
Account admin deleted an inbound PrivateLink endpoint for performance-intensive services. |
|
createNetworkPolicy |
Account admin created a network policy. |
|
getNetworkPolicy |
Account admin requests details about a network policy. |
|
listNetworkPolicies |
Account admin lists all network policies in the account. |
|
updateNetworkPolicy |
Account admin updated a network policy. |
|
deleteNetworkPolicy |
Account admin deleted a network policy. |
|
getWorkspaceNetworkOption |
Account admin requests details about a workspace's network policies. |
|
updateWorkspaceNetworkOption |
Account admin updated a workspace's network policy. |
|
Billable usage events
Note
This service is unavailable through Azure diagnostic settings. Enable the audit log system table to access these events.
These events are logged at the account level. This service includes events related to billable usage access in the account console.
These events are logged under the service_name of accountBillableUsage.
| action_name | Description | request_params |
|---|---|---|
getAggregatedUsage |
User accessed aggregated billable usage (usage per day) for the account via the Usage Graph feature. |
|
getDetailedUsage |
User accessed detailed billable usage (usage for each cluster) for the account via the Usage Download feature. |
|
Serverless usage policy events
These events are logged at the account level and are related to serverless usage policies. See Attribute usage with serverless usage policies.
These events are logged under the service_name of budgetPolicyCentral.
| action_name | Description | request_params |
|---|---|---|
createBudgetPolicy |
Workspace admin or billing admin creates a serverless usage policy. The new policy_id is logged in the response column. |
|
updateBudgetPolicy |
Workspace admin, billing admin, or policy manager updates a serverless usage policy. |
|
deleteBudgetPolicy |
Workspace admin, billing admin, or policy manager deletes a serverless usage policy. |
|
Tag policy events
These events are logged at the account level and are related to governed tags.
These events are logged under the service_name of tagging.
| action_name | Description | request_params |
|---|---|---|
createTagPolicy |
A tag policy is created. |
|
deleteTagPolicy |
A tag policy is deleted. |
|
getTagPolicy |
A user requests details of a tag policy. |
|
listTagPolicies |
A user requests a list of tag policies. | |
updateTagPolicy |
A tag policy is updated. |
|
Unity Catalog events
Note
This service is unavailable through Azure diagnostic settings. Enable the audit log system table to access these events.
The following diagnostic events are related to Unity Catalog. Delta Sharing events are also logged under the unityCatalog service. For Delta Sharing events, see Delta Sharing events. Unity Catalog events are logged at the account level, so workspace_id is recorded as 0. The originating workspace ID is included in request_params.workspace_id.
These events are logged under the service_name of unityCatalog.
| action_name | Description | request_params |
|---|---|---|
createMetastore |
Account admin creates a metastore. |
|
getMetastore |
Account admin requests metastore ID. |
|
getMetastoreSummary |
Account admin requests details about a metastore. |
|
listMetastores |
Account admin requests a list of all metastores in an account. |
|
updateMetastore |
Account admin makes an update to a metastore. |
|
deleteMetastore |
Account admin deletes a metastore. |
|
updateMetastoreAssignment |
Account admin makes an update to a metastore's workspace assignment. |
|
createExternalLocation |
Account admin creates an external location. |
|
getExternalLocation |
Account admin requests details about an external location. |
|
listExternalLocations |
Account admin request list of all external locations in an account. |
|
updateExternalLocation |
Account admin makes an update to an external location. |
|
deleteExternalLocation |
Account admin deletes an external location. |
|
createCatalog |
User creates a catalog. |
|
deleteCatalog |
User deletes a catalog. |
|
getCatalog |
User requests details about a catalog. |
|
updateCatalog |
User updates a catalog. |
|
listCatalogs |
User makes a call to list all catalogs in the metastore. |
|
createSchema |
User creates a schema. |
|
deleteSchema |
User deletes a schema. |
|
getSchema |
User requests details about a schema. |
|
listSchemas |
User requests a list of all schemas in a catalog. |
|
updateSchema |
User updates a schema. |
|
createStagingTable |
|
|
createTable |
User creates a table. The request parameters differ depending on the type of table created. |
|
deleteTable |
User deletes a table. |
|
getTable |
User requests details about a table. |
|
privilegedGetTable |
|
|
listTables |
User makes a call to list all tables in a schema. |
|
listTableSummaries |
User gets an array of summaries for tables for a schema and catalog within the metastore. |
|
updateTables |
User makes an update to a table. The request parameters displayed vary depending on the type of table updates made. |
|
createStorageCredential |
Account admin creates a storage credential. You might see an additional request parameter based on your cloud provider credentials. |
|
listStorageCredentials |
Account admin makes a call to list all storage credentials in the account. |
|
getStorageCredential |
Account admin requests details about a storage credential. |
|
updateStorageCredential |
Account admin makes an update to a storage credential. |
|
deleteStorageCredential |
Account admin deletes a storage credential. |
|
generateTemporaryTableCredential |
Logged whenever a temporary credential is granted for a table. You can use this event to determine who queried what and when. |
|
generateTemporaryPathCredential |
Logged whenever a temporary credential is granted for a path. |
|
checkPathAccess |
Logged whenever user permissions are checked for a given path. |
|
getPermissions |
User makes a call to get permission details for a securable object. This call doesn't return inherited permissions, only explicitly assigned permissions. |
|
getEffectivePermissions |
User makes a call to get all permission details for a securable object. An effective permissions call returns both explicitly assigned and inherited permissions. |
|
updatePermissions |
User updates permissions on a securable object. |
|
metadataSnapshot |
User queries the metadata from a previous table version. |
|
metadataAndPermissionsSnapshot |
User queries the metadata and permissions from a previous table version. |
|
updateMetadataSnapshot |
User updates the metadata from a previous table version. |
|
getForeignCredentials |
User makes a call to get details about a foreign table. |
|
getInformationSchema |
User makes a call to get details about a schema. |
|
createConstraint |
User creates a constraint for a table. |
|
deleteConstraint |
User deletes a constraint for a table. |
|
createPipeline |
User creates a Unity Catalog pipeline. |
|
updatePipeline |
User updates a Unity Catalog pipeline. |
|
getPipeline |
User requests details about a Unity Catalog pipeline. |
|
deletePipeline |
User deletes a Unity Catalog pipeline. |
|
deleteResourceFailure |
Resource fails to delete. | none |
createVolume |
User creates a Unity Catalog volume. |
|
getVolume |
User makes a call to get information on a Unity Catalog volume. |
|
updateVolume |
User updates a Unity Catalog volume's metadata with the ALTER VOLUME or COMMENT ON calls. |
|
deleteVolume |
User deletes a Unity Catalog volume. |
|
listVolumes |
User makes a call to get a list of all Unity Catalog volumes in a schema. |
|
generateTemporaryVolumeCredential |
A temporary credential is granted for a volume. |
|
getTagSecurableAssignments |
Tag assignments for a securable are fetched. |
|
getTagSubentityAssignments |
Tag assignments for a subentity are fetched. |
|
UpdateTagSecurableAssignments |
Tag assignments for a securable are updated. |
|
UpdateTagSubentityAssignments |
Tag assignments for a subentity are updated. |
|
createRegisteredModel |
User creates a Unity Catalog registered model. |
|
getRegisteredModel |
User makes a call to get information on a Unity Catalog registered model. |
|
updateRegisteredModel |
User updates a Unity Catalog registered model's metadata. |
|
deleteRegisteredModel |
User deletes a Unity Catalog registered model. |
|
listRegisteredModels |
User makes a call to get a list of Unity Catalog registered models in a schema, or list models across catalogs and schemas. |
|
createModelVersion |
User creates a model version in Unity Catalog. |
|
finalizeModelVersion |
User makes a call to "finalize" a Unity Catalog model version after uploading model version files to its storage location, making it read-only and usable in inference workflows. |
|
getModelVersion |
User makes a call to get details on a model version. |
|
getModelVersionByAlias |
User makes a call to get details on a model version using the alias. |
|
updateModelVersion |
User updates a model version's metadata. |
|
deleteModelVersion |
User deletes a model version. |
|
listModelVersions |
User makes a call to get a list of Unity Catalog model versions in a registered model. |
|
generateTemporaryModelVersionCredential |
A temporary credential is generated when a user performs a write (during initial model version creaiton) or read (after the model version has been finalized) on a model version. You can use this event to determine who accessed a model version and when. |
|
setRegisteredModelAlias |
User sets an alias on a Unity Catalog registered model. |
|
deleteRegisteredModelAlias |
User deletes an alias on a Unity Catalog registered model. |
|
getModelVersionByAlias |
User gets a Unity Catalog model version by alias. |
|
createConnection |
A new foreign connection is created. |
|
deleteConnection |
A foreign connection is deleted. |
|
getConnection |
A foreign connection is retrieved. |
|
updateConnection |
A foreign connection is updated. |
|
listConnections |
Foreign connections in a metastore are listed. |
|
createFunction |
User creates a new function. |
|
updateFunction |
User updates a function. |
|
listFunctions |
User requests a list of all functions within a specific parent catalog or schema. |
|
getFunction |
User requests a function from a parent catalog or schema. |
|
deleteFunction |
User requests a function from a parent catalog or schema. |
|
generateTemporaryServiceCredential |
A temporary credential is generated to access a cloud service account from Databricks. |
|
UpdateWorkspaceBindings |
A metastore admin or object owner updates the workspace bindings of a catalog, external location, or storage credential. |
|
CreateSecurableTagAssignment |
A tag assignment is created on a securable. |
|
CreateSubsecurableTagAssignment |
A tag assignment is created on a subsecurable. |
|
DeleteSecurableTagAssignment |
A tag assignment on a securable is deleted. |
|
DeleteSubsecurableTagAssignment |
A tag assignment on a subsecurable is deleted. |
|
ListSecurableTagAssignments |
A user requests a list of tag assignments on a securable. |
|
ListSubsecurableTagAssignments |
A user requests a list of tag assignments on a subsecurable. |
|
createEntityTagAssignment |
A tag assignment is created on a Unity Catalog entity. |
|
getEntityTagAssignment |
A user requests details of a tag assignment on a Unity Catalog entity. |
|
listEntityTagAssignments |
A user requests a list of tag assignments on a Unity Catalog entity. |
|
updateEntityTagAssignment |
A tag assignment on a Unity Catalog entity is updated. |
|
deleteEntityTagAssignment |
A tag assignment on a Unity Catalog entity is deleted. |
|
listSecurableTags |
A user requests a list of tags on a securable. |
|
createPolicy |
ABAC policy is created. |
|
deletePolicy |
ABAC policy is deleted. |
|
getPolicy |
User requests details about an ABAC policy. |
|
listPolicies |
User requests a list of ABAC policies. |
|
updatePolicy |
ABAC policy is updated. |
|
GetWorkspaceBindings |
User requests workspace binding details for a securable object. |
|
UpdateCatalogWorkspaceBindings |
User updates workspace bindings for a catalog. |
|
createCredential |
User creates a storage or service credential. |
|
deleteCredential |
User deletes a storage or service credential. |
|
getCredential |
User requests details about a storage or service credential. |
|
listCredentials |
User requests a list of storage and service credentials. |
|
updateCredential |
User updates a storage or service credential. |
|
validateCredential |
User validates a storage or service credential. |
|
createStorageLocation |
User creates a storage location. |
|
createMetastoreAssignment |
Admin assigns a metastore to a workspace. |
|
deleteMetastoreAssignment |
Admin removes a metastore assignment from a workspace. |
|
getCurrentMetastoreAssignment |
User requests current metastore assignment details. |
|
enableSystemSchema |
Admin enables a system schema. |
|
disableSystemSchema |
Admin disables a system schema. |
|
listSystemSchemas |
User requests a list of system schemas. |
|
getQuota |
User requests details about a resource quota. |
|
listQuotas |
User requests a list of resource quotas. |
|
getTableById |
User requests table details by table ID. |
|
listDroppedTables |
User requests a list of dropped tables. |
|
tableExists |
User checks if a table exists. |
|
undropTable |
User restores a dropped table. |
|
updateTableToManaged |
User converts an external table to a managed table. |
|
listAllVolumesInMetastore |
User requests a list of all volumes in a metastore. |
|
getArtifactAllowlist |
User requests details about the artifact allowlist. |
|
setArtifactAllowlist |
User updates the artifact allowlist. |
|
updateMLServingPermissions |
Service principal is granted permissions to deploy a model. |
|
Lineage tracking events
These events are logged at the account level, so workspace_id is recorded as 0. The originating workspace ID is included in request_params.workspace_id. This service includes events related to data lineage.
Note
Lineage tracking is a workspace feature, but its audit events appear at the account level in system.access.audit because Unity Catalog is an account-scoped service where a single metastore serves multiple workspaces. To scope lineage tracking events to a specific workspace, filter by request_params.workspace_id:
SELECT * FROM system.access.audit
WHERE service_name = 'lineageTracking'
AND request_params.workspace_id = '<workspace_id>'
These events are logged under the service_name of lineageTracking.
| action_name | Description | request_params |
|---|---|---|
listColumnLineages |
A user accesses the list of the upstream or downstream columns of a column. |
|
listSecurableLineagesBySecurable |
A user accesses the list of the upstream or downstream securables of a securable. |
|
listEntityLineagesBySecurable |
A user accesses the list of entities (notebooks, jobs, etc.) that write to or read a securable. |
|
getColumnLineages |
A user gets the column lineages for a table and its column. |
|
getTableEntityLineages |
A user gets the upstream and downstream lineages of a table. |
|
getJobTableLineages |
A user gets the upstream and downstream table lineages of a job. |
|
getFunctionLineages |
A user gets the upstream and downstream securables and entities (notebooks, jobs, etc.) of a function. |
|
getModelVersionLineages |
A user gets the upstream and downstream securables and entities (notebooks, jobs, etc.) of a model and its version. |
|
getEntityTableLineages |
A user gets the upstream and downstream tables of an entity (notebooks, jobs, etc.). |
|
getFrequentlyJoinedTables |
A user gets the frequently joined tables for a table. |
|
getFrequentQueryByTable |
A user gets the frequent queries for a table. |
|
getFrequentUserByTable |
A user gets the frequent users for a table. |
|
getTablePopularityByDate |
A user gets the popularity (query count) for a table for the past month. |
|
getPopularEntities |
A user gets the popular entities (notebooks, jobs, etc.) for a table. |
|
getPopularTables |
A user gets the table popularity info for a list of tables. |
|
listCustomLineages |
A user lists custom lineages for an entity. |
|
listSecurableByEntityEvent |
A user lists securables associated with entity events. |
|
Delta Sharing events
Note
This service is unavailable through Azure diagnostic settings. Enable the audit log system table to access these events.
Delta Sharing events are broken up into two sections: events recorded in the data provider's account and events recorded in the data recipient's account.
To learn how to use audit logs to monitor Delta Sharing events, see Audit and monitor data sharing.
Delta Sharing provider events
These audit log events are logged in the provider's account. Actions that are performed by recipients start with the deltaSharing prefix. Each of these logs also includes request_params.metastore_id, which is the metastore that manages the shared data, and userIdentity.email, which is the ID of the user who initiated the activity.
These events are logged under the service_name of unityCatalog.
| action_name | Description | request_params |
|---|---|---|
deltaSharingListShares |
A data recipient requests a list of shares. |
|
deltaSharingGetShare |
A data recipient requests details about a shares. |
|
deltaSharingListSchemas |
A data recipient requests a list of shared schemas. |
|
deltaSharingListAllTables |
A data recipient requests a list of all shared tables. |
|
deltaSharingListTables |
A data recipient requests a list of shared tables. |
|
deltaSharingGetTableMetadata |
A data recipient requests a details about a table's metadata. |
|
deltaSharingGetTableVersion |
A data recipient requests a details about a table version. |
|
deltaSharingQueryTable |
Logged when a data recipient queries a shared table. |
|
deltaSharingQueryTableChanges |
Logged when a data recipient queries change data for a table. |
|
deltaSharingQueriedTable |
Logged after a data recipient gets a response to their query. The response.result field includes more information on the recipient's query (see Audit and monitor data sharing) |
|
deltaSharingQueriedTableChanges |
Logged after a data recipient gets a response to their query. The response.result field includes more information on the recipient's query (see Audit and monitor data sharing). |
|
deltaSharingListNotebookFiles |
A data recipient requests a list of shared notebook files. |
|
deltaSharingQueryNotebookFile |
A data recipient queries a shared notebook file. |
|
deltaSharingListFunctions |
A data recipient requests a list of functions in a parent schema. |
|
deltaSharingListAllFunctions |
A data recipient requests a list of all shared functions. |
|
deltaSharingListFunctionVersions |
A data recipient requests a list of function versions. |
|
deltaSharingListVolumes |
A data recipient requests a list of shared volumes in a schema. |
|
deltaSharingListAllVolumes |
A data recipient requests all shared volumes. |
|
updateMetastore |
Provider updates their metastore. |
|
createRecipient |
Provider creates a data recipient. |
|
deleteRecipient |
Provider deletes a data recipient. |
|
getRecipient |
Provider requests details about a data recipient. |
|
listRecipients |
Provider requests a list of all their data recipients. | none |
rotateRecipientToken |
Provider rotates a recipient's token. |
|
updateRecipient |
Provider updates a data recipient's attributes. |
|
createShare |
Provider updates a data recipient's attributes. |
|
deleteShare |
Provider updates a data recipient's attributes. |
|
getShare |
Provider requests details about a share. |
|
updateShare |
Provider adds or removes data assets from a share. |
|
listShares |
Provider requests a list of their shares. | none |
getSharePermissions |
Provider requests details on a share's permissions. |
|
updateSharePermissions |
Provider updates a share's permissions. |
|
getRecipientSharePermissions |
Provider requests details about a recipient's share permissions. |
|
getActivationUrlInfo |
Provider requests details about activity on their activation link. |
|
generateTemporaryVolumeCredential |
Temporary credential is generated for the recipient to access a shared volume. |
|
generateTemporaryTableCredential |
Temporary credential is generated for the recipient to access a shared table. |
|
createRecipientOidcPolicy |
Provider creates an OIDC federation policy for a recipient. |
|
deleteRecipientPolicy |
Provider deletes a recipient policy. |
|
getRecipientOidcPolicy |
Provider requests details about a recipient's OIDC federation policy. |
|
getRecipientPropertiesByDependentId |
Provider requests recipient properties for a dependent object. |
|
listRecipientOidcPolicies |
Provider requests a list of OIDC federation policies for a recipient. |
|
reconnectRecipientAccount |
Provider reconnects a Databricks-to-Databricks recipient account. |
|
retrieveRecipientToken |
Recipient retrieves their bearer token for open sharing authentication. |
|
deltaSharingGetQueryInfo |
Provider requests query information for a shared table. |
|
deltaSharingReconciliation |
Delta Sharing performs reconciliation for a shared table. |
|
addShareToCatalog |
Recipient mounts a share to a catalog. |
|
listSharesInCatalog |
User requests a list of shares mounted in a catalog. |
|
removeShareFromCatalog |
Recipient unmounts a share from a catalog. |
|
listProviderShareAssets |
User requests a list of assets in a provider's share. |
|
listInboundSharedNotebookFiles |
Recipient requests a list of notebook files shared in a catalog. |
|
getInboundSharedNotebookFile |
Recipient requests details about a shared notebook file. |
|
listSharedCatalogs |
Provider requests a list of shared catalogs. |
|
Delta Sharing recipient events
These events are logged in the data recipient's account. These events record recipient access of shared data and AI assets, along with events associated with the management of providers. Each of these events also includes the following request parameters:
recipient_name: The name of the recipient in the data provider's system.metastore_id: The name of the metastore in the data provider's system.sourceIPAddress: The IP address where the request originated.
These events are logged under the service_name of unityCatalog.
| action_name | Description | request_params |
|---|---|---|
deltaSharingProxyGetTableVersion |
A data recipient requests details on a shared table version. |
|
deltaSharingProxyGetTableMetadata |
A data recipient requests details on a shared table's metadata. |
|
deltaSharingProxyQueryTable |
A data recipient queries a shared table. |
|
deltaSharingProxyQueryTableChanges |
A data recipient queries change data for a table. |
|
createProvider |
A data recipient creates a provider object. |
|
updateProvider |
A data recipient updates a provider object. |
|
deleteProvider |
A data recipient deletes a provider object. |
|
getProvider |
A data recipient requests details about a provider object. |
|
listProviders |
A data recipient requests a list of providers. | none |
activateProvider |
A data recipient activates a provider object. |
|
listProviderShares |
A data recipient requests a list of a provider's shares. |
|
Delta Sharing external Iceberg client events
Important
This feature is in Public Preview.
These events are logged at the account level for external Iceberg clients accessing shared data using the Apache Iceberg REST Catalog API. To learn more, see Enable sharing to external Iceberg clients.
These events are logged when external Iceberg clients (such as Snowflake or other non-Databricks systems) access shared data.
These events are logged under the service_name of dataSharing.
| action_name | Description | request_params |
|---|---|---|
icebergGetConfig |
An external Iceberg client requests configuration information. |
|
icebergListNamespaces |
An external Iceberg client requests a list of namespaces. |
|
icebergGetNamespace |
An external Iceberg client requests details about a namespace. |
|
icebergListTables |
An external Iceberg client requests a list of tables in a namespace. |
|
icebergLoadTable |
An external Iceberg client loads table metadata. |
|
icebergReportMetrics |
An external Iceberg client reports metrics. |
|
SQL table access events
Note
The sqlPermissions service includes events related to the legacy Hive metastore table access control. Databricks recommends that you upgrade the tables managed by the Hive metastore to the Unity Catalog metastore.
These events are logged at the workspace level.
These events are logged under the service_name of sqlPermissions.
| action_name | Description | request_params |
|---|---|---|
changeSecurableOwner |
Workspace admin or owner of an object transfers object ownership. |
|
createSecurable |
User creates a securable object. |
|
denyPermission |
Object owner denies privileges on a securable object. |
|
grantPermission |
Object owner grants permission on a securable object. |
|
removeAllPermissions |
User drops a securable object. |
|
renameSecurable |
User renames a securable object. |
|
requestPermissions |
User requests permissions on a securable object. |
|
revokePermission |
Object owner revokes permissions on their securable object. |
|
showPermissions |
User views securable object permissions. |
|
Deprecated log events
Databricks has deprecated the following serverlessRealTimeInference diagnostic events. These events were associated with Legacy MLflow Model Serving, which reached end of life on September 15, 2025.
enabledisable
Databricks has deprecated the following databrickssql diagnostic events:
createAlertDestination(nowcreateNotificationDestination)deleteAlertDestination(nowdeleteNotificationDestination)updateAlertDestination(nowupdateNotificationDestination)muteAlertunmuteAlert
SQL endpoint logs
If you create SQL warehouses using the deprecated SQL endpoint API (the former name for SQL warehouses), the corresponding audit event name will include the word Endpoint instead of Warehouse. Besides the name, these events are identical to the SQL warehouse events. To view descriptions and request parameters of these events, see their corresponding warehouse events in Databricks SQL events.
The SQL endpoint events are:
changeEndpointAclscreateEndpointeditEndpointstartEndpointstopEndpointdeleteEndpointsetEndpointConfig