Using auditing within your organization
Knowing who is taking what action on which item in your Power BI tenant can be critical in helping your organization fulfill its requirements, such as meeting regulatory compliance and records management. Use Power BI auditing to audit actions performed by users, such as "View Report" and "View Dashboard". You cannot use auditing to audit permissions.
You work with auditing in the Office 365 Security and Compliance Center or use PowerShell. Auditing relies on functionality in Exchange Online, which is automatically provisioned to support Power BI.
You can filter the audit data by date range, user, dashboard, report, dataset and activity type. You can also download the activities in a csv (comma separated value) file to analyze offline.
You must meet these requirements to access audit logs:
You must either be a global admin or be assigned the Audit Logs or View-Only Audit Logs role in Exchange Online to access the audit log. By default, these roles are assigned to the Compliance Management and Organization Management role groups on the Permissions page in the Exchange admin center.
To provide non-administrator accounts with access to the audit log, you must add the user as a member of one of these role groups. Alternatively, you can create a custom role group in the Exchange admin center, assign the Audit Logs or View-Only Audit Logs role to this group, and then add the non-administrator account to the new role group. For more information, see Manage role groups in Exchange Online.
If you can't access the Exchange admin center from the Office 365 admin center, go to https://outlook.office365.com/ecp and sign in using your credentials.
If you have access to the audit log but are not a global admin or Power BI Service admin, you will not have access to the Power BI Admin portal. In this case, you must use a direct link to the Office 365 Security & Compliance Center.
Accessing your audit logs
To access logs, first make sure that logging is enabled in Power BI. For more information, see Audit logs in the admin portal documentation. There can be up to a 48 hour delay between enabling auditing and being able to view audit data. If you don't see data immediately, check the audit logs later. There can be a similar delay between getting permission to view audit logs and being able to access the logs.
The Power BI audit logs are available directly through the Office 365 Security & Compliance Center. There is also a link from the Power BI admin portal:
In Power BI, select the gear icon in the upper right, then select Admin portal.
Select Audit logs.
Select Go to O365 Admin Center.
Search only Power BI activities
Restrict results to only Power BI activities by following these steps. For a list of activities, see the list of activities audited by Power BI later in this article.
On the Audit log search page, under Search, select the drop down for Activities.
Select Power BI activities.
Select anywhere outside of the selection box to close it.
Your searches will now be filtered to only Power BI activities.
Search the audit logs by date
You can search the logs by date range using the Start date and End date fields. The last seven days are selected by default. The date and time are presented in Coordinated Universal Time (UTC) format. The maximum date range that you can specify is 90 days.
An error is displayed if the selected date range is greater than 90 days. If you're using the maximum date range of 90 days, select the current time for Start date. Otherwise, you'll receive an error saying that the start date is earlier than the end date. If you've turned on auditing within the last 90 days, the date range can't start before the date that auditing was turned on.
Search the audit logs by users
You can search for audit log entries for activities performed by specific users. To do this, enter one or more user names in the Users field. The user name looks like an email address; it's the account that users log into Power BI with. Leave this box blank to return entries for all users (and service accounts) in your organization.
View search results
After you select Search, the search results are loaded and after a few moments they are displayed under Results. When the search is finished, the number of results found is displayed. A maximum of 1000 events is displayed, If more than 1000 events meet the search criteria, the newest 1000 events are displayed.
View the main results
The Results area contains the following information for each event returned by the search. Select a column header under Results to sort the results.
|Date||The date and time (in UTC format) when the event occurred.|
|IP address||The IP address of the device that was used when the activity was logged. The IP address is displayed in either an IPv4 or IPv6 address format.|
|User||The user (or service account) who performed the action that triggered the event.|
|Activity||The activity performed by the user. This value corresponds to the activities that you selected in the Activities drop down list. For an event from the Exchange admin audit log, the value in this column is an Exchange cmdlet.|
|Item||The object that was created or modified as a result of the corresponding activity. For example, the file that was viewed or modified, or the user account that was updated. Not all activities have a value in this column.|
|Detail||Additional detail about an activity. Again, not all activities will have a value.|
View the details for an event
You can view more details about an event by clicking the event record in the list of search results. A Details page is displayed that contains the detailed properties from the event record. The properties that are displayed depend on the Office 365 service in which the event occurs.
To display these details, select More information. All Power BI entries have a value of 20 for the RecordType property. For information about other properties, see Detailed properties in the audit log.
Export search results
To export the Power BI audit log to a csv file, follow these steps.
Select Export results.
Select either Save loaded results or Download all results.
Use PowerShell to search audit logs
You can also use PowerShell to access the audit logs based on your login. The following example shows how to connect to Exchange Online PowerShell and then use the Search-UnifiedAuditLog command to pull Power BI audit log entries. To run the script, you must be assigned the appropriate permissions, as described in the Requirements section.
Set-ExecutionPolicy RemoteSigned $UserCredential = Get-Credential $Session = New-PSSession -ConfigurationName Microsoft.Exchange -ConnectionUri https://outlook.office365.com/powershell-liveid/ -Credential $UserCredential -Authentication Basic -AllowRedirection Import-PSSession $Session Search-UnifiedAuditLog -StartDate 9/11/2018 -EndDate 9/15/2018 -RecordType PowerBI -ResultSize 1000 | Format-Table | More
For more information on connecting to Exchange Online, see Connect to Exchange Online PowerShell. For another example of using PowerShell with audit logs, see Using Power BI audit log and PowerShell to assign Power BI Pro licenses.
Activities audited by Power BI
The following activities are audited by Power BI.
|Friendly name||Operation name||Notes|
|Added data source to Power BI gateway||AddDatasourceToGateway|
|Added Power BI folder access||AddFolderAccess||Not currently used|
|Added Power BI group members||AddGroupMembers|
|Admin attached dataflow storage account to tenant||AdminAttachedDataflowStorageAccountToTenant||Not currently used|
|Analyzed Power BI dataset||AnalyzedByExternalApplication|
|Analyzed Power BI report||AnalyzeInExcel|
|Binded Power BI dataset to gateway||BindToGateway|
|Changed capacity state||ChangeCapacityState|
|Changed capacity user assignment||UpdateCapacityUsersAssignment|
|Changed Power BI dataset connections||SetAllConnections|
|Changed Power BI gateway admins||ChangeGatewayAdministrators|
|Changed Power BI gateway data source users||ChangeGatewayDatasourceUsers|
|Created organizational Power BI content pack||CreateOrgApp|
|Created Power BI app||CreateApp|
|Created Power BI dashboard||CreateDashboard|
|Created Power BI dataflow||CreateDataflow|
|Created Power BI dataset||CreateDataset|
|Created Power BI email subscription||CreateEmailSubscription|
|Created Power BI folder||CreateFolder|
|Created Power BI gateway||CreateGateway|
|Created Power BI group||CreateGroup|
|Created Power BI report||CreateReport|
|Dataflow migrated to external storage account||DataflowMigratedToExternalStorageAccount||Not currently used|
|Dataflow permissions added||DataflowPermissionsAdded||Not currently used|
|Dataflow permissions removed||DataflowPermissionsRemoved||Not currently used|
|Deleted organizational Power BI content pack||DeleteOrgApp|
|Deleted Power BI comment||DeleteComment|
|Deleted Power BI dashboard||DeleteDashboard||Not currently used|
|Deleted Power BI dataflow||DeleteDataflow||Not currently used|
|Deleted Power BI dataset||DeleteDataset|
|Deleted Power BI email subscription||DeleteEmailSubscription|
|Deleted Power BI folder||DeleteFolder|
|Deleted Power BI folder access||DeleteFolderAccess||Not currently used|
|Deleted Power BI gateway||DeleteGateway|
|Deleted Power BI group||DeleteGroup|
|Deleted Power BI report||DeleteReport|
|Discovered Power BI dataset data sources||GetDatasources|
|Downloaded Power BI report||DownloadReport|
|Edited Power BI certification permission||EditCertificationPermission||Not currently used|
|Edited Power BI dashboard||EditDashboard||Not currently used|
|Edited Power BI dataset||EditDataset|
|Edited Power BI dataset properties||EditDatasetProperties||Not currently used|
|Edited Power BI report||EditReport|
|Exported Power BI dataflow||ExportDataflow|
|Exported Power BI report visual data||ExportReport|
|Exported Power BI tile data||ExportTile|
|Failed to add dataflow permissions||FailedToAddDataflowPermissions||Not currently used|
|Failed to remove dataflow permissions||FailedToRemoveDataflowPermissions||Not currently used|
|Generated Power BI dataflow SAS token||GenerateDataflowSasToken|
|Generated Power BI Embed Token||GenerateEmbedToken|
|Imported file to Power BI||Import|
|Installed Power BI app||InstallApp|
|Migrated workspace to a capacity||MigrateWorkspaceIntoCapacity|
|Posted Power BI comment||PostComment|
|Printed Power BI dashboard||PrintDashboard|
|Printed Power BI report page||PrintReport|
|Published Power BI report to web||PublishToWebReport|
|Received Power BI dataflow secret from Key Vault||ReceiveDataflowSecretFromKeyVault||Not currently used|
|Removed data source from Power BI gateway||RemoveDatasourceFromGateway|
|Removed Power BI group members||DeleteGroupMembers|
|Removed workspace from a capacity||RemoveWorkspacesFromCapacity|
|Renamed Power BI dashboard||RenameDashboard|
|Requested Power BI dataflow refresh||RequestDataflowRefresh||Not currently used|
|Requested Power BI dataset refresh||RefreshDataset|
|Retrieved Power BI workspaces||GetWorkspaces|
|Set scheduled refresh on Power BI dataflow||SetScheduledRefreshOnDataflow|
|Set scheduled refresh on Power BI dataset||SetScheduledRefresh|
|Shared Power BI dashboard||ShareDashboard|
|Shared Power BI report||ShareReport|
|Started Power BI extended trial||OptInForExtendedProTrial||Not currently used|
|Started Power BI trial||OptInForProTrial|
|Took over a Power BI datasource||TakeOverDatasource|
|Took over Power BI dataset||TakeOverDataset|
|Unpublished Power BI app||UnpublishApp|
|Update capacity resource governance settings||UpdateCapacityResourceGovernanceSettings||Not currently in Office 365 admin portal|
|Updated capacity admin||UpdateCapacityAdmins|
|Updated capacity display name||UpdateCapacityDisplayName|
|Updated organization's Power BI settings||UpdatedAdminFeatureSwitch|
|Updated Power BI app||UpdateApp|
|Updated Power BI dataflow||UpdateDataflow|
|Updated Power BI dataset data sources||UpdateDatasources|
|Updated Power BI dataset parameters||UpdateDatasetParameters|
|Updated Power BI email subscription||UpdateEmailSubscription|
|Updated Power BI folder||UpdateFolder|
|Updated Power BI folder access||UpdateFolderAccess|
|Updated Power BI gateway data source credentials||UpdateDatasourceCredentials|
|Viewed Power BI dashboard||ViewDashboard|
|Viewed Power BI dataflow||ViewDataflow|
|Viewed Power BI report||ViewReport|
|Viewed Power BI tile||ViewTile|
|Viewed Power BI usage metrics||ViewUsageMetrics|
More questions? Try asking the Power BI Community
We'd love to hear your thoughts. Choose the type you'd like to provide:
Our feedback system is built on GitHub Issues. Read more on our blog.