パフォーマンス トレースを保存して共有する

Connor Clark
Connor Clark
X GitHub

パフォーマンス トレースは [パフォーマンス] パネルから保存して、後で再読み込みできます。これは、パフォーマンスの問題をデバッグするときに、他のデベロッパーや将来の自分と共有するのに役立ちます。

トレースは、ページで見つかったすべてのスクリプト コンテンツとソースマップのコピーとともに保存することもできます。これにより、後でトレースをインポートする際のデバッグ エクスペリエンスが向上します。

スクリプト コンテンツまたはソースマップを含むトレースが [パフォーマンス] パネルに読み込まれると、新しいタブが開きます。この DevTools タブには、[パフォーマンス] パネルと [ソース] パネルが含まれています。

パフォーマンス トレースを保存するための設定

録画を保存して、後でパフォーマンスに関する注釈付きの調査結果と共有するには、[パフォーマンス] パネルの上部にあるアクションバーで、[] ダウンロード アイコンをクリックして、[トレースを保存] を選択します。次のオプションが表示されます。

  • アノテーションを含める
  • リソース コンテンツを含める
  • スクリプトのソースマップを含める
  • gzip で圧縮する

パフォーマンス トレース設定を保存するためのダイアログ。オプションは、[アノテーションを含める]、[リソース コンテンツを含める]、[スクリプトのソースマップを含める]、[gzip で圧縮する] です。

設定 説明 デフォルト 有効にする理由 無効にする理由
アノテーションを含める 注: このオプションは、ページにアノテーションがある場合にのみ含まれます。

保存されたトレース ファイルにアノテーションを含めるかどうかを制御します。		 オン アノテーションは、トレースの説明、トレースの特定の重要な部分のハイライト表示、さらなる調査が必要な部分に関する質問を行う場合に役立ちます。 アノテーションには独自の処理が含まれており、他のデベロッパーにはあまり関連性がない可能性があります。アノテーションなしで保存するのではなく、アノテーションをクリーンアップして、関連するアノテーションを含めます。
リソース コンテンツを含める トレースの読み込み時に、HTML、JavaScript ファイル、CSS のコンテンツを保存されたトレース ファイルに含めて [ソース] パネルで表示するかどうかを制御します。

注: 拡張機能はパフォーマンスのデバッグに役立つことはほとんどなく、機密情報（非公開の会社の拡張機能など）が含まれていることが多いため、このオプションが有効になっている場合でも、拡張機能スクリプトの内容は含まれません。ただし、拡張機能スクリプトのプロファイリング データは、パフォーマンスに影響する可能性があるため、トレースに保存されます。		 オフ [ソース] パネルでは、ページで実行されたリソース（行ベースの実行時費用など）を確認できます。

[パフォーマンス] パネルでは、[ソース] パネルの特定の行（フレーム チャートの関数呼び出しや [ボトムアップ/呼び出しツリー] テーブルなど）にリンクできます。

一部のパフォーマンス分析情報では、分析にスクリプトの内容が必要です。

注: リソースの内容が機密情報である場合は、トレース ファイルも機密情報として扱う必要があります。		 パフォーマンス パネルの操作性（ソース パネルで実行されたスクリプトを確認するなど）よりもトレース ファイルのサイズを小さくしたい場合は、無効にします。

リソースのコンテンツに機密情報が含まれており、トレース ファイルで共有したくない場合は、無効にします。ソースファイルはページにアクセスできるすべてのユーザーが閲覧できるため、このようなケースは非常にまれですが、サーバーが現在のユーザーに基づいてページで実行される JavaScript にシークレットを挿入する場合は、これらのスクリプト コンテンツを含むトレースファイルを機密ファイルとして扱います。また、公開されていない内部イントラネット アプリケーションの場合、ソースファイルを共有したくないことがあります。
スクリプトのソースマップを含める 注: このオプションは、[リソース コンテンツを含める] が有効になっている場合にのみ使用できます。

コンパイルまたは最小化された本番環境コンテンツ ファイルとともに、作成されたソースコード ファイルへのマッピングが含まれます。		 オフ [パフォーマンス] パネルでは、ソースマップを使用して作成された関数名が表示されます。

[ソース] パネルでは、[ページ] ファイル リストに作成されたすべてのファイルが表示されます。

一部のパフォーマンス分析情報では、分析にソースマップが必要です。

この設定を有効にして、ソースマップを機密情報と見なす場合は、トレース ファイルも機密情報として扱う必要があります。		 パフォーマンス パネルの操作性（パフォーマンス フレーム チャートで関数の実名を確認するなど）よりもトレース ファイルのサイズを小さくしたい場合は、無効にします。

ソースマップが機密情報である（たとえば、ソースマップを公開インターネットではなく内部ネットワークにのみ提供している）と考える場合、トレース ファイルを持っている人にソースマップが公開されないようにするには、無効にします。
gzip で圧縮する 注: Chrome 142 以降ではこれがデフォルトです。 オン パフォーマンス トレースは非常に大きくなる可能性があるため、圧縮するとディスク容量を節約できるだけでなく、DevTools でのアップロードと処理も高速化されます。 これらのファイルをテキスト エディタなどで開いて特定のトレース イベントを表示する場合は、gzip 圧縮せずに保存すると、ファイルを開くのが簡単になります。