Поделиться через

Отчет о MessageTrace

  • Статья

MessageTrace REST URI предоставляет сводные сведения об обработке сообщений электронной почты, которые передаются через Office 365 системы для организации за последние 30 дней. Этот отчет обычно используется с Отчет о MessageTraceDetail , чтобы определить, почему не было доставлено сообщение от пользователя, как ожидалось.

Дата последнего изменения: 17 сентября 2015 г.

Область применения: Office 365

Коды URI REST

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

Поля

В $select, $filterи $orderby параметры запроса ODATA2 можно указать следующие поля. Если указан параметр $select не возвращаются все поля.

Имя

WCF тип *

Тип EDM *

[В/Out] ** описание

Пример значения

Добавлено в версию обновления

EndDate

System.DateTime

Edm.DateTime

[In] Это поле используется для ограничения периода отчета. Используйте это поле в параметр запроса $filter для задания Дата и время окончания отчетного периода. Если вы задаете EndDate в параметре $filter , необходимо также указать StartDate. В этом отчете это поле соответствует дате и времени последнего шага обработки, записанные в сообщении.

Краткий формат даты (например, 03/10/2013) или Дата и время в кавычки (например, "03/10/2013 4:55 PM")

2013-V1

FromIP

строка

Не задан

[In/Out] Адрес IPv4 или IPv6, отправленных сообщений электронной почты в Office 365 систему.

192.168.0.205

2013-V1

MessageId

строка

Не задан

[In/Out] Заголовок MessageID Internet сообщения, если оно было задано. Это значение также можно явно null.

Если идентификатор не было указано в сообщении, данные отчета Показать <d:MessageId m:null="true" /> Atom, и "MessageId":null для JSON

2013-V1

MessageTraceId

System.Guid

Edm.Guid

[In/Out] Идентификатор, используемый для получения подробного сообщения передачи данных трассировки.

ae4ad8f6-7613-411c-e67e-08cfc740629

2013-V1

Organization

строка

Не задан

[In/Out] Полное доменное имя, которое обработки электронной почты.

example.onmicrosoft.com

2013-V1

Received

System.DateTime

Edm.DateTime

[In/Out] Дата и время, когда было получено сообщение электронной почты системой электронной почты Office 365. Это соответствует поле Date для первой записи сведений о трассировке сообщений.

2013-01-09T07:32:54Z

2013-V1

RecipientAddress

строка

Не задан

[In/Out] Адрес электронной почты SMTP пользователя, адресованные сообщения.

userone@example.onmicrosoft.com

2013-V1

SenderAddress

строка

Не задан

[In/Out] Адрес электронной почты SMTP пользователя сообщение было заявлениям из. Так как в нежелательных сообщений электронной почты часто поддельных адреса отправителя, они не считаются полностью надежным.

usertwo@example.onmicrosoft.com

2013-V1

Size

int

Edm.Int64

[In/Out] Размер сообщения, в байтах.

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

строка

Не задан

[In/Out] Состояние сообщения электронной почты для Office 365 системы. Это соответствует поле Detail на предыдущем этапе обработки, записанные в сообщении.

Delivered

2013-V1

Subject

строка

Не задан

[In/Out] Строка темы сообщения, если он был задан в сообщении.

Free M0ney WoN!

2013-V1

ToIP

строка

Не задан

[In/Out] Адрес IPv4 или IPv6, система электронной почты Office 365 отправляет сообщение.

192.168.0.215

2013-V1

* Тип WCF относится к типу данных .NET Framework, назначенные в поле при создании Windows Communication Foundation (WCF) ссылки на службу в Visual Studio. Имя относится к модели данных ADO.NET сущности (EDM) типов, которые возвращаются в формате Atom отчеты.

** Сведения о [In/Out] индикаторов, см в разделе «Входные параметры и сообщить о выходных столбцов».

Замечания

Каждый элемент в отчете о включает несколько полей метаданных. Для получения дополнительных сведений см Распространенные метаданных, возвращаемых веб-службой отчетов Office 365.

Поле Date указывает, когда сообщения обрабатывались системой Office 365 и сообщает в часовом поясе из этих серверов.

Этот отчет предоставляет сводку сообщений, которые проходят через системы электронной почты, для которого доступен более детальные сведения. Для получения этого подробные данные трассировки, приложение может использовать в отчете MessageTraceDetail . Важно, что приложение предоставлять все следующие сведения для получения сведений о подробные трассировки. Дополнительные сведения о трассировке сообщений можно Как: трассировки сообщений электронной почты в Office 365.

  • MessageTraceId Идентификатор GUID MessageTrace отчета в выходных данных.

  • RecipientAddress , которое было отправлено сообщение.

  • SenderAddress , откуда получена сообщения.

  • StartDate и EndDate , чтобы указать период, для которого сообщение было обработано.

С помощью StartDate и EndDate

Поля StartDate и EndDate не получать полезную информацию в отчет о результатах и всегда значение 0001-01-01T00:00:00Z в выходные данные отчета. Они предназначены для включить простой ограничение отчетов временной интервал, а также предоставлять большая точность не будет доступен в отчете «день».

Это может быть особенно полезны, например, при записи на основе электронной почты атак типа "отказ в обслуживании" на основе каждый час. При использовании этих полей, необходимо включить оба параметра $filter . Они оба считаются необязательные, но если один, которые необходимо указать другое. Если этот параметр не указан пары StartDate и EndDate в запросе отчетного периода времени по умолчанию — это предыдущие две недели. В разделе «Примеры» далее в этом разделе показано, как использовать поля StartDate и EndDate .

В отчете MessageTrace эти поля возвращает времени, переданной в параметре $filter. Поле Received указывает, когда сообщение было получено системой. Для сообщений, не прошедших это может включать несколько дней.

Примеры

Следующий пример демонстрирует запрашивать сведения о трассировке сообщений для предыдущих 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>

Входные параметры и сообщить о выходных столбцов

[In/Out] индикаторов в таблице полей имеют следующие значения:

  • Поля, отмеченные [In] в таблице предназначены для использования в $filter=, $orderby=, поля и другие параметры запроса, ограничить вводимых данных в отчете. Поля, помеченные [In] в таблице поля могут быть включены в параметр $select= и они будут отображаться в отчет операции, но они будут не содержат полезных данных.

  • Поля, отмеченные [In/Out] в поля, которые в таблице можно использовать в выделенный фрагмент столбца ($select=) и параметры ($filter= и $orderby=) ограничение записей. При включении эти поля параметр $select= будет отображаться в отчет операции и будет содержать полезные данные, если она доступна.

Совместимость

Отчет о MessageTrace была введена в Служба Office 365 версии 2013-V1. Дополнительные сведения об управлении версиями содержатся в разделе Управление версиями в веб-службе отчетов Office 365.

Соответствующий командлетов Windows PowerShell

Отчет о MessageTrace возвращает те же данные в командлет Get-MessageTraceWindows PowerShell. 

Разрешения

Учетная запись, используемая для доступа к отчетам необходимо иметь права администратора в организации Office 365. Если учетная запись может просмотреть этот отчет в Office 365 панель управления, учетная запись имеет разрешения для извлечения данных из веб-службы REST. В этом отчете требует от пользователя быть назначена роль получателей только для просмотра. В структуре разрешения по умолчанию Office 365 пользователей со следующими разрешениями администратора может вызвать этот отчет: выставления счетов администратора, глобального администратора, пароль администратора, администратора служб и администратор управления пользователями. Для получения дополнительных сведений см Отчет об использовании почтового ящика..

Степень детализации данных, сохранение состояния и доступности

Сведения, доступные в этом отчете содержится точную дату и время для каждого события. Можно использовать любой период реального времени и длительность, включая поля StartDate и EndDate в параметре $filter . Время отображается в часовом поясе сервера сканирования сообщение электронной почты.

Сведения для этого отчета можно найти в течение 30 дней или до отмены подписки.

События с задержкой в течение 24 часов, прежде чем они отображаются в отчете.