Freigeben über


Vorgehensweise: Konfigurieren der Netzwerkablaufverfolgung

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

Die Computerkonfigurationsdatei machine.configwird im Ordner%windir%\Microsoft.NET\Framework gespeichert. Es gibt eine separate machine.config Datei in den Ordnern unter %windir%\Microsoft.NET\Framework für jede Version von .NET Framework, die auf dem Computer installiert ist, 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 Vorrang vor der Computerkonfigurationsdatei hat.

Konfigurieren der Netzwerkablaufverfolgung

Um die Netzwerkablaufverfolgung zu konfigurieren, fügen Sie der entsprechenden Konfigurationsdatei die folgenden Zeilen hinzu. Die Werte und Optionen für diese Einstellungen werden 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 dem <switches> Block einen Namen hinzufügen, enthält die Ablaufverfolgungsausgabe Informationen aus einigen Methoden im Zusammenhang mit dem Namen. In der folgenden Tabelle wird die Ausgabe beschrieben:

Name Ausgabe von
System.Net.Sockets Einige öffentliche Methoden von den Socket, TcpListener, TcpClient und Dns Klassen.
System.Net Einige öffentliche Methoden der HttpWebRequest, HttpWebResponse, FtpWebRequest, und FtpWebResponse Klassen und SSL-Debuginformationen (ungültige Zertifikate, fehlende Ausstellerliste und Clientzertifikatfehler).
System.Net.HttpListener Einige der öffentlichen 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 HttpClient, DelegatingHandler, HttpClientHandler, HttpMessageHandler, MessageProcessingHandler und WebRequestHandler Klassen.
System.Net.WebSockets.WebSocket Einige öffentliche Methoden der ClientWebSocket- und WebSocket-Klassen.

Ausgabemerkmale der Ablaufverfolgung

Die Attribute, die in der folgenden Tabelle aufgeführt sind, konfigurieren die Ausgabe der Ablaufverfolgung:

Attributname Attributwert
value Erforderliches String Attribut. Legt die Ausführlichkeit der Ausgabe fest. Legitime Werte sind Critical, Error, Verbose, , Warningund Information.

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

Beispiel: <add name="System.Net" value="Verbose"/>
maxdatasize Optionales Int32 Attribut. Legt die maximale Byte-Anzahl von Netzwerkdaten fest, die in jedem Linien-Trace enthalten sind. Der Standardwert ist 1024.

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

Beispiel: <source name="System.Net" tracemode="includehex" maxdatasize="1024">
tracemode Optionales String Attribut. Stellen Sie includehex ein, um Protokollablaufverfolgungen im Hexadezimal- und Textformat anzuzeigen. Auf protocolonly einstellen, um nur Text anzuzeigen. Der Standardwert ist includehex.

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

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

Siehe auch