Informe de MessageTrace

Artículo
11/14/2016

El URI de REST de MessageTrace proporciona información resumida sobre el procesamiento de los mensajes de correo electrónico que se han pasado a través del sistema de Office 365 para la organización en los últimos 30 días. Este informe se utiliza normalmente con el Informe de MessageTraceDetail para determinar por qué no se entregó un mensaje desde el usuario como se esperaba.

Última modificación: jueves, 17 de septiembre de 2015

Hace referencia a: Office 365

URI de REST

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

Campos

Los siguientes campos pueden especificarse en las opciones de consulta de ODATA2 $select, $filtery $orderby . Si no hay ninguna opción de $select se proporciona, se devuelven todos los campos.

Nombre	Tipo WCF *	Tipo EDM *	[In/Out] ** descripción	Valores de ejemplo	Agregado en la versión de servicio
EndDate	System.DateTime	Edm.DateTime	[Entrada] Este campo se usa para limitar el período del informe. Use este campo en una opción de consulta de $filter para establecer la fecha y hora finales del período de notificación. Si proporciona EndDate en la opción $filter , también debe proporcionar StartDate. En este informe, este campo corresponde a la fecha y hora del último paso de procesamiento de registrados para el mensaje.	Fecha corta (por ejemplo, 03/10/2013) o Fecha hora con comillas (por ejemplo, "03/10/2013 4:55 PM")	2013-V1
FromIP	string	No se especifica ninguno	[In/Out] La dirección IPv4 o IPv6 que se transmite el mensaje al sistema de correo electrónico Office 365.	192.168.0.205	2013-V1
MessageId	string	No se especifica ninguno	[In/Out] El encabezado de MessageID de Internet del mensaje, si se ha proporcionado uno. Este valor también puede ser explícitamente null.	Si no hay identificador proporcionado por el mensaje, los datos del informe mostrará <d:MessageId m:null="true" /> para Atom y "MessageId":null para JSON	2013-V1
MessageTraceId	System.Guid	Edm.Guid	[In/Out] Un identificador que se utiliza para obtener el mensaje detallado transferir la información de seguimiento.	ae4ad8f6-7613-411c-e67e-08cfc740629	2013-V1
Organization	string	No se especifica ninguno	[In/Out] El nombre de dominio completo que se procesa el correo electrónico.	example.onmicrosoft.com	2013-V1
Received	System.DateTime	Edm.DateTime	[In/Out] La fecha y la hora a la que se recibió el correo electrónico en el sistema de correo electrónico Office 365. Esto corresponde al campo Date de la primera entrada de detalle de seguimiento de mensajes.	2013-01-09T07:32:54Z	2013-V1
RecipientAddress	string	No se especifica ninguno	[In/Out] La dirección de correo electrónico SMTP del usuario que se ha enviado el mensaje a.	userone@example.onmicrosoft.com	2013-V1
SenderAddress	string	No se especifica ninguno	[In/Out] La dirección de correo electrónico SMTP del usuario el mensaje fue supuestamente desde. Debido a que con frecuencia se suplantación direcciones de remitente en el correo electrónico de spam, no se consideran confiables completamente.	usertwo@example.onmicrosoft.com	2013-V1
Size	int	Edm.Int64	[In/Out] El tamaño del mensaje, en bytes.	39405	2013-V1
StartDate	System.DateTime	Edm.DateTime	[Entrada] Este campo se usa para limitar el período del informe. Use este campo en una opción de consulta de $filter para establecer la fecha de inicio y la hora del período de notificación. Si proporciona un StartDate en la opción $filter , también debe especificar un EndDate. En este informe, este campo corresponde a la fecha y hora del primer paso de procesamiento de registrados para el mensaje.	Fecha corta (por ejemplo, 03/10/2013) o Fecha hora con comillas (por ejemplo, "03/10/2013 4:55 PM")	2013-V1
Status	string	No se especifica ninguno	[In/Out] El estado del mensaje en el sistema de correo electrónico Office 365. Esto corresponde al campo Detail del último paso de procesamiento de registrados para el mensaje.	Delivered	2013-V1
Subject	string	No se especifica ninguno	[In/Out] La línea de asunto del mensaje, si existiera uno para el mensaje.	Free M0ney WoN!	2013-V1
ToIP	string	No se especifica ninguno	[In/Out] La dirección IPv4 o IPv6 que el sistema de correo electrónico Office 365 envía el mensaje.	192.168.0.215	2013-V1

* El Tipo de WCF hace referencia al tipo de datos .NET Framework asignado al campo cuando se crea una referencia de servicio Windows Communication Foundation (WCF) en Visual Studio. El Tipo de EDM hace referencia a los tipos de ADO.NET Entity Data Model (EDM) devueltos en los informes con formato Atom.

** Para obtener información acerca de [In/Out] indicadores, vea la sección "Parámetros de entrada y salida columnas de informe".

Notas

Cada entrada en el informe incluye varios campos de metadatos. Para obtener más información, vea Metadatos comunes devueltos por el servicio web de informes de Office 365.

El campo Date indica si los mensajes fueron administrados por el sistema Office 365 y se indican en la zona horaria de esos servidores.

Este informe proporciona información de resumen de los mensajes que pasan a través del sistema de correo electrónico para la que está disponible la información de seguimiento más detallado. Para obtener información detallada de seguimiento, la aplicación puede utilizar el informe de MessageTraceDetail . Es importante que la aplicación proporcionar toda la información siguiente para obtener la información de seguimiento detallado. Para obtener más información acerca de los mensajes de seguimiento, vea Cómo: mensajes de correo electrónico de seguimiento en Office 365.

MessageTraceId GUID de la salida del informe MessageTrace .
RecipientAddress que se envió el mensaje.
SenderAddress donde se originó el mensaje.
StartDate y EndDate que identifican el período para el que se procesó el mensaje.

Uso de StartDate y EndDate

Los campos StartDate y EndDate no proporcionan información útil en los resultados del informe y siempre se establecen en 0001-01-01T00:00:00Z en la salida del informe. Están pensadas para habilitar fácil de restricción de la ventana de tiempo de generación de informes y a continuación, proporcione un mayor precisión que estaría disponible en un informe "diario".

Esto puede ser especialmente útil, por ejemplo, al grabar basada en correo electrónico ataques de denegación de servicio en cada hora. Al usar estos campos, debe incluir en la opción $filter . Se consideran opcionales, pero si se proporciona una, debe proporcionar a la otra. Si no se proporciona el par StartDate y EndDate en la consulta, el informe de un período de tiempo predeterminado es las dos semanas anteriores. La sección "Ejemplos" más adelante en este tema muestra cómo usar los campos StartDate y EndDate .

En el informe de MessageTrace, estos campos devolución las horas que pasan en la opción $filter. Campo recibido indica cuándo se recibió el mensaje por el sistema. Para los mensajes error, esto puede abarcar varios días.

Ejemplos

En el ejemplo siguiente se muestra cómo solicitar información de seguimiento de mensajes para las 48 horas anteriores, que es el valor predeterminado de período de tiempo.

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>

Parámetros de entrada y salida columnas de informe

Los indicadores de [In/Out] en la tabla campos tienen los significados siguientes:

Campos marcados [In] en los campos de tabla principalmente están diseñados para su uso en $filter=, $orderby=, y otras opciones de consulta que restringir las entradas que se devuelve el informe. Los campos marcados [In] en la tabla campos pueden incluirse en la opción $select= y aparecen en las entradas de informe, pero no va a contener ningún dato útil.
En los campos de tabla puede utilizarse en la selección de columna ($select=) y la restricción ($filter= y $orderby=) opciones de entrada de los campos marcados [In/Out]. Cuando uno de estos campos se incluye en la opción $select= , aparecerán en las entradas de informe y va a contener datos útiles cuando esté disponible.

Compatibilidad

El informe de MessageTrace se introdujo en Versión 2013-V1 del servicio de Office 365. Para obtener más información sobre el control de versiones, vea Control de versiones en el servicio web de informes de Office 365.

Cmdlets de Windows PowerShell correspondientes

El informe de MessageTrace devuelve la misma información que el cmdlet de Get-MessageTraceWindows PowerShell.

Permisos

La cuenta que use para tener acceso a los informes debe tener permisos administrativos en la organización de Office 365. Si la cuenta puede ver este informe en el Panel de Control Office 365, la cuenta tiene permisos para recuperar los datos desde el servicio web REST. Este informe requiere que el usuario que se asignará a la función de los destinatarios con permiso de vista. En la estructura de permisos Office 365 de forma predeterminada, los usuarios con los siguientes permisos de administrador pueden tener acceso a este informe: administrador del usuario, administrador global, Administrador de contraseñas, Administrador de servicio y Administrador de facturación. Para obtener más información, vea Informe de uso del buzón de correo:.

Disponibilidad, la persistencia y la granularidad de datos

Información disponible en este informe contiene la fecha exacta y la hora para cada evento. Puede utilizar cualquier período de tiempo viable y la duración, incluyendo los campos StartDate y EndDate en la opción $filter . Veces se indican en la zona horaria del servidor de análisis del correo electrónico.

La información de este informe está disponible durante un período de 30 días, o hasta que se cancele la suscripción.

Los eventos se pueden retrasar por 24 horas antes de que aparezcan en un informe.