Relatório de MessageTrace

  • Artigo

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.