MessageTrace 報告

MessageTrace REST URI 提供電子郵件已傳遞到組織中過去 30 天的Office 365系統處理的摘要的資訊。這份報告通常搭配MessageTraceDetail 報告判斷為什麼郵件未傳送來自使用者如預期般運作。

前次修改時間: 2015年9月17日

適用於: Office 365

REST Uri

https://reports.office365.com/ecp/reportingwebservice/reporting.svc/MessageTrace[?ODATA options]

欄位

您可以指定下列欄位中$select、 $filter，以及$orderby ODATA2 查詢選項。如果沒有$select選項提供會傳回所有欄位。

名稱	WCF 類型 *	EDM 類型 *	[以/照] * * 描述	範例值	新增服務版本
EndDate	System.DateTime	Edm.DateTime	[In此欄位用來限制在報告期間。使用此欄位$filter查詢選項可設定的結束日期和時間的報表期間。如果您提供EndDate$filter ] 選項，您也必須提供StartDate。在此報告中，此欄位會對應至的日期和時間的記錄訊息的最後一個處理步驟。	簡短日期(例如03/10/2013) 或使用引號 (例如"03/10/2013 4:55 PM") 的日期時間	2013-V1
FromIP	string	None 指定	[納入/剔除]傳送至Office 365電子郵件系統訊息的 IPv4 或 IPv6 位址。	192.168.0.205	2013-V1
MessageId	string	None 指定	[納入/剔除]提供郵件，如果有一個網際網路MessageID標頭。這個值也可以是明確null。	如果沒有 ID 提供給郵件，報告資料會顯示<d:MessageId m:null="true" /> Atom 和"MessageId":null JSON	2013-V1
MessageTraceId	System.Guid	Edm.Guid	[納入/剔除]用來取得的詳細的訊息識別碼傳輸追蹤資訊。	ae4ad8f6-7613-411c-e67e-08cfc740629	2013-V1
Organization	string	None 指定	[納入/剔除]已處理的電子郵件的完整的網域名稱。	example.onmicrosoft.com	2013-V1
Received	System.DateTime	Edm.DateTime	[納入/剔除]日期及時間時Office 365電子郵件系統所收到的電子郵件。這會對應至第一個的郵件追蹤詳細項目的 [ Date ] 欄位。	2013-01-09T07:32:54Z	2013-V1
RecipientAddress	string	None 指定	[納入/剔除]郵件已傳送給使用者的 SMTP 電子郵件地址。	userone@example.onmicrosoft.com	2013-V1
SenderAddress	string	None 指定	[納入/剔除]使用者郵件的 SMTP 電子郵件地址據稱是已從。寄件者地址通常詐騙垃圾電子郵件，因為他們未被視為完全可靠。	usertwo@example.onmicrosoft.com	2013-V1
Size	int	Edm.Int64	[納入/剔除]以位元組為單位之郵件的大小。	39405	2013-V1
StartDate	System.DateTime	Edm.DateTime	[In此欄位用來限制在報告期間。若要設定的開始日期和時間的報表期間使用$filter查詢選項中的此欄位。如果您提供StartDate$filter ] 選項，您還必須指定EndDate。在此報告中，此欄位會對應至的日期和時間的記錄訊息的第一個處理步驟。	簡短日期(例如03/10/2013) 或使用引號 (例如"03/10/2013 4:55 PM") 的日期時間	2013-V1
Status	string	None 指定	[納入/剔除]Office 365電子郵件系統中的郵件狀態。此值對應至記錄訊息的最後一個處理步驟Detail欄位。	Delivered	2013-V1
Subject	string	None 指定	[納入/剔除]如果其中一個已存在之郵件的郵件主旨行。	Free M0ney WoN!	2013-V1
ToIP	string	None 指定	[納入/剔除]IPv4 或 IPv6 位址Office 365電子郵件系統傳送的訊息。	192.168.0.215	2013-V1

* WCF 類型參照Visual Studio中建立Windows Communication Foundation (WCF)服務參考時指定給欄位的.NET Framework資料類型。EDM 類型參照傳回 Atom 格式化報告中的 ADO.NET 實體資料模型 (EDM) 類型。

* * 如需 [納入/剔除] 指標，請參閱 「 輸入參數和報告輸出欄 」 一節。

備註

在報表中的每個項目包含數個欄位的中繼資料。如需詳細資訊請參閱一般 Office 365 報告 web 服務所傳回的中繼資料。

Date欄位表示郵件時Office 365系統會處理與報告中的這些伺服器的時區。

這份報告會提供之訊息的傳遞透過電子郵件系統，更詳細追蹤資訊是可用的摘要資訊。若要取得該詳細的追蹤資訊，您的應用程式可以使用MessageTraceDetail報表。請務必在應用程式提供所有的下列資訊以取得詳細的追蹤資訊。如需追蹤郵件的詳細資訊，請參閱如何： 在 Office 365 追蹤電子郵件訊息。

• MessageTraceId從MessageTrace報表輸出的 GUID。

• RecipientAddress郵件已傳送至。

• SenderAddress隨附的郵件。

• StartDate和EndDate識別其處理郵件的期間。

使用 StartDate 和 EndDate

StartDate和EndDate欄位無法提供報表結果中的實用資訊以及一律設為0001-01-01T00:00:00Z報表在輸出中。它們都是要啟用的報告的時間間隔，輕鬆限制，並提供比就是可在 「 每日 」 報表 rlo 的精確度。

例如，錄製每小時為基礎的電子郵件型拒絕服務攻擊時這可以是特別有用。時使用這些欄位，則必須包含兩者$filter ] 選項。兩者都視為選擇性的但如果您提供一個，您必須提供其他。如果查詢中未提供 StartDate/EndDate 對預設的報表期間為前兩週。本主題稍後的 「 範例 」 一節示範如何使用StartDate和EndDate欄位。

MessageTrace 報表中，這些欄位會傳回您傳遞 $filter 選項中的時間。收到日期] 欄位會指出當系統所收到郵件。失敗訊息這可跨幾天。

範例

下列範例會示範如何要求先前 48 小時、 郵件追蹤資訊這是預設的時段。

https://reports.office365.com/ecp/reportingwebservice/reporting.svc/MessageTrace?

<?xml version="1.0" encoding="utf-8"?>
<feed xml:base="https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/" 
    xmlns="http://www.w3.org/2005/Atom" 
    xmlns:d="https://schemas.microsoft.com/ado/2007/08/dataservices"
    xmlns:m="https://schemas.microsoft.com/ado/2007/08/dataservices/metadata">
  <id>https://reports.office365.com/ecp/reportingwebservice/reporting.svc/MessageTrace</id>
  <title type="text">MessageTrace</title>
  <updated>2013-02-09T23:10:29Z</updated>
  <link rel="self" title="MessageTrace" href="MessageTrace" />
  <entry>
    <id>https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/MessageTrace(0)</id>
    <category term="TenantReporting.MessageTrace" 
      scheme="https://schemas.microsoft.com/ado/2007/08/dataservices/scheme" />
    <link rel="edit" title="MessageTrace" href="MessageTrace(0)" />
    <title />
    <updated>2013-02-09T23:10:29Z</updated>
    <author>
      <name />
    </author>
    <content type="application/xml">
      <m:properties>
        <d:Organization>example.onmicrosoft.com</d:Organization>
        <d:MessageId>&lt;8CFD41EEA339B87-1048-248A6@servername.organization.example.com&gt;</d:MessageId>
        <d:Received m:type="Edm.DateTime">2013-02-08T14:22:55.2046427</d:Received>
        <d:SenderAddress>useone@example.com</d:SenderAddress>
        <d:RecipientAddress>usertwo@example.onmicrosoft.com</d:RecipientAddress>
        <d:Subject>Test Inbound Eicar 20130208 - 922AM</d:Subject>
        <d:Status>Failed</d:Status>
        <d:ToIP m:null="true" />
        <d:FromIP>192.168.0.1</d:FromIP>
        <d:Size m:type="Edm.Int32">3584</d:Size>
        <d:MessageTraceId m:type="Edm.Guid">4682e74e-a81a-4760-c35b-08cfd41eebc2</d:MessageTraceId>
        <d:StartDate m:type="Edm.DateTime">2013-02-07T23:10:28.6473929Z</d:StartDate>
        <d:EndDate m:type="Edm.DateTime">2013-02-09T23:10:28.6473929Z</d:EndDate>
        <d:Index m:type="Edm.Int32">0</d:Index>
      </m:properties>
    </content>
  </entry>
</feed>

輸入參數並報告輸出欄

在 [欄位] 表格中的 [納入/剔除] 指標具有下列含義：

• 表主要用於$filter=、 $orderby=、 欄位中的欄位標示為 [In 和其他查詢選項會限制報告傳回的項目。$select= ] 選項，可以包含 [欄位] 表格中標示為 [中] 的欄位和他們會出現在報表項目，但他們會包含任何的有用資料。

• 欄位標記 [納入/剔除] 欄選取範圍 ($select=) 及項目限制 ($filter=和$orderby=) 選項中可用資料表的欄位中。加入時這些欄位之一$select= ] 選項，它將會出現在報表項目並可用時將會包含有用的資料。

相容性

Office 365 service version 2013-V1中已採用 MessageTrace 報表。如需有關版本設定的詳細資訊，請參閱在 「 Office 365 報告 」 web 服務的版本控制。

相對應的 Windows PowerShell cmdlet

MessageTrace 報表會傳回資訊與Get-messagetrace Windows PowerShell指令程式相同。

權限

您用來存取報告的帳戶必須在Office 365組織中有系統管理權限。如果帳戶可以Office 365 [控制台] 中檢視這份報告的帳戶已從 REST web 服務擷取資料的權限。這份報告要求使用者指派給 「 僅檢視收件者 」 角色。在預設Office 365權限結構上使用下列的系統管理員權限的使用者可以存取此報告： 帳務管理員、 全域管理員、 密碼管理員、 服務管理員及使用者管理管理員。如需詳細資訊，請參閱MailboxUsage 報告。

資料精確度、 保存及可用性

這份報告中提供的資訊包含的確切的日期和時間為每個事件。您可以使用任何合適的時間和工期由$filter選項包括StartDate和EndDate欄位。時間報告以掃描電子郵件伺服器的時區。

這份報告的資訊是可用的一段的 30 天或直到取消訂閱。

事件可能最多它們顯示在報表中前 24 小時的延遲。