Трассировка конвейераPipeline tracing

Применимо к: Exchange Server 2013Applies to: Exchange Server 2013

Функция конвейерной трассировки отвечает за захват копий сообщений электронной почты от определенного отправителя по мере их перемещения через транспортную службу и службу доставки с помощью транспорта почтовых ящиков на серверах почтовых ящиков, а также через пограничные транспортные серверы. Функция конвейерной трассировки также отвечает за захват подробных сведений об изменениях, которые применяет каждый агент транспорта к сообщениям в транспортном конвейере, с помощью файлов моментальных снимков сообщений. Путем проверки содержимого файлов снимков сообщений можно определить, внесли ли агенты транспорта изменения в сообщения конвейерной трассировки передачи должным образом. При обнаружении неисправности необходимо определить, в каком агенте транспорта произошла ошибка. После этого, чтобы устранить неисправность, можно сосредоточиться на поиске ошибок этого агента. Затем можно просмотреть файлы снимков сообщений снова, чтобы убедиться, что устранение неисправности прошло успешно.Pipeline tracing captures copies of email messages from a specific sender as they move through the Transport service on Mailbox servers, the Mailbox Transport Delivery service on Mailbox servers, and through Edge Transport servers.. Pipeline tracing captures verbose information about the changes that each transport agent applies to messages in the transport pipeline in message snapshot files. By examining the contents of the message snapshot files, you can determine whether the transport agents have applied the changes to the messages in the transport pipeline that you expected. If you are troubleshooting a problem, you should determine which transport agent is at fault. Then you can focus your troubleshooting efforts on that agent to resolve the problem. You can then view the message snapshot files again to verify that your solution is successful.

Предупреждение

  • Функция конвейерной трассировки копирует все содержимое сообщений электронной почты, которые отправляются с адреса электронной почты отправителя. Чтобы избежать нежелательного раскрытия конфиденциальной информации, необходимо настроить соответствующие разрешения системы безопасности в папке конвейерной трассировки.Pipeline tracing copies the complete contents of email messages that are sent from the sender's email address. To avoid unwanted exposure of confidential information, you need to set appropriate security permissions on the pipeline tracing folder.

  • Не следует включать конвейерную трассировку на длительный период времени. Конвейерная трассировка создает файлы, которые могут быстро накапливаться. Если включена конвейерная трассировка, всегда следите за объемом свободного дискового пространства.Don't enable pipeline tracing for long periods of time. Pipeline tracing creates files that can accumulate quickly. Always monitor available disk space when pipeline tracing is enabled.

Настройка конвейерной трассировкиConfigure pipeline tracing

Прежде чем включить конвейерную трассировку, необходимо указать адрес электронной почты отправителя, за которым следует вести наблюдение. Конвейерная трассировка предназначена для внесения в журнал сообщений, которые отправляются с определенного адреса электронной почты. Адрес электронной почты отправителя может являться внутренним или внешним по отношению к организации Exchange. Также можно включить конвейерную трассировку для системных сообщений, которые создаются транспортной службой на указанном сервере почтовых ящиков или пограничном транспортном сервере, например автоматических ответов, уведомлений о доставке, отчетов журналов и т. д. Можно также изменить расположение папки конвейерной трассировки.Before you enable pipeline tracing, you need to specify the sender's email address you want to monitor. Pipeline tracing is designed to log messages sent from a specific email address. The sender's email address can be internal or external to your Exchange organization. Alternatively, you can enable pipeline tracing for system messages generated by the transport service on the specified Mailbox or Edge Transport server, such as automatic replies, delivery status notification (DSN) messages, journal reports, and other system-generated messages You can also modify the location of the pipeline tracing folder.

Параметры, которые используются для настройки конвейерной трассировки, приведены в следующей таблице.The parameters that you use to configure pipeline tracing are summarized in the following table

КомандлетCmdlet ПараметрParameter Значение по умолчаниюDefault value ОписаниеDescription

SET-TransportServiceSet-TransportService

SET-MailboxTransportServiceSet-MailboxTransportService

PipelineTracingSenderAddressPipelineTracingSenderAddress

Пустой ($null)Blank ($null)

Указывает адрес электронной почты отправителя, за которым необходимо вести наблюдение.Specify the email address of the sender you want to monitor.

Укажите значение " < > " мониторинг созданных системой сообщений, отправленных с указанного транспортной службы на сервере.Specify the value "<>" to monitor system-generated messages sent by the specified transport service on the server.

SET-TransportServiceSet-TransportService

SET-MailboxTransportServiceSet-MailboxTransportService

PipelineTracingPathPipelineTracingPath

Служба транспорта %ExchangeInstallPath%TransportRoles\Logs\Hub\PipelineTracingTransport service %ExchangeInstallPath%TransportRoles\Logs\Hub\PipelineTracing

Транспортная служба почтовых ящиков %ExchangeInstallPath%TransportRoles\Logs\Mailbox\PipelineTracingMailbox Transport service %ExchangeInstallPath%TransportRoles\Logs\Mailbox\PipelineTracing

Путь должен находиться на локальном сервере. UNC-пути не поддерживаются. The path must be on the local server. UNC paths aren't supported.

Указанный путь содержит MessageSnapshots папку, где хранятся файлы конвейерной трассировки.The specified path contains the MessageSnapshots folder where pipeline tracing files are stored.

SET-TransportServiceSet-TransportService

SET-MailboxTransportServiceSet-MailboxTransportService

PipelineTracingEnabledPipelineTracingEnabled

$false

Конвейерную трассировку можно включить только для указанной транспортной службы на сервере после настройки адреса отправителя, за которым необходимо вести наблюдение.You can only enable pipeline tracing for the specified transport service on the server after you configure the sender address you want to monitor.

Дополнительные сведения о том, как разрешить конвейерную трассировку и настроить для нее адрес отправителя, см. в статье Настройка конвейерной трассировки.For more information about how to enable pipeline tracing and configure the sender address for pipeline tracing, see Configure pipeline tracing.

Файлы моментальных снимков сообщенийMessage snapshot files

Моментальные снимки сообщений — файлы, получение всех изменений, внесенных в сообщение с агенты транспорта в службе транспорта или службу доставки транспорта почтовых ящиков. Эти файлы хранятся в MessageSnapshots папок в соответствующие пути конвейерной трассировки для транспортной службы.Message snapshots are files that capture any changes made to a message by transport agents in the Transport service or the Mailbox Transport Delivery service. These files are stored in the MessageSnapshots folder in the corresponding pipeline tracing path for the transport service.

В MessageSnapshots папки, Exchange создает один папки для каждого сообщения, отправленные отправителем отслеживаемых, проходящий по указанным транспортной службы. С именем каждой папки — это GUID, назначенный к сообщению. При включении конвейерной трассировки для службы транспорта и транспортной службы почтовых ящиков на том же сервере почтовых ящиков, другой код GUID назначается то же сообщение с каждой службы транспорта, поэтому назовите папку сообщения в MessageSnapshots папки для транспорта службы, отличается от имя папки для того же сообщения в MessageSnapshots папки для транспортной службы почтовых ящиков. При включении конвейерной трассировки на нескольких серверах Exchange, другой код GUID назначается то же сообщение с компьютером через указанный транспортной службы на каждом сервере Exchange.In the MessageSnapshots folder, Exchange creates one folder for each message sent by the monitored sender that flows through the specified transport service. Each folder is named after a GUID that's assigned to the message. If you enable pipeline tracing for the Transport service and the Mailbox Transport service on the same Mailbox server, a different GUID is assigned to the same message by each transport service, so the folder name for a message in the MessageSnapshots folder for the Transport service is different than the folder name for the same message in the MessageSnapshots folder for the Mailbox Transport service. If you enable pipeline tracing on more than one Exchange server, a different GUID is assigned to the same message as it travels through the specified transport service on each Exchange server.

В каждой папке сообщений служба Exchange создает несколько файлов моментальных снимков сообщений с расширением EML. Эти файлы моментальных снимков сообщений включают в себя содержимое сообщения, которое записывается по мере обнаружения каждого события SMTP и агента транспорта.In each message folder, Exchange creates several message snapshot files that have .eml file extensions. These message snapshot files contain the contents of the message as it encounters each SMTP event and transport agent.

Если агент транспорта зарегистрирован в событии SMTP, служба Exchange создает моментальный снимок сообщения еще до того, как сообщение столкнется с агентами транспорта. В результате копия сообщения создается перед тем, как это сообщение обнаружит агентов транспорта, зарегистрированных в этом событии. Затем создается новый снимок сообщения для каждого агента транспорта, которого обнаруживает сообщение независимо от того, изменил ли агент транспорта содержимое сообщения. Однако если для данного события отсутствуют зарегистрированные агенты, служба Exchange не создает ни одного моментального снимка сообщения для этого события.If a transport agent is registered on an SMTP event, Exchange creates a message snapshot of the message before the message encounters any transport agents. This gives you a copy of the message before the message encounters transport agents that are registered on that event. Then, a new message snapshot is created for each transport agent that the message encounters, regardless of whether a transport agent modifies the contents of the message. However, if no agents are registered on an event, Exchange doesn't create any messages snapshots for that event.

Например, если в событии OnEndofData зарегистрировано три агента транспорта, однако, только два из них изменяют сообщение, создается четвертый снимок сообщения. Первый снимок сообщения делается тогда, когда оно обнаруживает событие OnEndofData до внесения в сообщение изменений агентом транспорта, зарегистрированным в этом событии. Затем для каждого агента транспорта создается один снимок сообщения независимо от того, изменил ли его агент транспорта.For example, if three agents are registered on the OnEndofData event but only two of the transport agents modify a message, four message snapshots are created. The first message snapshot captures the message as it encounters the OnEndofData event before any modifications that are made by the transport agents that registered on that event. Then, one message snapshot is created for each transport agent regardless of whether a transport agent modifies the message.

Создаваемые файлы моментальных снимков сообщений описаны в следующем списке.The message snapshot files that are created are described in the following list:

  • Original.eml этот файл с содержимым исходного немодифицированного сообщения электронной почты перед его обнаруживает все события SMTP или агенты транспорта.Original.eml This file contains the original unmodified contents of the email message before it encounters any SMTP events or transport agents.

  • При обходе событий транспорта SMTP и транспортных агентов, зарегистрированных на эти события категоризации частью службу транспорта Routingnnnn.eml эти файлы содержат содержимое сообщения электронной почты. Заполнитель nnnn представляет собой целое значение, которое начинается с 0001. Значение увеличивается для всех SMTP событий и транспортных агентов зарегистрирован на эти события в том порядке, в котором события и агенты действовать в окне сообщения. Служба доставки транспорта почтовых ящиков не создаются этих файлов моментальных снимков маршрутизации .Routingnnnn.eml These files contain the contents of the email message as it encounters transport the SMTP events and transport agents registered on those events in the categorization part of the Transport service. The placeholder nnnn represents an integer value that starts with 0001. The value is incremented for every SMTP event and transport agent registered on those events in the order in which the events and agents act on the message. The Mailbox Transport Delivery service doesn't generate these Routing snapshot files.

  • SmtpReceivennnn.eml эти файлы содержат содержимое сообщения электронной почты, при обнаружении события OnEndofData и OnEndOfHeaders SMTP и агенты транспорта, зарегистрированных в этих событий во время SMTP получают частью транспорта Служба и служба транспорта почтовых ящиков доставки. Заполнитель nnnn представляет собой целое значение, которое начинается с 0001. Значение увеличивается для всех SMTP событий и транспортных агентов зарегистрирован на эти события в том порядке, в котором события и агенты действовать в окне сообщения.SmtpReceivennnn.eml These files contain the contents of the email message as it encounters the OnEndofData and OnEndOfHeaders SMTP events and transport agents registered on those events during the SMTP receive part of the Transport service or the Mailbox Transport Delivery service. The placeholder nnnn represents an integer value that starts with 0001. The value is incremented for every SMTP event and transport agent registered on those events in the order in which the events and agents act on the message.

Файлы моментальных снимков сообщений можно открыть с помощью Блокнота или любого текстового редактора.You can open the message snapshot files by using Notepad or any text editor.

Каждый файл моментальный снимок сообщение начинается с заголовков, которые добавляются в содержимое сообщения и списков, файл моментальный снимок сообщение относится к агента транспорта и события SMTP. Эти заголовки начинаются с X-CreatedBy: MessageSnapshot-Begin injected headers и заканчиваться X-EndOfInjectedXHeaders: MessageSnapshot-End injected headers. Эти заголовки, заменяются в каждом файле моментальных снимков сообщений каждого агента последующих транспорта и события SMTP. Ниже приведен пример заголовков, которые добавлены в файле сообщения электронной почты:Each message snapshot file starts with headers that are added to the message contents and list the SMTP event and transport agent that the message snapshot file relates to. These headers start with X-CreatedBy: MessageSnapshot-Begin injected headers and end with X-EndOfInjectedXHeaders: MessageSnapshot-End injected headers. These headers are replaced in each message snapshot file by each subsequent transport agent and SMTP event. The following is an example of the headers that are added to an email message file:

    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

После заголовков моментальных снимков сообщений файлы включают содержимое сообщений, в том числе все заголовки исходных сообщений. Если агент транспорта изменяет содержимое сообщения, то изменения отображаются вместе с сообщением. Поскольку сообщение обрабатывается всеми агентами транспорта, вносимые каждым агентом изменения применяются к содержимому сообщения. Если агент транспорта не внес никаких изменений в содержимое сообщения, снимок сообщения, созданного этим агентом, совпадает со снимком сообщения, созданным предыдущим агентом транспорта.After the message snapshot headers, the file contains the contents of the message including all the original message headers. If a transport agent modifies the contents of the message, the changes appear integrated with the message. As the message is processed by each transport agent, the changes that are made by each agent are applied to the message contents. If a transport agent makes no changes to the message contents, the message snapshot that is created by that agent will be identical to the message snapshot created by the previous transport agent.