Vorgehensweise: Konfigurieren der NetzwerkablaufverfolgungHow to: Configure network tracing

Die Anwendungs- oder Computerkonfigurationsdatei enthält die Einstellungen, die das Format und die Inhalte von Netzwerkablaufverfolgungen bestimmen.The application or computer configuration file holds the settings that determine the format and content of network traces. Bevor Sie diese Verfahren ausführen, stellen Sie sicher, dass die Ablaufverfolgung aktiviert ist.Before performing this procedure, be sure tracing is enabled. Weitere Informationen finden Sie unter Aktivieren der Netzwerkablaufverfolgung.For more information, see Enable network tracing.

Die Computerkonfigurationsdatei machine.config wird im Ordner %windir%\Microsoft.NET\Framework gespeichert.The computer configuration file, machine.config, is stored in the %windir%\Microsoft.NET\Framework folder. 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.:There is a separate machine.config file in the folders under %windir%\Microsoft.NET\Framework for each version of the .NET Framework installed on the computer, for example:

  • C:\WINDOWS\Microsoft.NET\Framework\v2.0.50727\Config\machine.configC:\WINDOWS\Microsoft.NET\Framework\v2.0.50727\Config\machine.config
  • C:\WINDOWS\Microsoft.NET\Framework64\v4.0.30319\Config\machine.configC:\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.These settings can also be made in the configuration file for the application, which has precedence over the computer configuration file.

Konfigurieren der NetzwerkablaufverfolgungConfigure network tracing

Fügen Sie der jeweiligen Konfigurationsdatei die folgenden Zeilen hinzu, um die Netzwerkablaufverfolgung zu konfigurieren.To configure network tracing, add the following lines to the appropriate configuration file. Die Werte und Optionen für diese Einstellungen sind in den folgenden Tabellen beschrieben.The values and options for these settings are described in the tables below.

<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 MethodenTrace output from methods

Wenn Sie einen Namen im <switches>-Block hinzufügen, enthält die Ausgabe der Ablaufverfolgung Informationen von einigen zu diesem Namen gehörenden Methoden.When you add a name to the <switches> block, the trace output includes information from some methods related to the name. Die Ausgabe wird in der folgenden Tabelle beschrieben:The following table describes the output:

nameName Ausgabe vonOutput from
System.Net.Sockets Einige öffentliche Methoden der Klassen Socket, TcpListener, TcpClient und Dns.Some public methods of the Socket, TcpListener, TcpClient, and Dns classes.
System.Net Einige öffentliche Methoden der Klassen HttpWebRequest, HttpWebResponse, FtpWebRequest und FtpWebResponse sowie SSL-Debuginformationen (ungültige Zertifikate, fehlende Ausstellerliste und Clientzertifikatsfehler).Some public methods of the HttpWebRequest, HttpWebResponse, FtpWebRequest, and FtpWebResponse classes, and SSL debug information (invalid certificates, missing issuers list, and client certificate errors).
System.Net.HttpListener Einige öffentliche Methoden der Klassen HttpListener, HttpListenerRequest und HttpListenerResponse.Some public methods of the HttpListener, HttpListenerRequest, and HttpListenerResponse classes.
System.Net.Cache Einige private und interne Methoden in System.Net.Cache.Some private and internal methods in System.Net.Cache.
System.Net.Http Einige öffentliche Methoden der Klassen HttpClient, DelegatingHandler, HttpClientHandler, HttpMessageHandler, MessageProcessingHandler und WebRequestHandler.Some public methods of the HttpClient, DelegatingHandler, HttpClientHandler, HttpMessageHandler, MessageProcessingHandler, and WebRequestHandler classes.
System.Net.WebSockets.WebSocket Einige öffentliche Methoden der Klassen ClientWebSocket und WebSocket.Some public methods of the ClientWebSocket and WebSocket classes.

Attribute der AblaufverfolgungsausgabeTrace output attributes

Die in der folgenden Tabelle aufgeführten Attribute konfigurieren die Ablaufverfolgungsausgabe:The attributes listed in the following table configure trace output:

AttributnameAttribute name AttributwertAttribute value
value Erforderliches String-Attribut.Required String attribute. Legt den Ausführlichkeitsgrad der Ausgabe fest.Sets the verbosity of the output. Zulässige Werte sind Critical, Error, Verbose, Warning und Information.Legitimate values are Critical, Error, Verbose, Warning, and Information.

Dieses Attribut muss für das Element Hinzufügen des Elements switches festgelegt werden.This attribute must be set on the add element of the switches element. Eine Ausnahme wird ausgelöst, wenn das Attribut für das Element source festgelegt wird.An exception is thrown if this attribute is set on the source element.

Ein Beispiel: <add name="System.Net" value="Verbose"/>Example: <add name="System.Net" value="Verbose"/>
maxdatasize Optionales Int32-Attribut.Optional Int32 attribute. Legt die maximale Anzahl von Netzwerkdatenbytes für jede Ablaufverfolgungszeile fest.Sets the maximum number of bytes of network data included in each line trace. Der Standardwert ist 1024.The default value is 1024.

Dieses Attribut muss für das Element Quelle wie im Beispiel festgelegt werden.This attribute must be set on the source element. Eine Ausnahme wird ausgelöst, wenn dieses Attribut für ein Element unter dem Element switches festgelegt wird.An exception is thrown if this attribute is set on an element under the switches element.

Ein Beispiel: <source name="System.Net" tracemode="includehex" maxdatasize="1024">Example: <source name="System.Net" tracemode="includehex" maxdatasize="1024">
tracemode Optionales String-Attribut.Optional String attribute. Mit dem Wert includehex werden Protokollablaufverfolgungen im Hexadezimalformat und im Textformat angezeigt.Set to includehex to show protocol traces in hexadecimal and text format. Mit dem Wert protocolonly wird nur Text angezeigt.Set to protocolonly to show only text. Der Standardwert ist includehexsein.The default value is includehex.

Dieses Attribut muss für das Element Quelle wie im Beispiel festgelegt werden.This attribute must be set on the source element. Eine Ausnahme wird ausgelöst, wenn dieses Attribut für ein Element unter dem Element switches festgelegt wird.An exception is thrown if this attribute is set on an element under the switches element.

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

Siehe auchSee also