次の方法で共有

方法: ネットワーク トレースを構成する

アプリケーションまたはコンピューターの構成ファイルには、ネットワーク トレースの形式と内容を決定する設定が保持されます。 この手順を実行する前に、トレースが有効になっていることを確認してください。 詳細については、「 ネットワーク トレースを有効にする」を参照してください。

コンピューター構成ファイル machine.configは、 %windir%\Microsoft.NET\Framework フォルダーに格納されます。 %windir%\ Microsoft.NET \Framework の下のフォルダーには、コンピューターにインストールされている .NET Framework の各バージョンに対して個別のmachine.configファイルがあります。次に例を示します。

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

これらの設定は、コンピューター構成ファイルよりも優先されるアプリケーションの構成ファイルでも行うことができます。

ネットワーク トレースを構成する

ネットワーク トレースを構成するには、適切な構成ファイルに次の行を追加します。 これらの設定の値とオプションについては、次の表で説明します。

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

メソッドからの出力をトレースする

<switches> ブロックに名前を追加すると、その名前に関連するいくつかのメソッドからの情報がトレース出力に含まれます。 次の表では、出力について説明します。

名前 出力
System.Net.Sockets Socket、TcpListener、TcpClient、およびDns クラスのパブリック メソッド。
System.Net HttpWebRequest、HttpWebResponse、FtpWebRequest、FtpWebResponse クラス、および SSL デバッグ情報のパブリック メソッド (無効な証明書、発行者一覧の不足、クライアント証明書エラー)。
System.Net.HttpListener HttpListener、HttpListenerRequest、およびHttpListenerResponse クラスのパブリック メソッド。
System.Net.Cache System.Net.Cacheのプライベート メソッドと内部メソッドの一部。
System.Net.Http HttpClient、DelegatingHandler、HttpClientHandler、HttpMessageHandler、MessageProcessingHandler、およびWebRequestHandler クラスのパブリック メソッド。
System.Net.WebSockets.WebSocket ClientWebSocketクラスとWebSocket クラスのパブリック メソッドの一部。

トレース出力属性

次の表に示す属性は、トレース出力を構成します。

属性名 属性値
value 必須 String 属性です。 出力の詳細度を設定します。 正当な値は、 Critical、 Error、 Verbose、 Warning、および Informationです。

この属性は、add要素のswitches要素に設定する必要があります。 この属性が source 要素に設定されている場合、例外がスローされます。

例: <add name="System.Net" value="Verbose"/>
maxdatasize 省略可能な Int32 属性。 各行トレースに含まれるネットワーク データの最大バイト数を設定します。 既定値は 1024 です。

この属性は、 source 要素に設定する必要があります。 この属性が switches 要素の下の要素に設定されている場合、例外がスローされます。

例: <source name="System.Net" tracemode="includehex" maxdatasize="1024">
tracemode 省略可能な String 属性。 プロトコル トレースを 16 進数とテキスト形式で表示するには、 includehex に設定します。 テキストのみを表示するには、 protocolonly に設定します。 既定値は includehex です。

この属性は、 source 要素に設定する必要があります。 この属性が switches 要素の下の要素に設定されている場合、例外がスローされます。

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

こちらも参照ください

  • Last updated on