Exchange 2013 でのパイプライン トレース
製品: Exchange Server 2013
パイプライン トレースは、特定の送信者からの電子メール メッセージが、メールボックス サーバーのトランスポート サービス、メールボックス サーバーのメールボックス トランスポート配信サービス、およびエッジ トランスポート サーバーを経由したときに、それらのコピーをキャプチャします。 パイプライン トレースは、各トランスポート エージェントがメッセージ スナップショット ファイル内のトランスポート パイプラインのメッセージに適用した変更について詳細な情報をキャプチャします。 メッセージ スナップショット ファイルの内容を調べると、トランスポート エージェントによって、期待したトランスポート パイプライン内のメッセージに変更が加えられたかどうかを確認することができます。 問題のトラブルシューティングを行う場合は、どのトランスポート エージェントに問題があるのかを確認する必要があります。 次に、トラブルシューティングの対象をそのエージェントに絞って問題を解決します。 その後、メッセージ スナップショット ファイルを再び表示すると、ソリューションが成功したことを確認できます。
警告
- パイプライン トレースでは、送信者の電子メール アドレスから送信された電子メール メッセージの内容が完全にコピーされます。 機密情報の不要な公開を防ぐには、パイプライン トレース フォルダーに対して適切なセキュリティのアクセス許可を設定する必要があります。
- パイプライン トレースを長時間にわたって有効にしないでください。 パイプライン トレースではファイルが作成され、すぐに蓄積されます。 パイプライン トレースを有効にしている場合は、使用可能なディスクの空き領域を常に監視してください。
パイプライン トレースを構成する
パイプライン トレースを有効にする前に、監視する送信者のメール アドレスを指定する必要があります。 パイプライン トレースは、特定のメール アドレスから送信されたメッセージをログに記録するように設計されています。 送信者のメール アドレスは、Exchange 組織の内部または外部にすることができます。 または、指定したメールボックスまたはエッジ トランスポート サーバーでトランスポート サービスによって生成されたシステム メッセージ (自動応答、配信状態通知 (DSN) メッセージ、ジャーナル レポート、その他のシステム生成メッセージなど) のパイプライン トレースを有効にすることもできます。パイプライン トレース フォルダーの場所を変更することもできます。
パイプライン トレースの構成に使用するパラメーターの概要を次の表に示します。
| コマンドレット | パラメーター | 既定値 | 説明 |
|---|---|---|---|
| Set-TransportService Set-MailboxTransportService |
PipelineTracingSenderAddress | 空白 ($null) |
監視する送信者の電子メール アドレスを指定します。 サーバー上の指定されたトランスポート サービスによって送信されるシステム生成メッセージを監視するには、値 " |
| Set-TransportService Set-MailboxTransportService |
PipelineTracingPath | トランスポート サービス: %ExchangeInstallPath%TransportRoles\Logs\Hub\PipelineTracing メールボックス トランスポート サービス: |
パスは、ローカル サーバーにする必要があります。 UNC パスはサポートされていません。 指定したパスには、 |
| Set-TransportService Set-MailboxTransportService |
PipelineTracingEnabled | $false |
監視する送信者のアドレスを構成した後は、指定したサーバー上のトランスポート サービスに対してのみパイプライン トレースを有効にすることができます。 |
パイプライン トレースを有効化し、パイプライン トレースの送信者アドレスを構成する方法の詳細については、「パイプライン トレースを構成する」を参照してください。
メッセージ スナップショット ファイル
メッセージ スナップショットは、トランスポート サービスまたはメールボックス トランスポート配信サービスでトランスポート エージェントによってメッセージに加えられた変更をキャプチャするファイルです。 これらのファイルは、トランスポート サービスの MessageSnapshots 対応するパイプライン トレース パスのフォルダーに格納されます。
フォルダー内で MessageSnapshots 、Exchange は、指定されたトランスポート サービスを通過する監視対象の送信者によって送信されるメッセージごとに 1 つのフォルダーを作成します。 各フォルダー名は、メッセージに割り当てられる GUID に基づいて付けられます。 トランスポート サービスとメールボックス トランスポート サービスのパイプライン トレースを同じメールボックス サーバーで有効にすると、トランスポート サービスごとに異なる GUID が同じメッセージに割り当てられるため、トランスポート サービスのフォルダー内 MessageSnapshots のメッセージのフォルダー名は、メールボックス トランスポート サービスのフォルダー内 MessageSnapshots の同じメッセージのフォルダー名とは異なります。 複数の Exchange サーバー上でパイプライン トレースを有効にしている場合、各 Exchange サーバーで指定されたトランスポート サービスを経由するため、同じメッセージに異なる GUID が割り当てられます。
Exchange によって、各メッセージ フォルダー内に, .eml 拡張子が付いた複数のメッセージ スナップショット ファイルが作成されます。 これらのメッセージ スナップショット ファイルには、各 SMTP イベントおよびトランスポート エージェントの検出時におけるメッセージの内容が含まれます。
SMTP イベントに対してトランスポート エージェントが登録されると、メッセージが任意のトランスポート エージェントを検出する前に、Exchange によってメッセージのメッセージ スナップショットが作成されます。 これにより、メッセージがそのイベントに対して登録されているトランスポート エージェントを検出する前に、メッセージがコピーされます。 次に、トランスポート エージェントによってメッセージの内容が変更されるかどうかにかかわらず、メッセージが検出したトランスポート エージェントごとに新しいメッセージ スナップショットが作成されます。 ただし、イベントに登録されているエージェントがない場合は、Exchange によってそのイベントのメッセージ スナップショットは作成されません。
たとえば、 OnEndofData イベントに 3 つのエージェントが登録されているにもかかわらず、2 つのトランスポート エージェントのみがメッセージを変更する場合は、4 つのメッセージ スナップショットが作成されます。 1 つ目のメッセージ スナップショットでは、 OnEndofData イベントに登録されているトランスポート エージェントによって変更が加えられる前に、そのイベントの検出時にメッセージを取得します。 その後、トランスポート エージェントによってメッセージが変更されるかどうかにかかわらず、トランスポート エージェントごとにメッセージ スナップショットが 1 つずつ作成されます。
作成されるメッセージ スナップショット ファイルを次のリストで説明します。
Original.eml: このファイルには、SMTP イベントまたはトランスポート エージェントが検出される前に、電子メール メッセージの元の変更されていない内容が含まれています。
Routingnnnn.eml: これらのファイルには、トランスポート サービスの分類部分で、それらのイベントに登録されている SMTP イベントとトランスポート エージェントのトランスポートが検出されると、電子メール メッセージの内容が含まれます。 プレースホルダー nnnn は、 で
0001始まる整数値を表します。 値は、SMTP イベントとそれらのイベントに登録されたトランスポート エージェントがメッセージに影響を及ぼした順序で、イベントとエージェントごとに増分されます。 メールボックス トランスポート配信サービスは、これらの Routing スナップショット ファイルを生成しません。SmtpReceivennnn.eml: これらのファイルには、トランスポート サービスまたはメールボックス トランスポート配信サービスの一部を受信する際に、これらのイベントに登録されている OnEndofData および OnEndOfHeaders SMTP イベントとトランスポート エージェントが検出されると、電子メール メッセージの内容が含まれます。 プレースホルダー nnnn は、 で
0001始まる整数値を表します。 値は、SMTP イベントとそれらのイベントに登録されたトランスポート エージェントがメッセージに影響を及ぼした順序で、イベントとエージェントごとに増分されます。
メッセージ スナップショット ファイルは、メモ帳や任意のテキスト エディターを使用して開くことができます。
各メッセージ スナップショット ファイルの先頭には、メッセージの本文に追加されているヘッダーと、そのメッセージ スナップショット ファイルが関連付けられている SMTP イベントおよびトランスポート エージェントの一覧が含まれます。 これらのヘッダーは で X-CreatedBy: MessageSnapshot-Begin injected headers 始まり、 で X-EndOfInjectedXHeaders: MessageSnapshot-End injected headers終わる。 これらのヘッダーは、以降のトランスポート エージェントと SNMP イベントによって、各メッセージ スナップショット ファイル内で置き換えられます。 以下に、電子メール メッセージ ファイルに追加されるヘッダーの例を示します。
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
ファイルには、メッセージ スナップショット ヘッダーの後に、元のメッセージ ヘッダーのすべてを含む、メッセージの内容が含まれます。 トランスポート エージェントによってメッセージの内容が変更される場合は、その変更内容がメッセージに統合されて表示されます。 各トランスポート エージェントによってメッセージが処理されるときに、各エージェントによって加えられる変更内容がメッセージの内容に適用されます。 トランスポート エージェントによってメッセージの内容に加えられる変更がない場合は、そのエージェントによって作成されるメッセージ スナップショットは、前のトランスポート エージェントによって作成されたメッセージ スナップショットと同じになります。