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 zur Aktivierung der Netzwerkablaufverfolgung finden Sie unter Enabling Network Tracing (Aktivieren der Netzwerkablaufverfolgung).For information about enabling tracing, see Enabling Network Tracing.

Die Computerkonfigurationsdatei "machine.config" ist im Ordner "%Windir%\Microsoft.NET\Framework" in dem Verzeichnis gespeichert, in dem Windows installiert wurde.The computer configuration file, machine.config, is stored in the %Windir%\Microsoft.NET\Framework folder in the directory where Windows was installed. 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\machine.config oder C:\Windows\Microsoft.NET\Framework64\v4.0.30319\Config\machine.config).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\machine.config or 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.These settings can also be made in the configuration file for the application, which has precedence over the computer configuration file.

So konfigurieren Sie die NetzwerkablaufverfolgungTo configure network tracing

  • Fügen Sie der jeweiligen Konfigurationsdatei die folgenden Zeilen hinzu.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>  
    

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

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 <add name> des <switches>-Elements wie im Beispiel festgelegt werden.This attribute must be set on the <add name> element of the <switches> element as shown in the example. Eine Ausnahme wird ausgelöst, wenn das Attribut für das <source>-Element festgelegt wird.An exception is thrown if this attribute is set on the <source> element.
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 <source> wie im Beispiel festgelegt werden.This attribute must be set on the <source> element as shown in the example. Eine Ausnahme wird ausgelöst, wenn dieses Attribut für ein Element unter dem <switches>-Element festgelegt wird.An exception is thrown if this attribute is set on an element under the <switches> element.
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 <switches> wie im Beispiel festgelegt werden.This attribute must be set on the <switches> element as shown in the example. Eine Ausnahme wird ausgelöst, wenn dieses Attribut für ein Element unter dem <source>-Element festgelegt wird.An exception is thrown if this attribute is set on an element under the <source> element.

Siehe auchSee also