Partager via

Guide pratique pour configurer le suivi réseau

Le fichier de configuration de l’application ou de l’ordinateur contient les paramètres qui déterminent le format et le contenu des traces réseau. Avant d’effectuer cette procédure, assurez-vous que le suivi est activé. Pour plus d’informations, consultez Activer le suivi réseau.

Le fichier de configuration de l’ordinateur, machine.config, est stocké dans le dossier %windir%\Microsoft.NET\Framework . Il existe un fichier machine.config distinct dans les dossiers sous %windir%\Microsoft.NET\Framework pour chaque version du .NET Framework installée sur l’ordinateur, par exemple :

  • C:\WINDOWS\Microsoft.NET\Framework\v2.0.50727\Config\machine.config
  • C:\WINDOWS\Microsoft.NET\Framework64\v4.0.30319\Config\machine.config

Ces paramètres peuvent également être effectués dans le fichier de configuration de l’application, qui a la priorité sur le fichier de configuration de l’ordinateur.

Configurer le suivi réseau

Pour configurer le suivi réseau, ajoutez les lignes suivantes au fichier de configuration approprié. Les valeurs et les options de ces paramètres sont décrites dans les tableaux ci-dessous.

<configuration>
  <system.diagnostics>
    <sources>
      <source name="System.Net" tracemode="includehex" maxdatasize="1024">
        <listeners>
          <add name="System.Net"/>
        </listeners>
      </source>
      <source name="System.Net.Cache">
        <listeners>
          <add name="System.Net"/>
        </listeners>
      </source>
      <source name="System.Net.Http">
        <listeners>
          <add name="System.Net"/>
        </listeners>
      </source>
      <source name="System.Net.Sockets">
        <listeners>
          <add name="System.Net"/>
        </listeners>
      </source>
      <source name="System.Net.WebSockets">
        <listeners>
          <add name="System.Net"/>
        </listeners>
      </source>
   </sources>
    <switches>
      <add name="System.Net" value="Verbose"/>
      <add name="System.Net.Cache" value="Verbose"/>
      <add name="System.Net.Http" value="Verbose"/>
      <add name="System.Net.Sockets" value="Verbose"/>
      <add name="System.Net.WebSockets" value="Verbose"/>
    </switches>
    <sharedListeners>
      <add name="System.Net"
        type="System.Diagnostics.TextWriterTraceListener"
        initializeData="network.log"
        traceOutputOptions="ProcessId, DateTime"
      />
    </sharedListeners>
    <trace autoflush="true"/>
  </system.diagnostics>
</configuration>

Tracé de sortie des méthodes

Lorsque vous ajoutez un nom au <switches> bloc, la sortie de trace inclut des informations de certaines méthodes liées au nom. Le tableau suivant décrit la sortie :

Nom Sortie de
System.Net.Sockets Certaines méthodes publiques des classes Socket, TcpListener, TcpClient, et Dns.
System.Net Certaines méthodes publiques des classes HttpWebRequest, HttpWebResponse, FtpWebRequest, et FtpWebResponse, et les informations de débogage SSL (certificats non valides, liste d'émetteurs manquante, et erreurs de certificat client).
System.Net.HttpListener Certaines méthodes publiques des classes HttpListener, HttpListenerRequest et HttpListenerResponse.
System.Net.Cache Certaines méthodes privées et internes dans System.Net.Cache.
System.Net.Http Certaines méthodes publiques des classes HttpClient, DelegatingHandler, HttpClientHandler, HttpMessageHandler, MessageProcessingHandler et WebRequestHandler.
System.Net.WebSockets.WebSocket Certaines méthodes publiques des classes ClientWebSocket et WebSocket.

Attributs de sortie de trace

Les attributs répertoriés dans le tableau suivant configurent la sortie de trace :

Nom de l’attribut Valeur de l’attribut
value Attribut obligatoire String . Définit le niveau de détail de la sortie. Les valeurs légitimes sont Critical, , ErrorVerbose, Warninget Information.

Cet attribut doit être défini sur l’élément add de l’élément switches . Une exception est levée si cet attribut est défini sur l’élément source .

Exemple : <add name="System.Net" value="Verbose"/>
maxdatasize Attribut facultatif Int32 . Définit le nombre maximal d’octets de données réseau incluses dans chaque trace de ligne. La valeur par défaut est 1024.

Cet attribut doit être défini sur l’élément source . Une exception est levée si cet attribut est défini sur un élément sous l’élément switches .

Exemple : <source name="System.Net" tracemode="includehex" maxdatasize="1024">
tracemode Attribut facultatif String . Définissez includehex pour afficher les traces de protocole en format hexadécimal et texte. Réglez sur protocolonly pour n'afficher que du texte. La valeur par défaut est includehex.

Cet attribut doit être défini sur l’élément source . Une exception est levée si cet attribut est défini sur un élément sous l’élément switches .

Exemple : <source name="System.Net" tracemode="includehex" maxdatasize="1024">

Voir aussi

  • Last updated on