Paramètres recommandés pour le suivi et l'enregistrement des messagesRecommended Settings for Tracing and Message Logging

Cette rubrique décrit les paramètres de suivi et d'enregistrement des messages recommandés pour différents environnements d'exploitation.This topic describes recommended tracing and message logging settings for different operating environments.

Pour un environnement de production, si vous utilisez les sources de suivi WCF, affectez à switchValue la valeur Warning.For a production environment, if you are using WCF trace sources, set the switchValue to Warning. Si vous utilisez la source de suivi WCF System.ServiceModel, affectez à l'attribut switchValue la valeur Warning et à l'attribut propagateActivity la valeur true.If you are using the WCF System.ServiceModel trace source, set the switchValue attribute to Warning and the propagateActivity attribute to true. Si vous utilisez une source de suivi définie par l'utilisateur, affectez à l'attribut switchValue la valeur Warning, ActivityTracing.If you are using a user-defined trace source, set the switchValue attribute to Warning, ActivityTracing. Cela peut être effectuée manuellement à l’aide de la l’outil Éditeur de Configuration (SvcConfigEditor.exe).This can be done manually using the Configuration Editor Tool (SvcConfigEditor.exe). Si vous ne prévoyez pas d'augmentation des performances, vous pouvez affecter la valeur switchValue à l'attribut Information dans tous les cas mentionnés précédemment, ce qui génère une quantité assez élevée de données de suivi.If you do not anticipate a hit in performance, you can set the switchValue attribute to Information in all the previously mentioned cases, which generates a fairly large amount of trace data. L'exemple suivant illustre ces paramètres recommandés.The following example demonstrates these recommended settings.

<configuration>  
 <system.diagnostics>  
  <sources>  
    <source name="System.ServiceModel"  
            switchValue="Warning"  
            propagateActivity="true" >  
      <listeners>  
        <add name="xml"/>  
      </listeners>  
    </source>  
    <source name="myUserTraceSource"  
            switchValue="Warning, ActivityTracing">  
      <listeners>  
        <add name="xml"/>  
      </listeners>  
    </source>  
  </sources>  
  <sharedListeners>  
    <add name="xml"  
         type="System.Diagnostics.XmlWriterTraceListener"  
               initializeData="C:\logs\Traces.svclog" />  
  </sharedListeners>  
 </system.diagnostics>  

<system.serviceModel>  
  <diagnostics wmiProviderEnabled="true">  
  </diagnostics>  
 </system.serviceModel>  
</configuration>  

Pour l'environnement de déploiement ou de débogage , choisissez Information ou Verbose, avec ActivityTracing pour une source de suivi System.ServiceModel ou définie par l'utilisateur.For deployment or debugging environment, choose Information or Verbose, along with ActivityTracing for either a user-defined or System.ServiceModel trace source. Pour améliorer le débogage, vous devez également ajouter une source de suivi supplémentaire (System.ServiceModel.MessageLogging) à la configuration afin d'activer l'enregistrement des messages.To enhance debugging, you should also add an additional trace source (System.ServiceModel.MessageLogging) to the configuration to enable message logging. Remarquez que l'attribut switchValue n'a aucun impact sur cette source de suivi.Notice that the switchValue attribute has no impact on this trace source.

L'exemple suivant illustre les paramètres recommandés, à l'aide d'un écouteur partagé qui utilise le XmlWriterTraceListener.The following example demonstrates the recommended settings, using a shared listener that utilizes the XmlWriterTraceListener.

<configuration>  
 <system.diagnostics>  
  <sources>  
    <source name="System.ServiceModel"  
            switchValue="Information, ActivityTracing"  
            propagateActivity="true" >  
      <listeners>  
        <add name="xml"/>  
      </listeners>  
    </source>  
    <source name="System.ServiceModel.MessageLogging">  
      <listeners>  
        <add name="xml"/>  
      </listeners>  
    </source>  
    <source name="myUserTraceSource"  
            switchValue="Information, ActivityTracing">  
      <listeners>  
        <add name="xml"/>  
      </listeners>  
    </source>  
  </sources>  
  <sharedListeners>  
    <add name="xml"  
         type="System.Diagnostics.XmlWriterTraceListener"  
               initializeData="C:\logs\Traces.svclog" />  
  </sharedListeners>  
 </system.diagnostics>  

 <system.serviceModel>  
  <diagnostics wmiProviderEnabled="true">  
      <messageLogging   
           logEntireMessage="true"   
           logMalformedMessages="true"  
           logMessagesAtServiceLevel="true"   
           logMessagesAtTransportLevel="true"  
           maxMessagesToLog="3000"   
       />  
  </diagnostics>  
 </system.serviceModel>  
</configuration>  

Utilisation de WMI pour modifier des paramètresUsing WMI to Modify Settings

Vous pouvez utiliser WMI pour modifier des paramètres de configuration pendant l'exécution (en activant l'attribut wmiProviderEnabled dans la configuration, comme cela est indiqué dans l'exemple de configuration précédent).You can use WMI to change configuration settings at runtime (by enabling the wmiProviderEnabled attribute in the configuration, as demonstrated in the previously configuration example). Par exemple, vous pouvez utiliser WMI dans le CIM Studio pour modifier les niveaux de source de suivi de Warning à Information au moment de l'exécution.For example, you can use WMI within the CIM Studio to change the trace source levels from Warning to Information at runtime. Vous devez savoir que le coût de performance du débogage en direct de cette manière peut être très élevé.You should be aware that the performance cost of live debugging in this way can be very high. Pour plus d’informations sur l’utilisation de WMI, consultez le à l’aide de Windows Management Instrumentation pour les Diagnostics rubrique.For more information about using WMI, see the Using Windows Management Instrumentation for Diagnostics topic.

Activer des événements corrélés dans le suivi ASP.NETEnable Correlated Events in ASP.NET Tracing

Les événements ASP.NET ne définissent pas l'ID de corrélation (ActivityID), sauf si le suivi de l'élément ASP.NET est activé.ASP.NET events do not set the correlation ID (ActivityID) unless ASP.NET event tracing is turned on. Pour afficher les événements en corrélation correctement, vous devez activer des événements ASP.NET suivi à l’aide de la commande suivante dans la console de commande, qui peut être appelée en accédant à Démarrer, exécuter et type cmd ,To see correlated events properly, you have to turn on ASP.NET events tracing using the following command in the command console, which can be invoked by going to Start, Run and type cmd,

logman start mytrace -pf logman.providers -o test.etl –ets  

Pour désactiver le suivi des événements ASP.NET, utilisez la commande suivante,To turn off tracing of ASP.NET events, use the following command,

logman stop mytrace -ets  

Voir aussiSee Also

Utilisation de Windows Management Instrumentation pour les diagnosticsUsing Windows Management Instrumentation for Diagnostics