Relatório de MessageTrace

Artigo
11/14/2016

O URI do REST MessageTrace fornece informações de resumo sobre o processamento de emails que passaram pelo sistema de Office 365 para a organização nos últimos 30 dias. Este relatório é geralmente usado com o Relatório de MessageTraceDetail para determinar por que uma mensagem não foi entregue do usuário conforme o esperado.

Última alteração: quinta-feira, 17 de setembro de 2015

Aplica-se a: Office 365

URIs REST

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

Campos

Os campos a seguir podem ser especificados em Opções de consulta ODATA2 $select, $filtere $orderby . Todos os campos são retornados se nenhuma opção $select for fornecida.

Nome	Tipo WCF *	Tipo EDM *	[Em/fora] * * descrição	Valores de exemplo	Adicionado ao serviço versão
EndDate	System.DateTime	Edm.DateTime	[In] Este campo é usado para limitar o período do relatório. Use este campo em uma opção de consulta $filter para definir a data de término e a hora do período do relatório. Se você fornecer EndDate na opção $filter , você também deverá fornecer StartDate. Nesse relatório, esse campo corresponde para a data e hora da última etapa processamento gravada para a mensagem.	Data curta (por exemplo, 03/10/2013) ou Data hora com aspas (por exemplo, "03/10/2013 4:55 PM")	2013-V1
FromIP	Cadeia de caracteres	Nenhum especificado	[/ Saída] O endereço IPv4 ou IPv6 que transmitidos a mensagem para o sistema de email Office 365.	192.168.0.205	2013-V1
MessageId	Cadeia de caracteres	Nenhum especificado	[/ Saída] O cabeçalho de MessageID Internet da mensagem, se houver uma foi fornecido. Esse valor também pode ser explicitamente null.	Se nenhuma identificação foi fornecida para a mensagem, os dados do relatório mostrará <d:MessageId m:null="true" /> para Atom e "MessageId":null para JSON	2013-V1
MessageTraceId	System.Guid	Edm.Guid	[/ Saída] Um identificador usado para fazer a mensagem detalhada transferir informações de rastreamento.	ae4ad8f6-7613-411c-e67e-08cfc740629	2013-V1
Organization	Cadeia de caracteres	Nenhum especificado	[/ Saída] O nome de domínio totalmente qualificado que estava processando o email.	example.onmicrosoft.com	2013-V1
Received	System.DateTime	Edm.DateTime	[/ Saída] A data e hora em que o email foi recebido pelo sistema de email Office 365. Isso corresponde ao campo Date da primeira entrada de detalhe de rastreamento de mensagem.	2013-01-09T07:32:54Z	2013-V1
RecipientAddress	Cadeia de caracteres	Nenhum especificado	[/ Saída] O endereço de email SMTP do que a mensagem foi endereçada ao usuário.	userone@example.onmicrosoft.com	2013-V1
SenderAddress	Cadeia de caracteres	Nenhum especificado	[/ Saída] O endereço de email SMTP do usuário a mensagem estava propositalmente de. Como os endereços do remetente são comumente falsificados em email de spam, eles não são considerados completamente confiáveis.	usertwo@example.onmicrosoft.com	2013-V1
Size	int	Edm.Int64	[/ Saída] O tamanho da mensagem, em bytes.	39405	2013-V1
StartDate	System.DateTime	Edm.DateTime	[In] Este campo é usado para limitar o período do relatório. Use este campo em uma opção de consulta $filter para definir a data de início e a hora do período do relatório. Se você fornecer um StartDate na opção $filter , você também deve especificar um EndDate. Nesse relatório, esse campo corresponde à data e hora da primeira etapa de processamento gravada para a mensagem.	Data curta (por exemplo, 03/10/2013) ou Data hora com aspas (por exemplo, "03/10/2013 4:55 PM")	2013-V1
Status	Cadeia de caracteres	Nenhum especificado	[/ Saída] O status da mensagem no sistema de email Office 365. Isso corresponde ao campo Detail da última etapa processamento gravada para a mensagem.	Delivered	2013-V1
Subject	Cadeia de caracteres	Nenhum especificado	[/ Saída] A linha de assunto da mensagem, se houver uma estava presente para a mensagem.	Free M0ney WoN!	2013-V1
ToIP	Cadeia de caracteres	Nenhum especificado	[/ Saída] O endereço IPv4 ou IPv6 que o sistema de email Office 365 enviou a mensagem.	192.168.0.215	2013-V1

* O Tipo de WCF refere-se ao tipo de dados .NET Framework atribuído ao campo quando você cria um Windows Communication Foundation (WCF) referência de serviço no Visual Studio. O Tipo de EDM refere-se para os tipos de modelo de dados de entidade ADO.NET (EDM) retornados nos relatórios Atom formatada.

* * Para obter informações sobre [/ saída] indicadores, consulte a seção "Parâmetros de entrada e relatar as colunas de saída".

Comentários

Cada entrada no relatório inclui vários campos de metadados. Para obter mais informações, consulte Metadados comum retornados pelo serviço web de relatório do Office 365.

O campo Date indica quando as mensagens foram tratadas pelo sistema Office 365 e informadas no fuso horário desses servidores.

Esse relatório fornece informações de resumo de mensagens que são passadas para o sistema de email, para o qual as informações de rastreamento mais detalhado estão disponíveis. Para obter informações detalhadas de rastreamento, o seu aplicativo pode usar o relatório de MessageTraceDetail . É importante que o seu aplicativo fornecer todas as informações a seguir para obter as informações de rastreamento detalhado. Para obter mais informações sobre as mensagens de rastreamento, consulte Como: mensagens de rastreamento no Office 365.

MessageTraceId GUID da saída do relatório MessageTrace .
RecipientAddress que a mensagem foi enviada para.
SenderAddress que a mensagem foi enviada de.
StartDate e EndDate que identificam o período para o qual a mensagem foi processada.

Usando StartDate e EndDate

Os campos StartDate e EndDate não fornecem informações úteis nos resultados do relatório e sempre estão definidos para 0001-01-01T00:00:00Z na saída do relatório. Eles servem para habilitar fácil restrição da janela de tempo de relatórios e fornecer mais fina precisão de seria disponíveis em um relatório "diariamente".

Isso pode ser especialmente útil, por exemplo, quando a gravação de ataques de negação de serviço baseados em email em uma base por hora. Ao usar esses campos, você deve incluir ambos na opção $filter . Eles são considerados opcionais, mas se você fornecer um, você precisa fornecer o outro. Se o par StartDate/EndDate não for fornecido na consulta, o padrão de período de relatório é as duas semanas anteriores. A seção "Exemplos" posteriormente neste tópico mostra como usar os campos StartDate e EndDate .

No relatório MessageTrace, esses campos retornam os horários em que você passado na opção $filter. O campo recebido indica quando a mensagem foi recebida pelo sistema. Para mensagens com falha, isso pode abranger vários dias.

Exemplos

O exemplo a seguir demonstra como solicitar informações de rastreamento de mensagens para anteriores 48 horas, que é o padrão período de tempo.

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 e relatar colunas de saída

Os indicadores de [/ saída] na tabela campos têm os significados a seguintes:

Campos marcados [In] nos campos de tabela destinam-se principalmente para uso em $filter=, $orderby=, e outras opções de consulta que restringir quais entradas retorna o relatório. Campos marcados [In] na tabela campos podem ser incluídos na opção $select= e eles serão exibidos nas entradas de relatório, mas que não irão conter nenhum dado útil.
Campos marcados [/ saída] nos campos de tabela pode ser usada nas opções de ($filter= e $orderby=) da restrição de entrada e seleção de coluna ($select=). Quando você inclui um desses campos na opção $select= , ele aparecerá nas entradas de relatório e irá conter dados úteis quando ele estiver disponível.

Compatibilidade

O relatório de MessageTrace foi introduzido no Office 365 service version 2013-V1. Para obter mais informações sobre o controle de versão, consulte Controle de versão no serviço da web de relatório do Office 365.

Cmdlets do Windows PowerShell correspondentes

O relatório de MessageTrace retorna as mesmas informações que o cmdlet Get-MessageTraceWindows PowerShell.

Permissões

A conta usada para acessar os relatórios deve ter permissões administrativas na organização Office 365. Se a conta pode exibir este relatório no Office 365 painel de controle, a conta tem permissões para recuperar os dados do serviço web REST. Este relatório requer que o usuário a ser atribuído à função destinatários somente para exibição. Na estrutura de permissões de Office 365 padrão, os usuários com as seguintes permissões de administrador podem acessar este relatório: administrador de gerenciamento de usuário, administrador global, administrador de senha, administrador de serviço e administrador de faturamento. Para obter mais informações, consulte Relatório de uso de caixa postal:.

Disponibilidade, persistência e granularidade de dados

Informações disponíveis neste relatório contém a data e hora exatas para cada evento. Você pode usar qualquer período viável e a duração, incluindo os campos StartDate e EndDate na opção $filter . Tempos são relatados no fuso horário do servidor de email de verificação.

As informações para esse relatório estão disponíveis por um período de 30 dias ou até que a assinatura será cancelada.

Eventos podem ser atrasados por até 24 horas antes que eles aparecem em um relatório.

Compartilhar via