Partilhar via

Como: Configurar o rastreamento de rede

  • Artigo

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, certifique-se de que o rastreamento está ativado. 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 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 <switches> bloco, 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 do Socket, TcpListener, TcpClient, e Dns classes.
System.Net Alguns métodos públicos das classes , HttpWebResponse, FtpWebRequeste FtpWebResponse e informações de depuração SSL (certificados inválidos, lista de emissores ausentes e erros de HttpWebRequestcertificado de cliente).
System.Net.HttpListener Alguns métodos públicos do HttpListener, HttpListenerRequest, e HttpListenerResponse classes.
System.Net.Cache Alguns métodos privados e internos em System.Net.Cache.
System.Net.Http Alguns métodos públicos do HttpClient, DelegatingHandler, HttpClientHandler, HttpMessageHandlerMessageProcessingHandler, , e WebRequestHandler classes.
System.Net.WebSockets.WebSocket Alguns métodos públicos das ClientWebSocket e WebSocket classes.

Atributos de saída de rastreamento

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

Attribute name Valor do atributo
value Atributo obrigatório String . Define a detalhamento da saída. Os valores legítimos são Critical, Error, Verbose, Warning, e Information.

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

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 elemento source . Uma exceção será lançada se esse atributo for definido em um elemento sob o elemento switches .

Exemplo: <source name="System.Net" tracemode="includehex" maxdatasize="1024">
tracemode Atributo opcional String . Defina como includehex para mostrar rastreamentos de protocolo em formato hexadecimal e texto. Defina como protocolonly para mostrar apenas texto. O valor predefinido é includehex.

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

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

Consulte também