Vorgehensweise: Konfigurieren der Netzwerkablaufverfolgung

  • Artikel

Die Anwendungs- oder Computerkonfigurationsdatei enthält die Einstellungen, die das Format und die Inhalte von Netzwerkablaufverfolgungen bestimmen. Bevor Sie diese Verfahren ausführen, stellen Sie sicher, dass die Ablaufverfolgung aktiviert ist. Weitere Informationen finden Sie unter Aktivieren der Netzwerkablaufverfolgung.

Die Computerkonfigurationsdatei machine.config wird im Ordner %windir%\Microsoft.NET\Framework gespeichert. Es gibt für jede Version von .NET Framework, die auf dem Computer installiert ist, eine eigene machine.config-Datei in den Unterordnern von %windir%\Microsoft.NET\Framework, z. B.:

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

Diese Einstellungen können auch in der Konfigurationsdatei für die Anwendung vorgenommen werden. Die Anwendungskonfigurationsdatei hat Vorrang vor der Computerkonfigurationsdatei.

Konfigurieren der Netzwerkablaufverfolgung

Fügen Sie der jeweiligen Konfigurationsdatei die folgenden Zeilen hinzu, um die Netzwerkablaufverfolgung zu konfigurieren. Die Werte und Optionen für diese Einstellungen sind in den folgenden Tabellen beschrieben.

<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>

Ablaufverfolgungsausgabe von Methoden

Wenn Sie einen Namen im <switches>-Block hinzufügen, enthält die Ausgabe der Ablaufverfolgung Informationen von einigen zu diesem Namen gehörenden Methoden. Die Ausgabe wird in der folgenden Tabelle beschrieben:

name Ausgabe von
System.Net.Sockets Einige öffentliche Methoden der Klassen Socket, TcpListener, TcpClient und Dns.
System.Net Einige öffentliche Methoden der Klassen HttpWebRequest, HttpWebResponse, FtpWebRequest und FtpWebResponse sowie SSL-Debuginformationen (ungültige Zertifikate, fehlende Ausstellerliste und Clientzertifikatsfehler).
System.Net.HttpListener Einige öffentliche Methoden der Klassen HttpListener, HttpListenerRequest und HttpListenerResponse.
System.Net.Cache Einige private und interne Methoden in System.Net.Cache.
System.Net.Http Einige öffentliche Methoden der Klassen HttpClient, DelegatingHandler, HttpClientHandler, HttpMessageHandler, MessageProcessingHandler und WebRequestHandler.
System.Net.WebSockets.WebSocket Einige öffentliche Methoden der Klassen ClientWebSocket und WebSocket.

Attribute der Ablaufverfolgungsausgabe

Die in der folgenden Tabelle aufgeführten Attribute konfigurieren die Ablaufverfolgungsausgabe:

Attributname Attributwert
value Erforderliches String-Attribut. Legt den Ausführlichkeitsgrad der Ausgabe fest. Zulässige Werte sind Critical, Error, Verbose, Warning und Information.

Dieses Attribut muss für das Element Hinzufügen des Elements switches festgelegt werden. Eine Ausnahme wird ausgelöst, wenn das Attribut für das Element source festgelegt wird.

Ein Beispiel: <add name="System.Net" value="Verbose"/>
maxdatasize Optionales Int32-Attribut. Legt die maximale Anzahl von Netzwerkdatenbytes für jede Ablaufverfolgungszeile fest. Der Standardwert ist 1024.

Dieses Attribut muss für das Element Quelle wie im Beispiel festgelegt werden. Eine Ausnahme wird ausgelöst, wenn dieses Attribut für ein Element unter dem Element switches festgelegt wird.

Ein Beispiel: <source name="System.Net" tracemode="includehex" maxdatasize="1024">
tracemode Optionales String-Attribut. Mit dem Wert includehex werden Protokollablaufverfolgungen im Hexadezimalformat und im Textformat angezeigt. Mit dem Wert protocolonly wird nur Text angezeigt. Der Standardwert ist includehex.

Dieses Attribut muss für das Element Quelle wie im Beispiel festgelegt werden. Eine Ausnahme wird ausgelöst, wenn dieses Attribut für ein Element unter dem Element switches festgelegt wird.

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

Siehe auch