View reports for Office 365 Advanced Threat Protection
If your organization has Office 365 Advanced Threat Protection (ATP) and you have the necessary permissions, you can use several ATP reports in the Security & Compliance Center. (Go to Reports > Dashboard.)
ATP reports include the following:
- Threat Protection Status report
- ATP File Types report
- ATP Message Disposition report
- either real-time detections or Explorer (depending on whether you have Office 365 ATP Plan 1 or 2)
- ... and more.
Read this article to get an overview of ATP reports and how to use them.
Threat Protection Status report
The Threat Protection Status report is a single view that brings together information about malicious content and malicious email detected and blocked by Exchange Online Protection (EOP) and Office 365 ATP. This report is useful for viewing detections over time (up to 90 days), and it enables security administrators to identify trends or determine whether policies need adjustments.
The Threat Protection Status report provides an aggregated count of unique email messages with malicious content, such as files or website addresses (URLs) that were blocked by the anti-malware engine, zero-hour auto purge (ZAP), and ATP features like ATP Safe Links, ATP Safe Attachments, and ATP anti-phishing capabilities.
A Threat Protection Status report is available to customers who have either Office 365 ATP or Exchange Online Protection (EOP); however, the information that is displayed in the Threat Protection Status report for ATP customers will likely contain different data than what EOP customers might see. For example, the Threat Protection Status report for ATP customers will contain information about malicious files detected in SharePoint Online, OneDrive, or Microsoft Teams. Such information is specific to ATP, so customers who have EOP but not ATP will not see those details in their Threat Protection Status report.
To view the Threat Protection Status report, in the Security & Compliance Center, go to Reports > Dashboard > Threat Protection Status.
To get detailed status for a day, hover over the graph.
By default, the Threat Protection Status report shows data for the past seven days. However, you can choose Filters and change the date range to view data for up to 90 days. (If you are using a trial subscription, you might be limited to 30 days' of data.)
You can also use the View data by menu to change what information is displayed in the report.
ATP File Types report
The ATP File Types report shows you the type of files detected as malicious by ATP Safe Attachments.
To view this report, in the Security & Compliance Center, go to Reports > Dashboard > ATP File Types.
ATP Message Disposition report
The ATP Message Disposition report shows you the actions that were taken for email messages that were detected as having malicious content.
To view this report, in the Security & Compliance Center, go to Reports > Dashboard > ATP Message Disposition.
When you hover over a bar in the chart, you can see what actions were taken for detected email for that day.
Additional reports to view
In addition to the ATP reports described in this article, several other reports are available, as described in the following table:
|Explorer or real-time detections (Office 365 ATP Plan 2 customers have Explorer; Office 365 ATP Plan 1 customers have real-time detections.)||Threat Explorer (and real-time detections)|
|Email security reports, such as a Top Senders and Recipients report, a Spoof Mail report, and a Spam Detections report.||View email security reports in the Security & Compliance Center|
|ATP Safe Links URL trace (This is a report you generate by using PowerShell.) This report shows the results of ATP Safe Links actions over the past seven (7) days.||Get-UrlTrace cmdlet reference|
|EOP and ATP results (This is a custom report you generate by using PowerShell). This report contains information, such as Domain, Date, Event Type, Direction, Action, and Message Count.||Get-MailTrafficATPReport cmdlet reference|
|EOP and ATP detections (This is a custom report you generate by using PowerShell). This report contains details about malicious files or URLs, phishing attempts, impersonation, and other potential threats in email or files.||Get-MailDetailATPReport cmdlet reference|
What permissions are needed to view the ATP reports?
In order to view and use the reports described in this article, you must have an appropriate role assigned for both the Security & Compliance Center and the Exchange admin center.
For the Security & Compliance Center, you must have one of the following roles assigned:
- Organization Management
- Security Administrator (this can be assigned in the Azure Active Directory admin center (https://aad.portal.azure.com))
- Security Reader
For Exchange Online, you must have one of the following roles assigned in either the Exchange admin center (https://outlook.office365.com/ecp) or with PowerShell cmdlets (See Exchange Online PowerShell):
- Organization Management
- View-only Organization Management
- View-Only Recipients role
- Compliance Management
To learn more, see the following resources:
What if the reports aren't showing data?
If you are not seeing data in your ATP reports, double-check that your policies are set up correctly. Your organization must have ATP Safe Links policies and ATP Safe Attachments policies defined in order for ATP protection to be in place. Also see Anti-spam and anti-malware protection in Office 365.