MessageTraceDetail 報告
MessageTraceDetail REST URI 提供已通過Office 365系統過去 30 天的組織的電子郵件訊息上執行的處理步驟的詳細的資訊。這份報告通常搭配MessageTrace 報告判斷為什麼郵件未傳送來自使用者如預期般運作。
前次修改時間: 2015年9月17日
適用於: Office 365
REST Uri
https://reports.office365.com/ecp/reportingwebservice/reporting.svc/MessageTraceDetail[?ODATA options]
欄位
您可以指定下列欄位中$select、 $filter，以及$orderby ODATA2 查詢選項。如果沒有$select選項提供會傳回所有欄位。
名稱 |
WCF 類型 * |
EDM 類型 * |
[以/照] * * 描述 |
範例值 |
新增服務版本 |
|---|---|---|---|---|---|
Action |
string |
None 指定 |
[納入/剔除]如果有任何電子郵件訊息上採取的動作的描述。此欄位可能會是空白的如果則為 null 來執行任何動作。如需有效Action值的資訊，請參閱MailFilterList 報告。 |
SetSpamConfidenceLevel, RejectMessage |
2013-V1 |
Data |
string |
None 指定 |
[納入/剔除]Office 365內部處理的詳細資料 URI 逸出字元的 XML。這項資訊可能有用Office 365支援來協助您解決郵件流程問題。 |
<root><MEP ... Name="ServerHostName" String="ADSF123ASDF"/></root> |
2013-V1 |
Date |
System.DateTime |
Edm.DateTime |
[納入/剔除]日期及時間郵件被視為包含惡意程式碼。 |
簡短日期(例如03/10/2013) 或使用引號 (例如"03/10/2013 4:55 PM") 的日期時間 |
2013-V1 |
Detail |
string |
None 指定 |
[納入/剔除]說明處理步驟執行。這項資訊可能有用Office 365支援來協助您解決郵件流程問題。 |
Message received by: ADSF123ASDF |
2013-V1 |
EndDate |
System.DateTime |
Edm.DateTime |
[In此欄位用來限制在報告期間。使用此欄位$filter查詢選項可設定的結束日期和時間的報表期間。如果您提供EndDate$filter ] 選項，您也必須提供StartDate。 |
簡短日期(例如03/10/2013) 或使用引號 (例如"03/10/2013 4:55 PM") 的日期時間 |
2013-V1 |
Event |
string |
None 指定 |
[納入/剔除]處理步驟的簡短說明。 |
RECEIVE, FAIL |
2013-V1 |
MessageId |
string |
None 指定 |
[納入/剔除]提供郵件，如果有一個網際網路MessageId標頭。這個值也可以是明確null。 |
如果沒有 ID 提供給郵件，報告資料會顯示<d:MessageId m:null="true" /> Atom 和"MessageId":null JSON |
2013-V1 |
MessageTraceId |
System.Guid |
Edm.Guid |
[In用來取得詳細的郵件傳輸追蹤資訊識別碼。 |
ae4ad8f6-7613-411c-e67e-08cfc740629 |
2013-V1 |
Organization |
string |
None 指定 |
[納入/剔除]已處理的電子郵件的完整的網域名稱。 |
example.onmicrosoft.com |
2013-V1 |
RecipientAddress |
string |
None 指定 |
[In郵件已傳送給使用者的 SMTP 電子郵件地址。 |
userone@example.onmicrosoft.com |
2013-V1 |
SenderAddress |
string |
None 指定 |
[In使用者郵件的 SMTP 電子郵件地址據稱是已從。寄件者地址通常詐騙垃圾電子郵件，因為他們未被視為完全可靠。 |
usertwo@example.onmicrosoft.com |
2013-V1 |
StartDate |
System.DateTime |
Edm.DateTime |
[In此欄位用來限制在報告期間。若要設定的開始日期和時間的報表期間使用$filter查詢選項中的此欄位。如果您提供StartDate$filter ] 選項，您還必須指定EndDate。 |
簡短日期(例如03/10/2013) 或使用引號 (例如"03/10/2013 4:55 PM") 的日期時間 |
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摘要報告，這些欄位永遠是空的這份報告 (0001-01-01T00:00:00)。
範例
下列範例會要求及回應使用資訊從MessageTrace報表，並決定因為偵測到惡意程式碼內它已刪除郵件。MessageTraceDetail報告輸出顯示三個事件： 接收郵件、 郵件傳遞故障，然後因為包含惡意程式碼要刪除的郵件。
https://reports.office365.com/ecp/reportingwebservice/reporting.svc/MessageTraceDetail?
$select=Action,Data,Date,Detail,EndDate,Event,Index,MessageId,MessageTraceId,Organization,
RecipientAddress,SenderAddress,StartDate&
$filter=MessageTraceId%20eq%20guid'4682e74e-a81a-4760-c35b-08cfd41eebc2'%20and%20
RecipientAddress%20eq%20'usertwo@example.onmicrosoft.com'%20and%20
SenderAddress%20eq%userone@example.com'%20and%20
StartDate%20eq%20datetime'2013-02-08T00:00:00Z'%20and%20
EndDate%20eq%20datetime'2013-02-09T00:00:00Z'&
$format=Atom
<?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/MessageTraceDetail</id>
<title type="text">MessageTraceDetail</title>
<updated>2013-02-09T23:13:25Z</updated>
<link rel="self" title="MessageTraceDetail" href="MessageTraceDetail" />
<entry>
<id>https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/MessageTraceDetail(0)</id>
<category term="TenantReporting.MessageTraceDetail"
scheme="https://schemas.microsoft.com/ado/2007/08/dataservices/scheme" />
<link rel="edit" title="MessageTraceDetail" href="MessageTraceDetail(0)" />
<title />
<updated>2013-02-09T23:13:25Z</updated>
<author>
<name />
</author>
<content type="application/xml">
<m:properties>
<d:Organization>example.onmicrosoft.com</d:Organization>
<d:MessageId><8CFD41EEA339B87-1048-248A6@servername.organization.example.com></d:MessageId>
<d:MessageTraceId m:type="Edm.Guid">4682e74e-a81a-4760-c35b-08cfd41eebc2</d:MessageTraceId>
<d:Date m:type="Edm.DateTime">2013-02-08T14:22:55.937</d:Date>
<d:Event>RECEIVE</d:Event>
<d:Action m:null="true" />
<d:Detail>Message received by: ADSF123ASDF</d:Detail>
<d:Data><root><MEP ... Name="ServerHostName" String="ADSF123ASDF"/></root></d:Data>
<d:SenderAddress m:null="true" />
<d:RecipientAddress m:null="true" />
<d:StartDate m:type="Edm.DateTime">0001-01-01T00:00:00</d:StartDate>
<d:EndDate m:type="Edm.DateTime">0001-01-01T00:00:00</d:EndDate>
<d:Index m:type="Edm.Int32">0</d:Index>
</m:properties>
</content>
</entry>
<entry>
<id>https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/MessageTraceDetail(1)</id>
<category term="TenantReporting.MessageTraceDetail"
scheme="https://schemas.microsoft.com/ado/2007/08/dataservices/scheme" />
<link rel="edit" title="MessageTraceDetail" href="MessageTraceDetail(1)" />
<title />
<updated>2013-02-09T23:13:25Z</updated>
<author>
<name />
</author>
<content type="application/xml">
<m:properties>
<d:Organization>example.onmicrosoft.com</d:Organization>
<d:MessageId><8CFD41EEA339B87-1048-248A6@servername.organization.example.com></d:MessageId>
<d:MessageTraceId m:type="Edm.Guid">4682e74e-a81a-4760-c35b-08cfd41eebc2</d:MessageTraceId>
<d:Date m:type="Edm.DateTime">2013-02-08T14:22:55.97</d:Date>
<d:Event>FAIL</d:Event>
<d:Action m:null="true" />
<d:Detail>The message was not delivered.</d:Detail>
<d:Data><root><MEP Name="SourceContext" String="Malware Agent"/></root></d:Data>
<d:SenderAddress m:null="true" />
<d:RecipientAddress m:null="true" />
<d:StartDate m:type="Edm.DateTime">0001-01-01T00:00:00</d:StartDate>
<d:EndDate m:type="Edm.DateTime">0001-01-01T00:00:00</d:EndDate>
<d:Index m:type="Edm.Int32">1</d:Index>
</m:properties>
</content>
</entry>
<entry>
<id>https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/MessageTraceDetail(2)</id>
<category term="TenantReporting.MessageTraceDetail"
scheme="https://schemas.microsoft.com/ado/2007/08/dataservices/scheme" />
<link rel="edit" title="MessageTraceDetail" href="MessageTraceDetail(2)" />
<title />
<updated>2013-02-09T23:13:25Z</updated>
<author>
<name />
</author>
<content type="application/xml">
<m:properties>
<d:Organization>example.onmicrosoft.com</d:Organization>
<d:MessageId><8CFD41EEA339B87-1048-248A6@servername.organization.example.com></d:MessageId>
<d:MessageTraceId m:type="Edm.Guid">4682e74e-a81a-4760-c35b-08cfd41eebc2</d:MessageTraceId>
<d:Date m:type="Edm.DateTime">2013-02-08T14:22:55.97</d:Date>
<d:Event>Malware</d:Event>
<d:Action>Delete message</d:Action>
<d:Detail>Malware: EICAR_Test_File File: Message Body</d:Detail>
<d:Data><root><MEP ... String="Message Body"/></root></d:Data>
<d:SenderAddress m:null="true" />
<d:RecipientAddress m:null="true" />
<d:StartDate m:type="Edm.DateTime">0001-01-01T00:00:00</d:StartDate>
<d:EndDate m:type="Edm.DateTime">0001-01-01T00:00:00</d:EndDate>
<d:Index m:type="Edm.Int32">2</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
MessageTraceDetail 報表會傳回資訊與Get-messagetracedetail Windows PowerShell指令程式相同。
權限
您用來存取報告的帳戶必須在Office 365組織中有系統管理權限。如果帳戶可以Office 365 [控制台] 中檢視這份報告的帳戶已從 REST web 服務擷取資料的權限。這份報告要求使用者指派給 「 僅檢視收件者 」 角色。在預設Office 365權限結構上使用下列的系統管理員權限的使用者可以存取此報告： 帳務管理員、 全域管理員、 密碼管理員、 服務管理員及使用者管理管理員。如需詳細資訊，請參閱MailboxUsage 報告。
資料精確度、 保存及可用性
這份報告中提供的資訊包含的確切的日期和時間為每個事件。您可以使用任何合適的時間和工期由$filter選項包括StartDate和EndDate欄位。時間報告以掃描電子郵件伺服器的時區。
這份報告的資訊是可用的一段的 30 天或直到取消訂閱。
事件可能最多它們顯示在報表中前 24 小時的延遲。