Compartilhar via

Como configurar o rastreamento de rede

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

O arquivo de configuração do computador, machine.config, é armazenado na pasta %windir%\Microsoft.NET\Framework . Há um arquivo machine.config separado 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 seguintes linhas ao arquivo de configuração apropriado. Os valores e as opções para essas 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 ao bloco <switches>, a saída do rastreamento inclui informações de determinados 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 do HttpListener, HttpListenerRequeste HttpListenerResponse classes.
System.Net.Cache Alguns métodos de acesso privado e interno 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 necessário String . Define a verbosidade da saída. Os valores legítimos sãoCritical, , Error, Verbosee WarningInformation.

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

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

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

Exemplo: <source name="System.Net" tracemode="includehex" maxdatasize="1024">
tracemode Atributo opcional String . Configure para includehex mostrar rastreamentos de protocolo no formato hexadecimal e formato de texto. Definido para protocolonly mostrar apenas texto. O valor padrão é includehex.

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

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

Consulte também

  • Last updated on