Rastreamento de pipeline no Exchange 2013

Aplica-se a: Exchange Server 2013

O rastreamento de pipeline captura cópias de mensagens de email de um remetente específico à medida que eles se movem pelo serviço de transporte em servidores de caixa de correio, o serviço de Entrega de Transporte de Caixa de Correio em servidores de caixa de correio e por meio de servidores do Edge Transport.. O rastreamento de pipeline captura informações verbosas sobre as alterações que cada agente de transporte aplica às mensagens no pipeline de transporte em arquivos de instantâneo de mensagem. Examinando o conteúdo dos arquivos de instantâneo de mensagem, você pode determinar se os agentes de transporte aplicaram as alterações às mensagens no pipeline de transporte esperado. Se você estiver solucionando um problema, deverá determinar qual agente de transporte tem culpa. Em seguida, você pode concentrar seus esforços de solução de problemas nesse agente para resolver o problema. Em seguida, você pode exibir os arquivos de instantâneo de mensagem novamente para verificar se sua solução foi bem-sucedida.

Aviso

  • O rastreamento de pipeline copia o conteúdo completo de mensagens de email enviadas do endereço de email do remetente. Para evitar a exposição indesejada de informações confidenciais, você precisa definir as permissões de segurança apropriadas na pasta de rastreamento de pipeline.
  • Não habilite o rastreamento de pipeline por períodos de tempo prolongados. O rastreamento de pipeline cria arquivos que podem se acumular rapidamente. Monitore sempre o espaço disponível em disco quando o rastreamento de pipeline estiver habilitado.

Configurar o rastreamento de pipeline

Antes de habilitar o rastreamento de pipeline, você precisa especificar o endereço de email do remetente que deseja monitorar. O rastreamento de pipeline foi projetado para registrar mensagens enviadas de um endereço de email específico. O endereço de email do remetente pode ser interno ou externo para sua organização do Exchange. Como alternativa, você pode habilitar o rastreamento de pipeline para mensagens do sistema geradas pelo serviço de transporte na caixa de correio ou no servidor de Transporte de Borda especificado, como respostas automáticas, mensagens DSN (notificação de status de entrega), relatórios de diário e outras mensagens geradas pelo sistema Você também pode modificar o local da pasta de rastreamento de pipeline.

Os parâmetros usados para configurar o rastreamento de pipeline são resumidos na tabela a seguir:

Cmdlet Parâmetro Valor padrão Descrição
Set-TransportService

Set-MailboxTransportService

Pipelinetracingsenderaddress Em branco ($null) Especifique o endereço de email do remetente que você deseja monitorar.

Especifique o valor "<>" para monitorar as mensagens geradas pelo sistema enviadas pelo serviço de transporte especificado no servidor.

Set-TransportService

Set-MailboxTransportService

Pipelinetracingpath Serviço de transporte: %ExchangeInstallPath%TransportRoles\Logs\Hub\PipelineTracing

Serviço de transporte de caixa de correio: %ExchangeInstallPath%TransportRoles\Logs\Mailbox\PipelineTracing

O caminho deve estar no servidor local. Não há suporte para caminhos UNC.

O caminho especificado contém a MessageSnapshots pasta em que os arquivos de rastreamento de pipeline são armazenados.

Set-TransportService

Set-MailboxTransportService

PipelineTracingEnabled $false Você só pode habilitar o rastreamento de pipeline para o serviço de transporte especificado no servidor depois de configurar o endereço do remetente que deseja monitorar.

Para obter mais informações sobre como habilitar o rastreamento de pipeline e configurar o endereço do remetente para rastreamento de pipeline, consulte Configurar o rastreamento de pipeline.

Arquivos de instantâneo de mensagem

Instantâneos de mensagem são arquivos que capturam quaisquer alterações feitas em uma mensagem por agentes de transporte no serviço de transporte ou no serviço de Entrega de Transporte da Caixa de Correio. Esses arquivos são armazenados na MessageSnapshots pasta no caminho de rastreamento de pipeline correspondente para o serviço de transporte.

Na pasta, o MessageSnapshots Exchange cria uma pasta para cada mensagem enviada pelo remetente monitorado que flui pelo serviço de transporte especificado. Cada pasta tem o nome de um GUID atribuído à mensagem. Se você habilitar o rastreamento de pipeline para o serviço de Transporte e o serviço de Transporte de Caixa de Correio no mesmo servidor de caixa de correio, um GUID diferente será atribuído à mesma mensagem por cada serviço de transporte, portanto, o nome da pasta para uma mensagem na MessageSnapshots pasta para o serviço de transporte é diferente do nome da pasta para a mesma mensagem na MessageSnapshots pasta para o serviço de Transporte de Caixa de Correio. Se você habilitar o rastreamento de pipeline em mais de um servidor do Exchange, um GUID diferente será atribuído à mesma mensagem que viaja pelo serviço de transporte especificado em cada servidor do Exchange.

Em cada pasta de mensagem, o Exchange cria vários arquivos de instantâneo de mensagem que têm extensões de arquivo .eml. Esses arquivos de instantâneo de mensagem contêm o conteúdo da mensagem à medida que ela encontra cada evento SMTP e o agente de transporte.

Se um agente de transporte estiver registrado em um evento SMTP, o Exchange criará um instantâneo de mensagem da mensagem antes que a mensagem encontre agentes de transporte. Isso fornece uma cópia da mensagem antes que a mensagem encontre agentes de transporte registrados nesse evento. Em seguida, um novo instantâneo de mensagem é criado para cada agente de transporte que a mensagem encontra, independentemente de um agente de transporte modificar o conteúdo da mensagem. No entanto, se nenhum agente for registrado em um evento, o Exchange não criará instantâneos de mensagens para esse evento.

Por exemplo, se três agentes forem registrados no evento OnEndofData , mas apenas dois dos agentes de transporte modificarem uma mensagem, quatro instantâneos de mensagem serão criados. O primeiro instantâneo de mensagem captura a mensagem ao encontrar o evento OnEndofData antes de quaisquer modificações feitas pelos agentes de transporte registrados nesse evento. Em seguida, um instantâneo de mensagem é criado para cada agente de transporte, independentemente de um agente de transporte modificar a mensagem.

Os arquivos de instantâneo de mensagem criados são descritos na seguinte lista:

  • Original.eml: este arquivo contém o conteúdo original não modificado da mensagem de email antes de encontrar eventos SMTP ou agentes de transporte.

  • Roteamentonnnn.eml: esses arquivos contêm o conteúdo da mensagem de email à medida que ele encontra os eventos SMTP e agentes de transporte registrados nesses eventos na parte de categorização do serviço de transporte. O espaço reservado nnnn representa um valor inteiro que começa com 0001. O valor é incrementado para cada evento SMTP e agente de transporte registrado nesses eventos na ordem em que os eventos e os agentes atuam na mensagem. O serviço entrega de transporte de caixa de correio não gera esses arquivos de instantâneo de roteamento .

  • SmtpReceivennnn.eml: esses arquivos contêm o conteúdo da mensagem de email ao encontrar os eventos SMTP onEndofData e OnEndOfHeaders e agentes de transporte registrados nesses eventos durante o SMTP recebem parte do serviço de transporte ou do serviço de Entrega de Transporte da Caixa de Correio. O espaço reservado nnnn representa um valor inteiro que começa com 0001. O valor é incrementado para cada evento SMTP e agente de transporte registrado nesses eventos na ordem em que os eventos e os agentes atuam na mensagem.

Você pode abrir os arquivos de instantâneo de mensagem usando o Bloco de Notas ou qualquer editor de texto.

Cada arquivo de instantâneo de mensagem começa com cabeçalhos que são adicionados ao conteúdo da mensagem e listam o evento SMTP e o agente de transporte ao qual o arquivo de instantâneo da mensagem se relaciona. Esses cabeçalhos começam com X-CreatedBy: MessageSnapshot-Begin injected headers e terminam com X-EndOfInjectedXHeaders: MessageSnapshot-End injected headers. Esses cabeçalhos são substituídos em cada arquivo de instantâneo de mensagem por cada agente de transporte subsequente e evento SMTP. A seguir está um exemplo dos cabeçalhos que são adicionados a um arquivo de mensagem de email:

X-CreatedBy: MessageSnapshot-Begin injected headers
X-MessageSnapshot-UTC-Time: 2013-01-23T23:20:18.138Z
X-MessageSnapshot-Record-Id: 21474836486
X-MessageSnapshot-Source: OnSubmittedMessageX-Sender: michelle@nwtraders.com
X-Receiver: chris@contoso.com
X-EndOfInjectedXHeaders: MessageSnapshot-End injected headers

Após os cabeçalhos do instantâneo da mensagem, o arquivo contém o conteúdo da mensagem, incluindo todos os cabeçalhos de mensagem originais. Se um agente de transporte modificar o conteúdo da mensagem, as alterações aparecerão integradas à mensagem. À medida que a mensagem é processada por cada agente de transporte, as alterações feitas por cada agente são aplicadas ao conteúdo da mensagem. Se um agente de transporte não fizer alterações no conteúdo da mensagem, o instantâneo de mensagem criado por esse agente será idêntico ao instantâneo de mensagem criado pelo agente de transporte anterior.