パフォーマンス データ ファイルを使ったシンボル情報の保存Saving Symbol Information with Performance Data Files

Visual StudioVisual Studio 統合開発環境 (IDE: Integrated Development Environment) を使用してファイルを分析している場合、VSP ファイルを別のコンピューターに移動するには、シンボルをレポート ファイルに保存するかシリアル化するようにパフォーマンス プロジェクトの設定を行う必要があります。If you are using the Visual StudioVisual Studio integrated development environment (IDE) to analyze files and you plan to move your VSP file to a different computer, you must set the performance project settings to save or serialize symbols in your report file. この結果、レポート ファイルのサイズが大きくなります。This increases the size of a report file. シンボルのシリアル化は次の 2 つの理由で必要になります。Serializing symbols is necessary for two reasons:

  • ターゲット アセンブリが一時的なストレージから失われる前に、コード シンボルをパフォーマンス レポートに埋め込むため。To embed code symbols into a performance report before the target assemblies are lost from their location in temporary storage.

  • パフォーマンス レポートをプロファイルされたコンピューターから移植し、異なるシンボルを保持する別のコンピューターで分析するためにそのレポートを開いたときに同じ情報が出力されるようにシンボルを保存するため。To preserve symbols, so that the performance report is portable from the profiled computer and outputs the same information if the report is opened for analysis on another computer, which might have different symbols.

    RequirementsRequirements

  • Visual Studio UltimateVisual Studio UltimateVisual Studio PremiumVisual Studio PremiumVisual Studio ProfessionalVisual Studio Professional, Visual Studio PremiumVisual Studio Premium, Visual Studio ProfessionalVisual Studio Professional

    シンボルは、次の方法で Visual StudioVisual Studio IDE やコマンド ラインからシリアル化できます。You can serialize symbols from the Visual StudioVisual Studio IDE or from the command-line:

  • Visual StudioVisual Studio IDE でシンボルをシリアル化するには、メニュー バーの [ツール] をポイントし、[オプション] をクリックします。To serialize symbols in the Visual StudioVisual Studio IDE, point to Tools on the menu bar, and then click Options. [オプション] ウィンドウで、[パフォーマンス ツール] を選択し、[シンボル情報を自動的にシリアル化] チェック ボックスをオンにします。In the Options window, select Performance Tools, and then select the Automatically serialize symbol information check box.

  • PACKSYMBOLS は、これに相当するレポート ファイル保存時のコマンド ライン オプションです。PACKSYMBOLS is the equivalent command-line option when you save report files. シンボルをシリアル化するには、「vsperfreport /summary:all /packsymbols filename.vsp」と入力します。To serialize symbols, type vsperfreport /summary:all /packsymbols filename.vsp.

シンボルに関する問題のトラブルシューティングTroubleshooting Symbol Problems

独自のコードでシンボルを確認できない場合は、次のような一般的な解決方法がいくつかあります。If you do not see any symbols in your own code, some common solutions are available:

  • コマンド ラインで vsperfreport /debugsympath を実行して、プロファイラーのコンポーネントがシンボル情報を読み込む場所と、使用されているシンボル ファイルがプロジェクトで使用しているファイルと一致するかどうかに関する情報の一覧を表示します。Run vsperfreport /debugsympath at a command line to display a complete list of the locations where profiler components are loading symbol information and whether the symbol files that are used match the files that your project is using.

  • /PACKSYMBOLS フラグを指定して vsperfreport を実行していること、または Visual StudioVisual Studio IDE のパフォーマンス エクスプローラーの全般的なオプションでシンボル情報をシリアル化するオプションが選択されていることを確認します。Make sure that you run vsperfreport with the /PACKSYMBOLS flag or, in the Visual StudioVisual Studio IDE, that you have the serialize symbol information option selected in the general performance explorer options.

  • 型のデータを収集した場合、vsperfreport コマンド ラインに /SUMMARY:TYPE を追加します。If you collected type data, add /SUMMARY:TYPE to the vsperfreport command line.

    Windows やその他の Microsoft プログラムからシンボルを確認できない場合は、次のように解決します。If you do not see symbols from Windows or other Microsoft programs:

  • Windows シンボル キャッシュのパスを設定したことを確認します。Make sure that you have set the path of your Windows symbol cache. シンボル キャッシュのパスを設定するには、次のいずれかを実行します。Do one of the following to set the symbol cache path:

    • Visual StudioVisual Studio IDE の [デバッガ―] -> [シンボル] のオプションで正しいパスを設定します。Set the Debugger->Symbols option in the Visual StudioVisual Studio IDE to the correct path.

    • VSPerfReport コマンド ラインに -symbolpath オプションを追加して、シンボルを含めます。Add the -symbolpath option to the VSPerfReport command line to include your symbols.

  • ASP.NETASP.NET でシンボルを確認できない場合は、ASP サーバーにシンボル サーバーが正しくセットアップされていることを確認します。If you do not see any symbols in ASP.NETASP.NET, make sure that you have the symbol server set up correctly for the ASP server.

シンボルの再パックRepacking Symbols

シンボルをレポートに再度パックする場合は、VsPerfReport コマンド ライン ツールを使用してこの操作を実行できます。If you want to repack symbols into a report, you can do this by using the command line tool VsPerfReport. 次のコマンド ラインを使用します。Use the following command lines:

VsPerfReport -clearpackedsymbols filename.vspVsPerfReport -clearpackedsymbols filename.vsp

VsPerfReport -packsymbols -summary:all filename.vspVsPerfReport -packsymbols -summary:all filename.vsp

関連項目See Also

パフォーマンス ツール データの保存とエクスポート Saving and Exporting Performance Tools Data
方法: Windows シンボル情報を参照する How to: Reference Windows Symbol Information
VSPerfReportVSPerfReport