Partilhar via

Como: Configurar o rastreamento de rede

O ficheiro de configuração da aplicação ou do computador que contém as definições determina o formato e o conteúdo dos registos de rede. Antes de realizar este procedimento, certifique-se de que o rastreio está ativado. Para mais informações, consulte Ativar rastreio de rede.

O ficheiro de configuração do computador, machine.config, é armazenado na pasta%windir%\Microsoft.NET\Framework . Existe um ficheiro machine.config separado nas pastas sob %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

Estas definições também podem ser feitas no ficheiro de configuração da aplicação, que tem precedência sobre o ficheiro de configuração do computador.

Configurar o rastreio de rede

Para configurar o rastreio de rede, adicione as linhas seguintes ao ficheiro de configuração apropriado. Os valores e opções para estas definiçõ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>

Resultado de rastreamento dos métodos

Quando adiciona um nome ao <switches> bloco, a saída do traço inclui informações de alguns métodos relacionados com o nome. A tabela seguinte descreve a saída:

Nome Saída de
System.Net.Sockets Alguns métodos públicos das Socketclasses, TcpListener, , TcpCliente 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 em falta e erros de certificados do cliente).
System.Net.HttpListener Alguns métodos públicos das HttpListenerclasses, HttpListenerRequest, e HttpListenerResponse .
System.Net.Cache Alguns métodos privados e internos em System.Net.Cache.
System.Net.Http Alguns métodos públicos das HttpClientclasses , DelegatingHandler, HttpClientHandler, HttpMessageHandler, MessageProcessingHandler, , e WebRequestHandler .
System.Net.WebSockets.WebSocket Alguns métodos públicos das ClientWebSocket e WebSocket classes.

Atributos de saída de rastreio

Os atributos listados na tabela seguinte configuram a saída de rastreamento.

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

Este atributo deve ser definido no add elemento do switches elemento. É lançada uma exceção se este atributo estiver 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 traço de linha. O valor padrão é 1024.

Este atributo deve ser definido no source elemento. É lançada uma exceção se este atributo estiver definido num elemento sob o switches elemento.

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

Este atributo deve ser definido no source elemento. É lançada uma exceção se este atributo estiver definido num elemento sob o switches elemento.

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

Consulte também

  • Last updated on