Office 365 报告 Web 服务
通过使用 Office 365 报告 Web 服务，开发人员可以将电子邮件和垃圾邮件、防病毒活动、遵从性状态及 Lync Online 活动的相关信息集成到其自定义服务报告应用程序和 Web 门户。本主题提供了 REST Web 服务、功能体系结构、可用报告及其他可以访问报告的方式的概述。
上次修改时间： 2015年12月7日
适用范围： Office 365
欢迎使用 Office 365 报告 Web 服务
通过使用 Office 365 报告 Web 服务，开发人员可以将电子邮件和垃圾邮件、防病毒活动、遵从性状态及 Lync Online 会议和会话的相关信息集成到其自定义服务报告应用程序和 Web 门户。管理门户中和可下载的 Microsoft Excel 电子表格中提供的，以及通过 Windows PowerShell cmdlet 访问的所有报告，均可使用报告 Web 服务访问。访问报告 Web 服务的用户在组织中必须具有管理权限。
管理员权限
若要查看报告，您需要具有 Office 365 的权限。如果无法查看，则请组织的管理员将您添加到一个管理员角色。建议您从最低级别的管理员范围"服务管理员"开始。您还可以请管理员创建一个单独的管理员帐户，仅用于浏览报告系统。
管理门户中的报告可从以下位置获取：https://portal.microsoftonline.com/Reports/AllReports.aspx。如果组织已激活并拥有大量用户，则可使用更多数据，但即使是小型组织，电子邮件中也可能包括很多垃圾邮件和恶意软件。
功能体系结构
下面的高级概念图揭示了报告系统的工作原理。
.png "Office 365 报告 Web 服务体系结构")
报告信息的主源是 Exchange Online 服务、Microsoft Forefront Protection 服务、Lync Online 服务、Exchange Server 邮箱服务器和 Active Directory 域服务 (AD DS)。各种源将日志信息存储在数据市场中。在 Office 365 运营规模上，数千台服务器可参与为报告系统提供源数据。
由于大量数据和复制延迟，数据要经过一小段时间才可供报告使用。通常只需数小时，但新帐户肯定会滞后。这意味着报告 Web 服务实际上不适于即时系统监控，而是更适于进行历史资源使用情况分析。
一旦报告数据出现在数据市场中，就可以在请求中返回到报告 Web 服务。Office 365 管理门户也可从报告 Web 服务中获取数据。
除报告 Web 服务外，您还可以使用其他三种方法检索报告。您已经了解有关 Web 服务和管理门户的信息，但还可以下载从 Web 服务获取其数据的可自定义的电子表格。此外，如果您需要 Windows PowerShell 脚本的数据，可以使用远程 Windows PowerShell 调用报告 cmdlet。下表中对检索报告的四种方式进行了比较。
获取报告的方法 |
易用性 |
可自定义 |
获取位置 |
|---|---|---|---|
Office 365 管理中心预定义的图表和列表 |
简单，交互状态和运行状况检查。 |
低。按日期、 触发的传输策略规则等进行交互式筛选。 |
https://portal.office365.com/admin/default.aspx#AllReportsRootV2。记住：您必须登录到具有访问报告的管理员权限的帐户。 |
可下载的电子表格 |
详细、灵活历史和实时服务数据分析，例如基于 Microsoft Excel 的记分卡中。 |
中。更新可能需要重新应用自定义及未公开的内部源代码。 |
https://www.microsoft.com/zh-cn/download/details.aspx?id=30716 |
Reporting PowerShell cmdlet |
需要编写脚本。用于在基于脚本的 IT 维护工具中定期生成的报告的精确数据。 |
高。非常适用于基于脚本的分析工具。 |
https://technet.microsoft.com/zh-cn/library/jj200677(v=exchg.150).aspx |
REST 报告 Web 服务 |
需要编程的服务监控门户，或者针对需要集成自定义和非 Office 365 服务的记分卡。 |
非常高。REST Web 服务提供 ODATA2 查询筛选和 Microsoft Visual Studio 中完全编程的 IDE。 |
https://reports.office365.com/ecp/reportingwebservice/reporting.svc |
使用四种不同的方式来获取数据，如何确保所有报告都返回相同的数据？电子表格和管理门户都调用报告 Web 服务，报告 Web 服务反过来也调用 Windows PowerShell cmdlet。您还可以直接调用这些 cmdlet。只有 Windows PowerShell cmdlet 可直接访问数据市场，这就确保每个不同类型的访问方式具有相同的数据。
报告 Web 服务由数据中心中的 Exchange Server 前端服务器处理，具有一些重要影响：其中之一是如果关闭电子邮件访问，通常报告也会关闭。此外，Exchange Server 具有网络带宽保护，保护形式为：有时可能会影响报告 Web 服务的响应"限制" 。但您不太可能受到影响，除非您要非常快速地请求大量详细报告。
服务说明文档和 MailFilterList 报告
报告 Web 服务使用组织订阅选项、配置设置和用户权限控制对报告和报告中可用选项的访问。
访问报告 Web 服务的应用程序需要从 Web 服务发起两个初始请求。第一个是服务说明文档 reporting.svc，此 XML 文档告诉应用程序经过身份验证的用户可以访问哪些报告。如果报告包含在 reporting.svc 文档中，则用户可以访问该报告。有关详细信息，请参阅 Office 365 报告 Web 服务 reporting.svc 文档。
应用程序通常发起的第二个请求会检索 MailFilterList 报告，这对自定义应用程序的运行至关重要。MailFilterList 报告提供多种类别的字符串值，其他报告也将一同使用这些字符串值。有关详细信息，请参阅 MailFilterList 报告。
报告 Web 服务中可用的报告
下表说明了 Web 服务中可用的报告。Office 365 报告 Web 服务中可用的 Exchange 报告和 Office 365 报告 Web 服务中可用的 Lync 报告提供了完整信息。
报告 |
说明 |
|---|---|
组织的用户在报告期间使用的电子邮件客户端访问方法的数量和类型。例如，Outlook Web Access、Exchange Web 服务等。 |
|
报告期间处于活动状态的已登录 Lync Online 用户数量 |
|
已登录的组织用户在报告期间参加 Lync Online 会议的时间量 |
|
报告期间 Lync Online 会议和对等会话的计数。 |
|
创建和删除的 Office 365 用户组，在指示的时间段汇总。 |
|
创建和删除的 Office 365 用户，在指示的时间段汇总。Active Directory 域服务 (AD DS) 复制有时可能将此信息延迟多达一天。 |
|
组织用户邮箱的摘要和详细统计信息。 |
|
虽然在服务文档中出现，它不会返回任何数据，因此不调用它。 |
|
有关触发了数据丢失防护 (DLP) 策略规则的邮件的详细信息。 |
|
包含在传入和传出电子邮件中检测到的恶意软件的邮件。 |
|
包含在传入和传出电子邮件中检测到的垃圾邮件的邮件。 |
|
在处理单个电子邮件时所使用的 Exchange Server 传输规则。 |
|
在请求其他报告时用作选项的定义字符串常量。 |
|
触发了 DLP 策略规则的邮件。 |
|
发送给组织外部域及接收来自组织外部域的邮件数量。 |
|
列出检测到的主要用户、事件和恶意软件等多种选择的报告。 |
|
已发送和收到大多数邮件的用户。 |
|
有关指定电子邮件如何通过 Office 365 系统进行传输的分步和详细历史记录，有助于诊断传递问题。 |
|
返回邮件交换器 (MX) DNS 记录的当前设置和状态。 |
|
有关针对组织定义的出站邮件（发送）连接器当前设置和状态的信息。 |
|
在指示的时间段内尚未使用的邮箱的详细信息和概要计数。 |