レジストリの構成

SymProxy は、このレジストリ キーに設定を格納します。

HKLM/Software/Microsoft/Symbol Server Proxy

このレジストリ キーは、Web サイトに保存するシンボルを検索する場所、ログ レベル、SymProxy がネットワークへの直接接続で動作するかどうかを制御します。 このキーを作成するには、Windows デバッグ ツールに付属の SymProxy 登録ツール (Symproxy.reg) を実行します。 コマンド プロンプトで symproxy.reg と入力するか、Windows エクスプローラーからダブルクリックします。

これにより設定のエントリが追加され、無効化されていることを表す "x" というプレフィックスが付きます。 設定を有効にするには、目的の設定の前に付いている "x" を削除します。

[HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Symbol Server Proxy]
"Available Settings"="Remove the 'x' prefix to use the setting"
"xMissAgeTimeout"=dword:00015180
"xMissAgeCheck"=dword:00000e10
"xMissTimeout"=dword:00000e10
"xNoCache"=dword:00000001
"xNoFilePointers"=dword:00000001
"xNoInternetProxy"=dword:00000001
"xNoLongerIndexedAuthoritive"=dword:00000001
"xNoUncompress"=dword:00000001
"xRequestTimeout"=dword:0000019
"xRetryAppHang"=dword:0000002
"xUriFilter"=dword:00000FF
"xUriTiers"=dword:0000001

symproxy.reg レジストリ ファイルは、仮想ディレクトリ名が Symbols であると想定して、Microsoft パブリック シンボル サーバーを使用するようにシンボル パスを構成します。

[HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Symbol Server Proxy\Web Directories]

[HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Symbol Server Proxy\Web Directories\Symbols]
"SymbolPath"="https://msdl.microsoft.com/download/symbols"

symproxy.reg のイベント ログのエントリについては、このトピックの「イベント ログ」セクションで説明します。

[HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\EventLog\Application\Microsoft-Windows-SymProxy]
"ProviderGuid"="{0876099c-a903-47ff-af14-52035bb479ef}"
"EventMessageFile"=hex(2):25,00,53,00,79,00,73,00,74,00,65,00,6d,00,52,00,6f,\
  00,6f,00,74,00,25,00,5c,00,73,00,79,00,73,00,74,00,65,00,6d,00,33,00,32,00,\
  5c,00,69,00,6e,00,65,00,74,00,73,00,72,00,76,00,5c,00,53,00,79,00,6d,00,50,\
  00,72,00,6f,00,78,00,79,00,2e,00,64,00,6c,00,6c,00,00,00
"TypesSupported"=dword:00000007

このトピックでは、symproxy.reg の Web ディレクトリのエントリについて説明します。

Web Directories

シンボル ストアとして使用している、IIS に生成された仮想ディレクトリごとに、以下のレジストリ キーの Web Directories サブキーの下に、レジストリ キーを設定する必要があります。

HKLM/Software/Microsoft/Symbol Server Proxy

シンボル ストア仮想ディレクトリのレジストリ キーを編集するには

• SymProxy シンボル ストアによって使用されるすべてのシンボル ストアを含めるように、SymbolPath の内容を編集します。 複数のシンボル ストアが使用されている場合は、セミコロンで区切ります。 値ごとに最大 10 個のストアがサポートされます。 HTTP パスには https:// プレフィックス を含める必要があり、UNC パスには \\ プレフィックスを含める必要があります。

たとえば、仮想ディレクトリの 1 つが Symbols という名前で、それがアクセスするシンボル ストアが UNC ストア \\symbols\symbols と HTTP ストア https://msdl.microsoft.com/download/symbols にある場合は、次のレジストリ キーを作成します。

HKLM/Software/Microsoft/Symbol Server Proxy/Web Directories/Symbols

このキーが作成されたら、その SymbolPath を編集して \\symbols\symbols;https://msdl.microsoft.com/download/symbols と指定します。 これは、以下に示すレジストリ エディターのスクリーンショットで確認できます。

この例では、SymProxy は最初に \\symbols\symbols でシンボルを検索します。 この場所でファイルが見つからない場合は、Microsoft シンボル ストアが使用されます。

• Web Directories の下にある、仮想ディレクトリ名と一致する各キーに、SymbolPath という名前の REG_SZ を作成する必要があります。 この値には、SymProxy シンボル ストアへの入力に使用されるすべてのアップストリーム シンボル ストアが含まれます。

• 最大 10 個のエントリがサポートされます。

• 各エントリは、セミコロンで区切ります。

• UNC パスには "\\" プレフィックスを含める必要があります

• HTTP パスには "https://" プレフィックスを含める必要があります

• 最も低コストなものから最も高コストなものの順に値を並べ替えます。

  • 計算では、使用状況のパフォーマンス目標と、サーバーとデータ通信のコストとのバランスを考慮する必要があります。

  • 一般に、インターネット HTTP サーバーより前にローカル SMB/HTTP サーバーを並べます。

SymProxy パフォーマンス カウンター

SymProxy は、SymProxy という名前のプロバイダーを介してパフォーマンス カウンターを生成できます。

パフォーマンス カウンターのサポートを有効にするには、管理者コマンド ウィンドウで symproxy マニフェスト ファイルを登録します。

C:\> lodctr.exe /m:%WINDIR%\system32\inetsrv\symproxy.man

パフォーマンス カウンターのサポートを無効にするには、マニフェストの登録を解除します。

C:\> unlodctr.exe /m:%WINDIR%\system32\inetsrv\symproxy.man

Windows 用の SymProxy イベント トレーシング

SymProxy は、Microsoft-Windows-SymProxy という名前のプロバイダーを介して ETW イベントを作成できます。

C:\> logman query providers | findstr SymProxy
Microsoft-Windows-SymProxy {0876099C-A903-47FF-AF14-52035BB479EF}

ETW のサポートを有効にするには、マニフェスト ファイルを登録します。

C:\> wevtutil.exe install-manifest %WINDIR%\system32\inetsrv\symproxy.man

ETW のサポートを無効にするには、マニフェスト ファイルの登録を解除します。

C:\> wevtutil.exe uninstall-manifest %WINDIR%\system32\inetsrv\symproxy.man

イベント ログ

ETW が構成されている場合、イベントは、イベント ログの Applications and Services Logs\Microsoft\Windows\SymProxy の下にある Operational and Analytic チャネルにイベントとして登録されます。

イベント ログのエントリのメッセージを正しく表示するには、symproxy.reg ファイルのイベント ログ領域をレジストリに追加する必要があります。

[HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\EventLog\Application\Microsoft-Windows-SymProxy]
"ProviderGuid"="{0876099c-a903-47ff-af14-52035bb479ef}"
"EventMessageFile"=hex(2):25,00,53,00,79,00,73,00,74,00,65,00,6d,00,52,00,6f,\
  00,6f,00,74,00,25,00,5c,00,73,00,79,00,73,00,74,00,65,00,6d,00,33,00,32,00,\
  5c,00,69,00,6e,00,65,00,74,00,73,00,72,00,76,00,5c,00,53,00,79,00,6d,00,50,\
  00,72,00,6f,00,78,00,79,00,2e,00,64,00,6c,00,6c,00,00,00
"TypesSupported"=dword:00000007

SymProxy イベント

SymProxy は、以下のイベントをログに記録します。

シンボル サーバー プロキシの構成

SymProxy は、構成設定を次のレジストリ キー領域に格納します。

HKLM/Software/Microsoft/Symbol Server Proxy

SymProxy はこの場所から、そのグローバル設定と、アップストリーム シンボル ストアのシンボル パスを取得します。

このキーを作成するには、前述のようにカスタマイズした symproxy.reg ファイルをマージします。

シンボル サーバー プロキシのキー

シンボル サーバー プロキシのレジストリ キーは、以下のグローバル設定 (すべて REG_DWORD) をサポートしています。 設定は、アプリケーション プールをリサイクルすることで、ライブで適用できます。 新しい w3wp.exe プロセスが作成され、新しい値が読み取られます。 古い w3wp.exe プロセスに対するすべての保留中の要求が完了すると、古い w3wp.exe プロセスが終了します。 IIS は既定で 1,740 分 (29 時間) ごとに w3wp.exeプロセスをリサイクルします。

外部ネットワーク リソースへのアクセス

SymSrv を SymProxy と組み合わせて使用すると、サービスとして実行され、WinHTTP API を使用して HTTP 接続経由でシンボルにアクセスします。 これは、この目的で WinInet を使用する通常の動作とは異なります。

そのため、このサービスが外部のネットワーク リソースにアクセスできるようにする HTTP プロキシ設定が必要になる場合があります。 これらの設定を構成するには、次のいずれかの方法を使用します。

• Netsh ツール (netsh.exe) を使用します。 手順については、コマンド プロンプト ウィンドウで次のように入力します。

  netsh winhttp -? 
  

SymProxy の既定の動作では、ProxyCfg または Netsh によって指定されている HTTP プロキシを使用します。 HTTP プロキシが構成されていない場合、SymProxy はダミー プロキシを使用して、イントラネット内の安全な HTTP サイトへのアクセスを許可します。 その影響で、この方法では、SymProxy が外部インターネットへの直接接続では機能しなくなります。 インターネットへの直接接続で SymProxy が動作することを許可する場合は、レジストリの Symbol Server Proxy キーに NoInternetProxy という名前の REG_DWORD 値を作成します。 NoInternetProxy の値を 1 に設定し、ProxyCfg によって示される HTTP プロキシがないことを確認します。