Usando o rastreamento de pipeline para diagnosticar problemas do agente de Transporte
Aplica-se a: Exchange Server 2007 SP1, Exchange Server 2007
Tópico modificado em: 2007-02-12
O rastreamento de pipeline é um recurso de diagnóstico no Microsoft Exchange Server 2007 que permite obter informações de diagnóstico sobre mensagens de email quando encontram agentes de transporte registrados em eventos SMTP na pipeline de transporte. O Exchange captura informações detalhadas sobre as alterações que cada agente de transporte aplica a mensagens na pipeline de transporte em arquivos de instantâneos de mensagens. Se forem configuradas regras de transporte, o Exchange Server também grava todas as ações que cada regra de transporte executa nessas mensagens.
O rastreamento de pipeline é configurado por servidor em sua organização e pode ser habilitado em computadores com a funções de servidor Transporte de Hub e Transporte de Borda instaladas.
Ao habilitar o rastreamento de pipeline e usar o local padrão do arquivo de log de rastreamento de pipeline, é criado o C:\Program Files\Microsoft\Exchange Server\TransportRoles\Logs\PipelineTracing. Esse diretório contém os diretórios MessageSnapshots e RulesTracking.
Implementando o rastreamento de pipeline
O rastreamento de pipeline foi projetado para registrar as mensagens enviadas apenas do endereço de email SMTP de um remetente específico. O endereço SMTP do remetente pode ser uma caixa de correio que esteja dentro ou fora da organização do Exchange. Para habilitar o rastreamento de pipeline, especifique um endereço SMTP do remetente para rastreamento de pipeline. Você pode configurar o endereço SMTP do remetente para o rastreamento de pipeline, usando o parâmetro PipelineTracingSenderAddress no cmdlet Set-TransportServer.
Depois de configurar o endereço SMTP do remetente para rastreamento de pipeline, você poderá modificar o local dos arquivos de log de rastreamento de pipeline, se desejar. É necessário colocar os arquivos de log de rastreamento de pipeline no computador local. Não é possível usar caminhos de arquivo UNC (Convenção de Nomenclatura Universal) ou unidades mapeadas.
Aviso
O rastreamento de pipeline copia o conteúdo completo de mensagens de email enviadas do endereço de email do remetente. Para evitar exposição indesejada de informações confidenciais, defina permissões de segurança adequadas no local do arquivo de log de rastreamento de pipeline.
Aviso
Não habilite o rastreamento de pipeline por períodos de tempo prolongados. O rastreamento de pipeline cria arquivos de log detalhados que podem se acumular rapidamente. Monitore sempre o espaço disponível em disco quando o rastreamento de pipeline estiver habilitado.
Você pode configurar o local dos arquivos de log de rastreamento de pipeline, usando o parâmetro PipelineTracingPath no cmdlet Set-TransportServer. Para obter mais informações, consulte Set-TransportServer.
Para obter mais informações sobre como habilitar o rastreamento de pipeline e configurar o endereço de remetente para rastreamento de pipeline, consulte Como habilitar o rastreamento de pipeline.
Arquivos de Instantâneos de Mensagens
Instantâneos de mensagens são arquivos que capturam as alterações exatas que os agentes de transporte fazem em uma mensagem, se ocorrerem. Examinando o conteúdo dos arquivos de instantâneos de mensagens, você pode determinar se os agentes de transporte aplicaram as alterações às mensagens da pipeline de transporte que você esperava. Se estiver solucionando um problema, descubra que agente de transporte está falhando. Depois, você pode se concentrar em solucionar os problemas desse agente. É possível, então, exibir os arquivos de instantâneos de mensagens novamente para verificar se sua solução foi bem-sucedida.
No diretório MessageSnapshots, o Exchange cria um diretório para cada mensagens que passa pela pipeline de transporte quando o rastreamento de pipeline estiver habilitado. Cada diretório é criado por meio da GUID atribuída à mensagem como o nome de diretório pelo computador que está executando o Microsoft Exchange. Se o rastreamento de pipeline estiver habilitado em mais de um servidor Exchange, será atribuída uma GUID diferente à mensagem em cada servidor Exchange.
Em cada diretório de mensagens, o Exchange cria vários arquivos de instantâneos de mensagens com extensões .eml. Esses arquivos de instantâneos de mensagens contêm o conteúdo da mensagem à medida que ela se depara com cada evento e agente de transporte.
O Exchange cria instantâneos de mensagens para agentes registrados nos quatro eventos a seguir:
OnEndofData
OnEndOfHeaders
OnSubmittedMessage
OnRoutedMessage
Se um agente de transporte for registrado em um evento, o Exchange cria um instantâneo da mensagem antes de a mesnagem se deparar com quaisquer agentes de transporte. Isso gera uma cópia da mensagem antes de a mensagem encontrar agentes de transporte registrados nesse evento. Em seguida, é criado um novo instantâneo de mensagem para cada agente de transporte que a mensagem encontra, independentemente do agente de transporte modificar ou não o conteúdo da mensagem. No entanto, se não for registrado nenhum agente em um evento, o Exchange não criará nenhum instantâneo de mensagem para esse evento.
Por exemplo, se forem registrados três agentes no evento OnEndofData, mas apenas dois dos agentes de transporte modificarem a mensagem, serão criados quatro instantâneos da mensagem. O primeiro instantâneo de mensagem captura a mensagem ao encontra o evento OnEndofData, antes de qualquer modificação feita pelos agentes de transporte que registraram o evento. Em seguida, é criado um instantâneo de mensagem para cada agente de transporte, independentemente do agente de transporte modificar ou não a mensagem.
A lista a seguir é um exemplo dos arquivos que podem ser criados em uma instalação padrão de uma função de servidor Transporte de Borda:
Original.eml Este arquivo contém o conteúdo original sem modificação da mensagem de email antes de essa mensagem encontrar qualquer evento ou agente de transporte. Se nenhum agente de transporte for configurado em nenhum evento, apenas esse arquivo será criado.
SmtpReceive0001.eml a SmtpReceive0009.eml Esses arquivos contêm o conteúdo da mensagem de email quando ela encontra os eventos OnEndofData e OnEndOfHeaders e agentes de transporte registrados nesses eventos na parte SMTP de recebimento da pipeline de transporte.
Routing0001.eml e Routing0002.eml Esses arquivos contêm o conteúdo da mensagem de email quando ela encontra os eventos OnSubmittedMessage e OnRoutedMessage e agentes de transporte registrados nesses eventos na parte de categorização da pipeline de transporte.
Você pode abrir os arquivos de instantâneos de mensagens em um editor de texto, como o Bloco de Notas.
Cada instantâneo de mensagem é iniciado com cabeçalhos adicionados ao conteúdo da mensagem e lista o evento SMTP e agente de transporte aos quais o arquivo de instantâneo de mensagem está relacionado. Esses cabeçalhos iniciam 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 subseqüente. A seguir, um exemplo dos cabeçalhos adicionados a uma mensagem de email processada pelo agente do Filtro de Conexão no evento OnEndOfHeaders:
X-CreatedBy: MessageSnapshot-Begin injected headers
X-MessageSnapshot-UTC-Time: 2006-07-31T23:18:55.972Z
X-MessageSnapshot-Protocol-Id: 08C87FF14CCC969C;2006-07-31T23:18:53.408Z;1
X-MessageSnapshot-Source: OnEndOfHeaders,Connection Filtering Agent
X-Sender: david@nwtraders.com
X-Receiver: chris@contoso.com
X-EndOfInjectedXHeaders: MessageSnapshot-End injected headers
Sob os cabeçalhos dos instantâneos de mensagens, está o conteúdo da mensagens, inclusive todos os cabeçalhos originais da mensagem. Se um agente de transporte modificar o conteúdo da mensagem, as alterações aparecem integradas com a mensagem. Quando 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 ao conteúdo da mensagem, o instantâneo da mensagem criado por esse agente será idêntico ao instantâneo criado pelo agente de transporte anterior.
Lendo os arquivos de rastreamento de regras
O arquivo de rastreamento de regras captura o resultado de cada regra de transporte quando ela é aplicada a uma mensagem que encontra o agente de Regras de Transporte em um servidor de Transporte de Hub ou um agente de Regras de Borda em um servidor de Transporte de Borda. Os resultados capturados pelo arquivo de rastreamento de regras indicam se uma regra de transporte executou uma ação em uma mensagem. Se uma ação tiver sido executada, o arquivo de rastreamento de regras indica qual foi a ação. O arquivo de rastreamento de regras contém os seguintes campos no formato .csv (valor separado por vírgula):
Date-Time Esse campo indica a data e hora em que a regra de transporte foi executada em UTC (Horário Universal Coordenado), ou horário Zulu.
Message-Id Esse campo indica o valor do campo
MessageID:localizado no cabeçalho da mensagem. Esse valor é constante pela duração da mensagem e pode ser usado com os logs de rastreamento de mensagens para rastrear o caminho de uma mensagem através de uma organização do Exchange.Rule-Name Esse campo indica o nome da regra de transporte executada na mensagem.
Details Esse campo indica os valores da ação da regra de transporte aplicada a uma mensagem. Se forem definidos vários valores em uma única ação de regra de transporte, os valores serão separados por ponto-e-vírgula (;). Se a regra de transporte não for aplicada a uma mensagem, a cadeia de caracteres Conditions será avaliada como falsa. Regra ignorada. é inserida.
Action Esse campo indica a ação da regra de transporte aplicada a uma mensagem. Se a regra de transporte não for aplicada à mensagem, a cadeia de caracteres NoAction será inserida.
From-Address Esse campo indica o endereço SMTP do remetente da mensagem.
Recipient-Address Esse campo indica o endereço SMTP do destinatário ou destinatários da mensagem. Se a ação da regra de transporte for aplicada a uma mensagem enviada a vários destinatários que atendem às condições da regra de transporte, os destinatários serão separados por ponto-e-vírgula (;).
Cada ação de regra de transporte aplicada a uma mensagem é gravada em uma linha separada no arquivo de rastreamento de regras. Por exemplo, se uma regra de transporte tiver três ações, o resultado de cada ação de regra de transporte é gravado em uma linha separada no arquivo de rastreamento de mensagens.
Se for incluído mais de um destinatário em uma mensagem de email, mas nem todos os destinatários atenderem às condições da regra de transporte, os destinatários que não corresponderem a essas condições serão separados e gravados em uma linha diferente.
Para obter mais informações
Para obter mais informações sobre a pipeline de transporte, agentes de transporte e logs de rastreamento de mensagens no Exchange 2007, consulte os seguintes tópicos: