Utilizzo dell'analisi della pipeline per diagnosticare i problemi dell'agente di trasporto

  • Articolo

 

Si applica a: Exchange Server 2007 SP1, Exchange Server 2007

Ultima modifica dell'argomento: 2007-02-12

L'analisi della pipeline è una funzionalità diagnostica di Microsoft Exchange Server 2007 che consente di catturare le informazioni diagnostiche in merito ai messaggi di posta elettronica quando questi incontrano gli agenti di trasporto registrati negli eventi Simple Mail Transfer Protocol (SMTP) nella pipeline di trasporto. Exchange cattura le informazioni dettagliate relative alle modifiche che l'agente di trasporto applica alla pipeline di trasporto nei file snapshot di un messaggio. Se le regole di trasporto sono configurate, Exchange Server registra anche le azioni che ogni regola di trasporto esegue su questi messaggi.

L'analisi della pipeline viene configurata per ogni singolo server dell'organizzazione e può essere abilitata sui computer in cui è installato il ruolo del server Trasporto Hub e il ruolo del server Trasporto Edge.

Una volta abilitata l'analisi della pipeline e utilizzato il percorso predefinito del file di registro dell'analisi della pipeline, viene creata la directory C:\Programmi\Microsoft\Exchange Server\TransportRoles\Registri\PipelineTracing. Questa directory contiene la directory MessageSnapshots e la directory RulesTracking.

Implementazione dell'analisi della pipeline

L'analisi della pipeline è pensata per i messaggi di registro che vengono inviati solo da un indirizzo di posta elettronica SMTP di un determinato mittente. L'indirizzo SMTP del mittente può essere una cassetta postale interna o esterna all'organizzazione di Exchange. Prima di abilitare l'analisi della pipeline, è necessario specificare l'indirizzo SMTP di un mittente per l'analisi stessa. È possibile configurare l'indirizzo SMTP del mittente dell'analisi della pipeline tramite il parametro PipelineTracingSenderAddress sul cmdlet Set-TransportServer.

Dopo avere configurato l'indirizzo SMTP del mittente dell'analisi della pipeline, è anche possibile modificare il percorso dei file di registro dell'analisi della pipeline. I file di registro dell'analisi della pipeline devono essere ubicati nel computer locale. Non è possibile utilizzare i percorsi del file o le unità mappate UNC (Universal Naming Convention).

Avviso

L'analisi della pipeline copia l'intero contenuto dei messaggi di posta elettronica che vengono inviati dall'indirizzo di posta elettronica del mittente. Per evitare un'inutile esposizione delle informazioni riservate, è necessario impostare apposite autorizzazioni di protezione sul percorso del file di registro dell'analisi della pipeline.

Avviso

Non abilitare l'analisi della pipeline per periodi di tempo prolungati. L'analisi della pipeline crea file di registro dettagliati che possono accumularsi rapidamente. Controllare sempre lo spazio disponibile sul disco quando l'analisi della pipeline è abilitata.

È possibile configurare il percorso dei file di registro dell'analisi della pipeline tramite il parametro PipelineTracingPath nel cmdlet Set-TransportServer. Per ulteriori informazioni, vedere Set-TransportServer.

Per ulteriori informazioni sull'abilitazione dell'analisi della pipeline e la configurazione dell'indirizzo del mittente per l'analisi della pipeline, vedere Come abilitare l'analisi della pipeline.

File snapshot del messaggio

Gli snapshot del messaggio sono file che catturano le modifiche precise (se disponibili) che gli agenti di trasporto apportano a un messaggio. Esaminando il contenuto dei file snapshot del messaggio, è possibile stabilire se gli agenti di trasporto hanno applicato le modifiche ai messaggi nella pipeline di trasporto come previsto. Per risolvere un problema, è necessario stabilire in quale agente di trasporto si è verificato l'errore. Dopo di che è possibile concentrarsi sull'agente per risolvere il problema. Successivamente i file snapshot del messaggio possono essere visualizzati di nuovo per assicurarsi che il problema sia stato effettivamente risolto.

Nella directory MessageSnapshots, Exchange crea una directory per ogni messaggio che attraversa la pipeline di trasporto una volta abilitata l'analisi della pipeline. Tutte le directory vengono create mediante il GUID assegnato al messaggio come nome della directory dal computer che esegue Microsoft Exchange. Se l'analisi della pipeline viene abilitata su più server di Exchange, verrà assegnato un GUID diverso al messaggio di ogni server di Exchange.

In ogni directory dei messaggi, Exchange crea più file snapshot del messaggio con l'estensione eml. Questi file comprendono il contenuto del messaggio quando incontra i singoli eventi e agenti di trasporto.

Exchange crea snapshot del messaggio per gli agenti che vengono registrati sui quattro eventi riportati di seguito:

  • OnEndofData

  • OnEndOfHeaders

  • OnSubmittedMessage

  • OnRoutedMessage

Se un agente di trasporto viene registrato in un evento, Exchange crea uno snapshot del messaggio prima che il messaggio incontri gli agenti di trasporto. In questo modo si ottiene una copia del messaggio prima che quest'ultimo incontri gli agenti di trasporto registrati sull'evento. Quindi verrà creato un nuovo snapshot del messaggio per ciascun agente di trasporto che il messaggio incontra, sia che l'agente di trasporto modifichi il contenuto del messaggio sia che non lo modifichi. Tuttavia, se su un evento non è registrato alcun agente, Exchange non crea snapshot del messaggio per l'evento in questione.

Ad esempio, se sull'evento OnEndofData vengono registrati tre agenti, ma solo due di essi modificano un messaggio, verranno creati quattro snapshot del messaggio. Il primo snapshot del messaggio cattura il messaggio quando incontra l'evento OnEndofData prima che vengano apportate modifiche eseguite dagli agenti di trasporto che hanno registrato l'evento. Quindi viene creato uno snapshot del messaggio per ogni agente di trasporto, indipendentemente dalla modifica o meno del messaggio da parte di un agente di trasporto.

Il seguente elenco è un esempio dei file che possono essere creati in un'installazione predefinita di un ruolo del server Trasporto Edge:

  • Original.eml Questo file comprende il contenuto originale non modificato del messaggio di posta elettronica prima che questo incontri un evento o un agente di trasporto. Se sugli eventi non sono stati configurati agenti di trasporto, verrà creato solo questo file.

  • Da SmtpReceive0001.eml a SmtpReceive0009.eml Questi file comprendono il contenuto del messaggio di posta elettronica quando incontra gli eventi OnEndofData e OnEndOfHeaders e gli agenti di trasporto che sono registrati su tali eventi nella parte di ricezione SMTP della pipeline di trasporto.

  • Routing0001.eml e Routing0002.eml Questi file comprendono il contenuto del messaggio di posta elettronica quando incontra gli eventi OnSubmittedMessage e OnRoutedMessage e gli agenti di trasporto registrati su tali eventi nella parte di categorizzazione della pipeline di trasporto.

Per aprire i file snapshot del messaggio, utilizzare un editor di testo, quale il Blocco note.

Ogni file snapshot del messaggio inizia con le intestazioni che vengono aggiunte al contenuto del messaggio ed elenca l'agente di trasporto e l'evento SMTP a cui si collega il file snapshot del messaggio. Queste intestazioni iniziano con X-CreatedBy: MessageSnapshot-Begin injected headers e terminano con X-EndOfInjectedXHeaders: MessageSnapshot-End injected headers. Le intestazioni vengono sostituite nei singoli file snapshot del messaggio da un agente di trasporto successivo. Di seguito viene riportato un esempio delle intestazioni che vengono aggiunte a un messaggio di posta elettronica elaborato dall'agente filtro connessioni nell'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

Sotto le intestazioni degli snapshot del messaggio si trova il contenuto del messaggio, comprese tutte le intestazioni del messaggio originale. Se un agente di trasporto modifica il contenuto del messaggio, le modifiche verranno integrate al messaggio. Man mano che il messaggio viene elaborato da ogni agente di trasporto, le modifiche apportate dai singoli agenti vengono applicate al contenuto dei messaggi. Se un agente di trasporto non apporta modifiche al contenuto del messaggio, lo snapshot del messaggio creato dall'agente sarà identico allo snapshot del messaggio creato dall'agente di trasporto precedente.

Lettura dei file di verifica delle regole

Il file di verifica delle regole cattura il risultato di ogni regola di trasporto quando viene applicata a un messaggio che incontra l'agente regole di trasporto su un server Trasporto Hub o un agente regole Edge su un server Trasporto Edge. I risultati che vengono catturati dal file di verifica delle regole indicano se una regola di trasporto ha eseguito un'operazione all'interno di un messaggio. Se la regola di trasporto ha eseguito un'operazione, il file di verifica delle regole indica il tipo di operazione eseguita. Il file di verifica delle regole contiene i seguenti campi nel formato con valori separati da virgole (.csv):

  • Data-Ora Questo campo indica la data e l'ora di esecuzione della regola di trasporto nel formato UTC (Coordinated Universal Time) o Zulu.

  • Id-messaggio Questo campo indica il valore del campo MessageID: che si trova nell'intestazione del messaggio. Questo valore è costante per l'intera durata del messaggio e può essere utilizzato con i registri di verifica dei messaggi per tenere traccia di un percorso del messaggio attraverso un'organizzazione di Exchange.

  • Nome-regola Questo campo indica il nome della regola di trasporto eseguita nel messaggio.

  • Dettagli Questo campo indica i valori dell'azione della regola di trasporto applicata a un messaggio. Se su una singola azione della regola di trasporto vengono impostati più valori, questi ultimi vengono separati da punto e virgola (;). Se la regola di trasporto non viene applicata a un messaggio, verrà inserita la stringa Le condizioni sono risultate false. Regola ignorata..

  • Azione Questo campo indica l'azione della regola di trasporto applicata a un messaggio. Se la regola di trasporto non viene applicata a un messaggio, verrà inserita la stringa NessunaAzione.

  • Indirizzo-Da Questo campo indica l'indirizzo SMTP del mittente del messaggio.

  • Indirizzo-destinatario Questo campo indica l'indirizzo SMTP del destinatario o dei destinatari del messaggio. Se l'azione della regola di trasporto viene applicata a un messaggio inviato a più destinatari corrispondenti alle condizioni della regola di trasporto, i destinatari vengono separati da un punto e virgola (;).

Ogni azione della regola di trasporto applicata a un messaggio viene scritta in una riga a parte nel file di verifica delle regole. Ad esempio, se una regola di trasporto presenta tre azioni, il risultato di ogni azione della regola di trasporto viene scritto in una riga separata nel file di verifica delle regole.

Se più destinatari vengono inclusi in un messaggio di posta elettronica, ma non tutti i destinatari soddisfano le condizioni della regola di trasporto, i destinatari che non soddisfano le condizioni della regola di trasporto vengono separati e scritti in una riga a parte.

Ulteriori informazioni

Per ulteriori informazioni sulla pipeline di trasporto, sugli agenti di trasporto e sui registri di verifica dei messaggi in Exchange 2007, vedere i seguenti argomenti: