Instrukcje: konfigurowanie śledzenia sieci

  • Artykuł

Plik konfiguracyjny aplikacji lub komputera zawiera ustawienia, które określają format i zawartość danych ze śledzenia sieci. Przed rozpoczęciem procedury należy się upewnić, że śledzenie jest włączone. Aby uzyskać więcej informacji, zobacz Włączanie śledzenia sieci.

Plik konfiguracji komputera machine.config jest przechowywany w folderze %windir%\Microsoft.NET\Framework. Istnieje oddzielny plik machine.config w folderach w folderach w folderach %windir%\Microsoft.NET\Framework dla każdej wersji programu .NET Framework zainstalowanej na komputerze, na przykład:

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

Ustawienia te można również wprowadzić w pliku konfiguracyjnym aplikacji. Ma on priorytet nad plikiem konfiguracyjnym komputera.

Konfigurowanie śledzenia sieci

Aby skonfigurować śledzenie sieci, dodaj następujące wiersze do odpowiedniego pliku konfiguracji. Wartości i opcje ustawień opisano w tabelach poniżej.

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

Śledzenie danych wyjściowych z metod

Po dodaniu nazwy do <switches> bloku dane wyjściowe śledzenia zawierają informacje z niektórych metod związanych z nazwą. W poniższej tabeli opisano dane wyjściowe:

Nazwisko Skąd dane wyjściowe
System.Net.Sockets Niektóre publiczne metody Socketklas , TcpListener, TcpClienti Dns .
System.Net Niektóre publiczne metody HttpWebRequestklas , HttpWebResponseFtpWebRequest, i oraz FtpWebResponse informacje debugowania SSL (nieprawidłowe certyfikaty, brak listy wystawców i błędy certyfikatu klienta).
System.Net.HttpListener Niektóre publiczne metody HttpListenerklas , HttpListenerRequesti HttpListenerResponse .
System.Net.Cache Niektóre metody prywatne i wewnętrzne w systemie System.Net.Cache.
System.Net.Http Niektóre publiczne metody HttpClientklas , , DelegatingHandlerHttpClientHandler, HttpMessageHandler, MessageProcessingHandleri WebRequestHandler .
System.Net.WebSockets.WebSocket Niektóre publiczne metody ClientWebSocket klas i WebSocket .

Atrybuty danych wyjściowych śledzenia

Atrybuty wymienione w poniższej tabeli konfigurują dane wyjściowe śledzenia:

Attribute name Wartość atrybutu
value Wymagany String atrybut. Ustawia poziom szczegółowości danych wyjściowych. Prawidłowe wartości to Critical, , VerboseError, Warning, i Information.

Ten atrybut musi być ustawiony na element add elementu switchs . Wyjątek jest zgłaszany, jeśli ten atrybut jest ustawiony w elemecie źródłowym.

Przykład: <add name="System.Net" value="Verbose"/>
maxdatasize Atrybut opcjonalny Int32 . Ustawia maksymalną liczbę bajtów danych sieciowych w każdym zapisie ze śledzenia linii. Wartość domyślna to 1024.

Ten atrybut musi być ustawiony na elemecie źródłowym. Wyjątek jest zgłaszany, jeśli ten atrybut jest ustawiony na element pod elementem switchs .

Przykład: <source name="System.Net" tracemode="includehex" maxdatasize="1024">
tracemode Atrybut opcjonalny String . Ustaw wartość , aby includehex wyświetlić ślady protokołu w formacie szesnastkowym i tekstowym. Ustaw wartość na , aby protocolonly pokazywać tylko tekst. Domyślna wartość to includehex.

Ten atrybut musi być ustawiony na elemecie źródłowym. Wyjątek jest zgłaszany, jeśli ten atrybut jest ustawiony na element pod elementem switchs .

Przykład: <source name="System.Net" tracemode="includehex" maxdatasize="1024">

Zobacz też