Como configurar o rastreamento de rede

  • Artigo

O aplicativo ou o arquivo de configuração do computador mantém as configurações que determinam o formato e o conteúdo dos rastreamentos de rede. Antes de executar este procedimento, certifique-se de que o rastreamento está habilitado. Para obter mais informações, consulte Habilitar rastreamento de rede.

O arquivo de configuração de computador, machine.config, é armazenado na pasta %windir%\Microsoft.NET\Framework. Há um outro arquivo machine.config nas pastas em %windir%\Microsoft.NET\Framework para cada versão do .NET Framework instalada no computador, por exemplo:

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

Essas configurações também podem ser feitas no arquivo de configuração do aplicativo, que tem precedência sobre o arquivo de configuração do computador.

Configurar o rastreamento de rede

Para configurar o rastreamento de rede, adicione as linhas a seguir ao arquivo de configuração apropriado. Os valores e as opções dessas configurações são descritos nas tabelas abaixo.

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

Saída de rastreamento de métodos

Quando você adiciona um nome para o bloco <switches>, a saída de rastreamento inclui informações de alguns métodos relacionados ao nome. A tabela a seguir descreve a saída:

Nome Saída de
System.Net.Sockets Alguns métodos públicos das classes Socket, TcpListener, TcpClient e Dns.
System.Net Alguns métodos públicos das classes HttpWebRequest, HttpWebResponse, FtpWebRequest e FtpWebResponse, e informações de depuração SSL (certificados inválidos, lista de emissores ausentes e erros de certificado do cliente).
System.Net.HttpListener Alguns métodos públicos das classes HttpListener, HttpListenerRequest e HttpListenerResponse.
System.Net.Cache Alguns métodos particulares e internos em System.Net.Cache.
System.Net.Http Alguns métodos públicos das classes HttpClient, DelegatingHandler, HttpClientHandler, HttpMessageHandler, MessageProcessingHandler e WebRequestHandler.
System.Net.WebSockets.WebSocket Alguns métodos públicos das classes ClientWebSocket e WebSocket.

Atributos de saída de rastreamento

Os atributos listados na tabela a seguir configuram a saída de rastreamento:

Nome do atributo Valor do atributo
value Atributo String obrigatório. Define o detalhamento da saída. Valores legítimos são Critical, Error, Verbose, Warning e Information.

Este atributo deve ser definido no elemento add do elemento switches. Uma exceção será gerada se esse atributo for definido no elemento source.

Exemplo: <add name="System.Net" value="Verbose"/>
maxdatasize Atributo Int32 opcional. Define o número máximo de bytes de dados de rede inclusos em cada linha de rastreamento. O valor padrão é 1.024.

Esse atributo deve ser definido no elemento source. Uma exceção será gerada se esse atributo for definido em um elemento no elemento switches.

Exemplo: <source name="System.Net" tracemode="includehex" maxdatasize="1024">
tracemode Atributo String opcional. Definido como includehex para exibir rastreamentos de protocolo em formato hexadecimal e textual. Definido como protocolonly para exibir somente o texto. O valor padrão é includehex.

Esse atributo deve ser definido no elemento source. Uma exceção será gerada se esse atributo for definido em um elemento no elemento switches.

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

Consulte também