<filters>
L'élément filters détient une collection de filtres XPath utilisés pour contrôler le type de message enregistré.
Les filtres sont appliqués uniquement à la couche de transport, spécifiée par logMessagesAtTransportLevel (valeur true). Le niveau de service et l'enregistrement du message incorrect ne sont pas affectés par les filtres.
Pour ajouter un filtre à la collection, utilisez le mot clé add. Lorsqu'un ou plusieurs filtres sont définis, seuls les messages qui correspondent au moins à l'un des filtres sont enregistrés. Si aucun filtre n'est défini, tous les messages passent.
Les filtres prennent en charge la syntaxe XPath complète et s’appliquent dans l’ordre dans lequel ils apparaissent dans le fichier de configuration. Un filtre syntaxiquement incorrect provoque la levée d'une exception de configuration.
L'exemple de code suivant illustre comment configurer un filtre afin que seuls les messages contenant une section d'en-tête SOAP soient enregistrés.
<messageLogging logEntireMessage="true"
logMalformedMessages="true"
logMessagesAtServiceLevel="true"
logMessagesAtTransportLevel="true"
maxMessagesToLog="420">
<filters>
<add xmlns:soap="http://www.w3.org/2003/05/soap-envelope">
/soap:Envelope/soap:Headers
</add>
</filters>
</messageLogging>
