SharePoint 用ページ診断ツールを使用する

[アーティクル]
01/08/2024

この記事では、 SharePoint 用ページ診断ツール を使用して、定義済みのパフォーマンス基準のセットに対して SharePoint Online のモダンサイトページとクラシックサイトページを分析する方法について説明します。

SharePoint のページ診断ツールは、次の目的でインストールできます。

ヒント

バージョン 2.0.0 以降には、クラシックサイトページに加えてモダンページのサポートが含まれています。使用しているツールのバージョンがわからない場合は、[ バージョン情報 ] リンクまたは省略記号 (...) を選択してバージョンを確認できます。ツールを使用する場合は、常に最新バージョンに更新します。

SharePoint 用ページ診断ツールは、SharePoint Online モダンポータルと従来の発行サイトページの両方を分析する新しい Microsoft Edge (https://www.microsoft.com/edge) ブラウザーと Chrome ブラウザーのブラウザー拡張機能です。

重要

このツールは SharePoint Online でのみ機能し、SharePoint システムページまたは SharePoint アプリページでは使用できません。 [アプリ] ページの種類は、ポータルではなく、SharePoint Online 内の特定のビジネスアプリケーションに使用するように設計されています。このツールは、ポータルページと Teams サイトページを最適化するように設計されています。

このツールは、定義済みのルールセットに対してページがどのように実行されるかを示す分析されたページごとにレポートを生成し、テストの結果が基準値の範囲外にある場合に詳細情報を表示します。 SharePoint Online の管理者とデザイナーは、このツールを使用してパフォーマンスの問題のトラブルシューティングを行い、発行前に新しいページが最適化されるようにすることができます。

ページ診断ツールは、 allitems.aspx や sharepoint.aspxなどのシステムページではなく、SharePoint サイトページのみを分析するように設計されています。システムページまたはその他の非サイトページでツールを実行しようとすると、その種類のページに対してツールを実行できないことを示すエラーメッセージが表示されます。

SharePoint ページで実行する必要があります。

ライブラリやシステムページの評価に価値がないため、これはツールのエラーではありません。 SharePoint サイトページに移動して、ツールを使用します。 SharePoint ページでこのエラーが発生した場合は、マスターページをチェックして、SharePoint メタタグが削除されていないことを確認します。

ツールに関するフィードバックを提供するには、ツールの右上隅にある省略記号を選択し、[ フィードバックの送信] を選択します。

フィードバックを送信します。

SharePoint 用ページ診断ツールをインストールする

このセクションのインストール手順は、Chrome ブラウザーと Microsoft Edge ブラウザーの両方で機能します。

重要

Microsoft は、SharePoint 用ページ診断ツールによって分析されたデータやページコンテンツを読み取らず、個人情報、Web サイト、ダウンロード情報をキャプチャすることはありません。ツールによって Microsoft に記録される識別可能な情報は、テナント名、失敗したルールの数、ツールが実行された日時だけです。この情報は、最新のポータルと発行サイトの使用状況の傾向と一般的なパフォーマンスの問題をよりよく理解するために Microsoft によって使用されます。

Microsoft Edge(Edge 拡張機能) または Chrome(Chrome 拡張機能) 用の SharePoint 用ページ診断ツールをインストールします。ストアの説明ページで提供されているユーザープライバシーポリシーを確認します。ブラウザーにツールを追加すると、次のアクセス許可に関する通知が表示されます。

この通知は、ページ上の Web パーツとカスタマイズに応じて、ページに SharePoint 以外の場所からのコンテンツが含まれている可能性があるためです。つまり、スタートボタンがクリックされたときに、ツールが実行されているアクティブな SharePoint タブについてのみ、要求と応答が読み取られます。この情報は Web ブラウザーによってローカルにキャプチャされ、ツールの [ネットワークトレース] タブの [JSON にエクスポート] または [HAR にエクスポート] ボタンを使用して使用できます。この情報は Microsoft に送信されたり、キャプチャされたりすることはありません。(ツールは、ここでアクセスできる Microsoft のプライバシーポリシーに従います)。

[ ダウンロードの管理] アクセス許可では、ツールの JSON へのエクスポート 機能の使用について説明します。結果に URL が含まれており、PII (個人を特定できる情報) として分類できるため、organizationの外部で JSON ファイルを共有する前に、会社独自のプライバシーガイドラインに従ってください。
Incognito モードまたは InPrivate モードでツールを使用する場合は、ブラウザーの手順に従います。
1. Microsoft Edge で、[ 拡張機能 ] に移動するか、URL バーに 「edge://extensions 」と入力し、拡張機能の [詳細 ] を選択します。拡張機能の設定 で、[InPrivate] で [許可] のチェックボックスをオンにします。
2. Chrome で、[ 拡張機能 ] に移動するか、URL バーに 「chrome://extensions 」と入力し、拡張機能の [詳細 ] を選択します。拡張機能の設定 で、[シークレット] で許可するスライダーを選択します。
確認する SharePoint Online の SharePoint サイトページに移動します。ページ上のアイテムの "遅延読み込み" を許可しました。そのため、ツールは自動的に停止しません (これは、すべてのページ読み込みシナリオに対応するために設計されています)。コレクションを停止するには、[ 停止] を選択します。データ収集を停止する前にページの読み込みが完了したことを確認するか、部分的なトレースのみをキャプチャします。
拡張機能のツールバーボタン [ をクリックします。ツールを読み込むには、次の拡張機能ポップアップウィンドウが表示されます。

[ 開始] を選択して、分析のためにデータの収集を開始します。

SharePoint のページ診断ツールに表示される内容

ツールの右上隅にある省略記号 (...) をクリックすると、次のリンクが表示されます。
1. [その他のリソース] リンクには、この記事へのリンクなど、ツールに関する一般的なガイダンスと詳細が記載されています。
2. [ フィードバックの提供] リンクは、 SharePoint サイトとコラボレーションユーザー音声 サイトへのリンクを提供します。
3. [バージョン情報] リンクには、現在インストールされているバージョンのツールと、ツールのサードパーティの通知への直接リンクが含まれています。
関連付け ID、SPRequestDuration、SPIISLatency、ページの読み込み時間、URL の詳細は情報であり、いくつかの目的で使用できます。
- CorrelationID は、特定のページのより多くの診断データを収集できるため、Microsoft サポートを操作する際に重要な要素です。
- SPRequestDuration は、SharePoint がページを処理するのにかかった時間です。構造ナビゲーション、大きな画像、多数の API 呼び出しはすべて、より長い期間に貢献する可能性があります。
- SPIISLatency は、SharePoint Online がページの読み込みを開始するまでのミリ秒単位の時間です。この値には、Web アプリケーションが応答するのにかかった時間は含まれません。
- ページ読み込み時間 は、要求の時刻からブラウザーで応答が受信およびレンダリングされた時点までのページによって記録された合計時間です。この値は、ネットワーク待機時間、コンピューターのパフォーマンス、ブラウザーがページを読み込むのにかかる時間など、さまざまな要因の影響を受けます。
- ページ URL (Uniform Resource Locator) は、現在のページの Web アドレスです。

[ 診断テスト ] タブには、分析結果が 3 つのカテゴリで表示されます。 アクションは必要ありません。 改善の機会 と 注意は必要です。各テスト結果は、次の表に示すように、これらのカテゴリのいずれかに含まれる項目によって表されます。

カテゴリ	色	説明
注意が必要	赤	テスト結果が基準値の範囲外であり、ページのパフォーマンスに影響を与えています。修復ガイダンスに従います。
改善の機会	黄	テスト結果が基準値の範囲外になり、パフォーマンスの問題に影響する可能性があります。テスト固有の条件が適用される場合があります。
操作は不要	緑	テスト結果は、テストのベースライン値に含まれます。

ページ診断。

[ ネットワークトレース ] タブには、ページビルド要求と応答に関する詳細が表示されます。

[診断テスト] タブの使用方法

SharePoint 用ページ診断ツールを使用して SharePoint モダンポータルページまたはクラシック発行サイトページを分析すると、結果がベースライン値と比較され、[ 診断テスト ] タブに表示される定義済みのルールを使用して結果が分析されます。特定のテストのルールでは、最新のポータルサイトとクラシック発行サイトのベースライン値は、2 つの間の特定のパフォーマンス特性の違いによって異なる場合があります。

[改善の機会] または [注意が必要] のカテゴリに表示されるテスト結果は、推奨されるプラクティスに対して確認する必要があり、結果に関する追加情報を表示するために選択できる領域を示します。各項目の詳細には[ 詳細情報] リンクが含まれており、テストに関連する適切なガイダンスに直接アクセスできます。 [必要なアクションなし] カテゴリに表示されるテスト結果は、関連するルールへの準拠を示し、選択した場合に追加の詳細は表示されません。

[診断テスト] タブの情報では、ページのデザイン方法は示されませんが、ページのパフォーマンスに影響を与える可能性のある要因が強調されます。一部のページ機能とカスタマイズは、ページのパフォーマンスに不可避的な影響を与えます。影響が大きい場合は、ページからの潜在的な修復または省略がないか確認する必要があります。

赤または黄色の結果は、データの更新頻度が高すぎる Web パーツを示している場合もあります。たとえば、企業のニュースは 1 秒ごとに更新されるわけではありませんが、ユーザーエクスペリエンス全体を向上させるキャッシュ要素を実装するのではなく、1 秒ごとに最新のニュースを取得するようにカスタム Web パーツが構築されることがよくあります。 Web パーツをページに含める場合は、使用できる各パラメーターの値を評価して、目的に合わせて適切に設定されていることを確認することで、パフォーマンスへの影響を軽減する簡単な方法が多い点に注意してください。

注:

発行機能が有効になっていないクラシックチームサイトでは、CDN を使用できません。これらのサイトでツールを実行すると、CDN テストは失敗することが予想され、無視できますが、残りのテストはすべて適用されます。 SharePoint 発行機能の追加機能により、ページの読み込み時間が長くなる可能性があるため、CDN 機能を許可するためだけに有効にしないでください。

重要

テストルールは定期的に追加および更新されるため、現在のルールとテスト結果に含まれる特定の情報の詳細については、ツールの最新バージョンを参照してください。拡張機能を管理することでバージョンを確認でき、更新プログラムが利用可能かどうかを拡張機能がアドバイスします。

[ネットワークトレース] タブの使用方法と HAR ファイルをエクスポートする方法

[ ネットワークトレース ] タブには、ページをビルドするための要求と SharePoint から受信した応答の両方に関する詳細情報が表示されます。

赤のフラグが付けられた項目の読み込み時間を探します。各要求と応答は、次の待機時間メトリックを使用して、ページ全体のパフォーマンスへの影響を示すように色分けされています。
- 緑: < 500 ミリ秒
- 黄色: 500-1000 ミリ秒
- 赤: > 1000 ミリ秒
上の図では、赤い項目は既定のページに関連しています。ページが 1000 ミリ秒 (1 秒未満) で < 読み込まれる場合を除き、常に赤で表示されます。
テスト項目の読み込み時間。場合によっては、項目がブラウザーによって既にキャッシュされているため、時間や色のインジケーターはありません。これを正しくテストするには、ページを開き、ブラウザーキャッシュをクリアし、[ スタート ] をクリックすると、"コールド" ページの読み込みが強制され、最初のページ読み込みが真に反映されます。これは、ページにキャッシュされている項目を決定するのにも役立つため、"ウォーム" ページの読み込みと比較する必要があります。
問題の調査に役立つ他のユーザーと関連する詳細を共有します。ツールで提供される詳細または情報を開発者またはテクニカルサポート担当者と共有するには、 HTTP アーカイブへのエクスポートを有効にする (HAR) を使用することをお勧めします。

[開始] をクリックする前にエクスポートを有効にする必要があります。これにより、ブラウザーでデバッグモードが有効になります。これにより HTTP アーカイブファイル (HAR) が生成され、[ネットワークトレース] タブからアクセスできます。[HAR にエクスポート] ボタンをクリックして、ファイルをコンピューターにダウンロードし、それに応じて共有できます。ファイルは、F12 Developer Tools や Fiddler など、さまざまなデバッグツールで開くことができます。

ネットワークトレース。

重要

これらの結果には URL が含まれており、PII (個人を特定できる情報) として分類できます。その情報を配布する前に、必ずorganizationのガイドラインに従ってください。

Microsoft サポートとの関わり

サポートケースで直接作業する場合にのみ使用する必要があるMicrosoft サポートレベルの機能が含まれています。この機能を利用すると、サポートチームの関与なしに使用してもメリットが得られなくなり、ページのパフォーマンスが大幅に低下する可能性があります。ツールでこの機能を使用する場合、サービスのログ記録に追加情報が追加されるため、追加情報はありません。

変更は表示されません。ただし、有効にしたと通知され、有効になっている間にページのパフォーマンスが 2 ~ 3 倍低下します。これは、特定のページとそのアクティブなセッションにのみ関連します。このため、これは控えめに使用し、サポートに積極的に関与している場合にのみ使用する必要があります。

Microsoft サポートレベル機能を有効にするには

SharePoint 用ページ診断ツールを開きます。
キーボードで Alt キーを押しながら Shift キーを押しながら L キーを押します。 [サポートログの有効化] チェックボックスが表示されます。
[チェック] ボックスを選択し、[開始] をクリックしてページを再読み込みし、詳細ログを生成します。

CorrelationID (ツールの上部に表示) をメモし、サポート担当者に提供して、診断セッションに関する追加情報を収集できるようにする必要があります。