Suivi de pipeline dans Exchange 2013
S’applique à : Exchange Server 2013
Le suivi du pipeline capture des copies des messages électroniques en provenance d'un expéditeur spécifique pendant qu'ils transitent dans le service de transport sur des serveurs de boîtes aux lettres, dans le service de remise de transport de boîtes aux lettres sur des serveurs de boîtes aux lettres ou dans des serveurs de transport Edge. Le suivi du pipeline capture des informations détaillées sur les modifications que chaque agent de transport applique aux messages figurant dans le pipeline de transport dans des fichiers d'instantané de message. En examinant le contenu des fichiers instantanés de message, vous pouvez déterminer si les agents de transport ont appliqués les modifications que vous avez prévues aux messages figurant dans le pipeline de transport. Si vous dépannez un problème, vous devez déterminer quel agent de transport en est la cause. Vous pouvez ensuite concentrer vos efforts de dépannage sur cet agent pour résoudre le problème. Puis, vous pouvez afficher de nouveau les fichiers instantanés de message pour vérifier que votre solution fonctionne.
Avertissement
- Le suivi du pipeline copie le contenu complet des messages électroniques envoyés à partir de l'adresse de messagerie de l'expéditeur. Pour éviter toute exposition involontaire d'informations confidentielles, vous devez définir les autorisations de sécurité appropriées sur le dossier de suivi du pipeline.
- N'activez pas le suivi du pipeline pour de longues périodes. Le suivi du pipeline génère des fichiers qui s'accumulent rapidement. Surveillez toujours l'espace disque disponible lorsque le suivi du pipeline est activé.
Configuration du suivi du pipeline
Avant d’activer le suivi de pipeline, vous devez spécifier l’adresse e-mail de l’expéditeur que vous souhaitez surveiller. Le suivi de pipeline est conçu pour journaliser les messages envoyés à partir d’une adresse e-mail spécifique. L’adresse e-mail de l’expéditeur peut être interne ou externe à votre organisation Exchange. Vous pouvez également activer le suivi de pipeline pour les messages système générés par le service de transport sur la boîte aux lettres ou le serveur de transport Edge spécifié, tels que les réponses automatiques, les messages de notification d’état de remise (DSN), les rapports de journal et d’autres messages générés par le système. Vous pouvez également modifier l’emplacement du dossier de suivi du pipeline.
Les paramètres que vous utilisez pour configurer le suivi de pipeline sont résumés dans le tableau suivant :
| Cmdlet | Paramètre | Valeur par défaut | Description |
|---|---|---|---|
| Set-TransportService Set-MailboxTransportService |
PipelineTracingSenderAddress | Vide ($null) |
Spécifiez l'adresse de messagerie de l'expéditeur que vous voulez surveiller. Spécifiez la valeur « |
| Set-TransportService Set-MailboxTransportService |
PipelineTracingPath | Service de transport : %ExchangeInstallPath%TransportRoles\Logs\Hub\PipelineTracing Service de transport de boîtes aux lettres : |
Le chemin d'accès doit être sur le serveur local. Les chemins d'accès UNC ne sont pas pris en charge. Le chemin d’accès spécifié contient le |
| Set-TransportService Set-MailboxTransportService |
PipelineTracingEnabled | $false |
Vous pouvez activer le suivi du pipeline pour le service de transport spécifié sur le serveur uniquement après avoir configuré l'adresse de l'expéditeur que vous voulez surveiller. |
Pour plus d'informations sur la procédure d'activation du suivi de pipeline et de configuration de l'adresse de l'expéditeur pour le suivi de pipeline, consultez la rubrique Configuration du suivi du pipeline.
Fichiers instantanés de message
Les fichiers instantanés de message sont des fichiers qui capturent toutes les modifications apportées à un message par des agents de transport dans le service de transport ou le service de remise de transport de boîtes aux lettres. Ces fichiers sont stockés dans le MessageSnapshots dossier dans le chemin de suivi de pipeline correspondant pour le service de transport.
Dans le MessageSnapshots dossier, Exchange crée un dossier pour chaque message envoyé par l’expéditeur surveillé qui transite par le service de transport spécifié. Chaque dossier est nommé d'après un GUID attribué au message. Si vous activez le suivi de pipeline pour le service de transport et le service de transport de boîtes aux lettres sur le même serveur de boîtes aux lettres, un GUID différent est affecté au même message par chaque service de transport. Par conséquent, le nom de dossier d’un message dans le MessageSnapshots dossier du service de transport est différent du nom du dossier pour le même message dans le MessageSnapshots dossier du service de transport de boîtes aux lettres. Si vous activez le suivi du pipeline sur plusieurs serveurs Exchange, un GUID distinct est attribué au même message lorsqu'il transite dans le service de transport sur chaque serveur Exchange.
Dans chaque dossier de messages, Exchange crée plusieurs fichiers instantanés de message portant l'extension .eml. Ces fichiers instantanés de message incluent le contenu du message reflétant chaque événement SMTP et agent de transport rencontré.
Si un agent de transport est inscrit sur un événement SMTP, Exchange crée un instantané de message avant que le message ne rencontre des agents de transport. Cela vous donne une copie du message avant qu’il ne rencontre les agents de transport qui sont inscrits sur cet événement. Ensuite, un nouvel instantané de message est créé pour chaque agent de transport rencontré par le message, qu’un agent de transport modifie ou non le contenu du message. Toutefois, si aucun agent n’est inscrit sur un événement, Exchange ne crée aucun instantané de messages pour cet événement.
Par exemple, si trois agents de transport sont enregistrés sur l'événement OnEndofData mais que seuls deux d'entre eux modifient un message, quatre instantanés de message sont créés. Le premier instantané de message capture le message lorsqu'il rencontre l'événement OnEndofData avant toute modification effectuée par les agents de transport enregistrés sur cet événement. Ensuite, un instantané de message est créé pour chaque agent de transport, même si ce dernier ne modifie pas le message.
La fichiers instantanés de message créés sont décrits dans la liste suivante :
Original.eml : ce fichier contient le contenu non modifié d’origine du message électronique avant qu’il ne rencontre des événements SMTP ou des agents de transport.
Routingnnnn.eml : ces fichiers contiennent le contenu du message électronique à mesure qu’il rencontre les événements SMTP et les agents de transport inscrits sur ces événements dans la partie catégorisation du service transport. L’espace réservé nnnn représente une valeur entière qui commence par
0001. Cette valeur est incrémentée pour chaque événement SMTP et agent de transport enregistré sur cet événement dans l'ordre dans lequel les événements et agents agissent sur le message. Le service de remise de transport de boîtes aux lettres ne génère pas ces fichiers instantanés de Routage.SmtpReceivennnn.eml : ces fichiers contiennent le contenu du message électronique lorsqu’il rencontre les événements SMTP OnEndofData et OnEndOfHeaders et les agents de transport inscrits sur ces événements pendant la partie de réception SMTP du service de transport ou du service de livraison de transport de boîte aux lettres. L’espace réservé nnnn représente une valeur entière qui commence par
0001. Cette valeur est incrémentée pour chaque événement SMTP et agent de transport enregistré sur cet événement dans l'ordre dans lequel les événements et agents agissent sur le message.
Vous pouvez ouvrir les fichiers instantanés de message à l'aide de Bloc-notes ou de tout éditeur de texte.
Chaque fichier instantané de message commence par des en-têtes qui sont ajoutés au contenu du message et répertorient l'événement SMTP et l'agent de transport auquel le fichier instantané de message est lié. Ces en-têtes commencent par et se terminent X-CreatedBy: MessageSnapshot-Begin injected headers par X-EndOfInjectedXHeaders: MessageSnapshot-End injected headers. Ils sont remplacés dans chaque fichier instantané de message par l'agent de transport et l'événement SMTP suivants. Voici un exemple des en-têtes qui sont ajoutés à un fichier de message électronique :
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
Sous les en-têtes de l'instantané de message, le fichier inclut le contenu du message comprenant tous les en-têtes du message d'origine. Si un agent de transport modifie le contenu du message, les modifications sont intégrées au message. Le message étant traité par chaque agent de transport, les modifications apportées par chaque agent sont appliquées au contenu du message. Si un agent de transport ne modifie pas le contenu du message, l'instantané de message créé par cet agent est identique à l'instantané de message créé par l'agent de transport précédent.