Use the Page Diagnostics for SharePoint tool

This article describes how to use the Page Diagnostics for SharePoint tool to analyze SharePoint Online modern and classic site pages against a predefined set of performance criteria.

The Page Diagnostics for SharePoint tool can be installed for:

• Microsoft Edge extension)
• Chrome extension)

The Page Diagnostics for SharePoint tool is a browser extension for the new Microsoft Edge (https://www.microsoft.com/edge) and Chrome browsers that analyzes both SharePoint Online modern portal and classic publishing site pages.

The tool generates a report for each analyzed page showing how the page performs against a predefined set of rules and displays detailed information when results for a test fall outside the baseline value. SharePoint Online administrators and designers can use the tool to troubleshoot performance issues and to ensure that new pages are optimized prior to publishing.

The Page Diagnostics tool is designed to analyze SharePoint site pages only, not system pages such as allitems.aspx or sharepoint.aspx. If you attempt to run the tool on a system page or any other nonsite page, you'll receive an error message advising that the tool can’t be run for that type of page.

This isn't an error in the tool as there's no value in assessing libraries or system pages. Navigate to a SharePoint site page to use the tool. If this error occurs on a SharePoint page, check the master page to ensure that the SharePoint metatags haven't been removed.

To provide feedback about the tool, select the ellipsis at the top right corner of the tool and then select Give feedback.

Install the Page Diagnostics for SharePoint tool

The installation procedure in this section works for both the Chrome and Microsoft Edge browsers.

1. Install the Page Diagnostics for SharePoint tool for Microsoft Edge (Edge extension) or Chrome (Chrome extension). Review the User Privacy Policy provided on the description page in the store. When adding the tool to your browser, you'll see the following permissions notice.

   

   This notice is in place because a page may contain content from locations outside of SharePoint depending on the web parts and customizations on the page. This means that the tool will read the requests and responses when the start button is clicked and only for the active SharePoint tab where the tool is running. This information is captured locally by the web browser and is available to you via the Export to JSON or Export to HAR button in the tool's Network trace tab. The information is not sent to or captured by Microsoft. (The tool respects the Microsoft privacy policy accessible here.)

   The Manage your downloads permission covers use of the tool's Export to JSON functionality. Follow your company's own privacy guidelines before sharing the JSON file outside of your organization, as the results contain URLs and that can be classified as PII (Personally Identifiable Information).

2. If you want to use the tool in Incognito or InPrivate mode, follow the procedure for your browser:

   1. In Microsoft Edge, navigate to Extensions or type edge://extensions in the URL bar and select Details for the extension. In the extension settings, select the checkbox for allow in InPrivate.
   2. In Chrome, navigate to Extensions or type chrome://extensions in the URL bar and select Details for the extension. In the extension settings, select the slider for allow in Incognito.

3. Navigate to the SharePoint site page on SharePoint Online that you would like to review. We've allowed for "delay loading" of items on pages; therefore, the tool won't stop automatically (this is by design to accommodate all page load scenarios). To stop collection, select Stop. Make sure that the page load has completed before you stop data collection or you'll only capture a partial trace.

4. Click on the extension's toolbar button to load the tool and you'll be presented with the following extension popup window:

   

Select Start to begin collecting data for analysis.

What you'll see in the Page Diagnostics for SharePoint tool

1. Click the ellipses (...) in the top right corner of the tool to find the following links:

   1. The Additional resources link provides general guidance and details regarding the tool including a link back to this article.
   2. The Give feedback link provides a link to the SharePoint Sites and Collaboration User Voice site.
   3. The About link includes the currently installed version of the tool and a direct link to the tool's third party notice.

2. The Correlation ID, SPRequestDuration, SPIISLatency, Page load time, and URL details are informational and can be used for a few purposes.

   

   • CorrelationID is an important element when working with Microsoft Support as it allows them to gather more diagnostic data for the specific page.
   • SPRequestDuration is the time taken for SharePoint to process the page. Structural navigation, large images, lots of API calls could all contribute to longer durations.
   • SPIISLatency is the time in milliseconds taken for SharePoint Online begin loading the page. This value doesn't include the time taken for the web application to respond.
   • Page load time is the total time recorded by the page from the time of the request to the time the response was received and rendered in the browser. This value is affected by various factors including network latency, the performance of the computer and the time it takes for the browser to load the page.
   • The Page URL (Uniform Resource Locator) is the web address of the current page.

3. The Diagnostic tests tab displays the analysis results in three categories; No action required, Improvement opportunities and Attention required. Each test result is represented by an item in one of these categories as described in the following table:

   Category	Color	Description
   Attention required	Red	Test result falls outside the baseline value and is affecting page performance. Follow remediation guidance.
   Improvement opportunities	Yellow	Test result falls outside the baseline value and could be contributing to performance issues. Test-specific criteria may apply.
   No action required	Green	Test result falls within the test's baseline value.

   

4. A Network trace tab provides details about page build requests and responses.

How to use the Diagnostic tests tab

When you analyze a SharePoint modern portal page or classic publishing site page with the Page Diagnostics for SharePoint tool, results are analyzed using predefined rules that compare results against baseline values and displayed in the Diagnostic tests tab. Rules for certain tests may use different baseline values for modern portal and classic publishing sites depending on how specific performance characteristics differ between the two.

Test results that appear in the Improvement opportunities or Attention required categories indicate areas that should be reviewed against recommended practices, and can be selected to display additional information about the result. Details for each item include a Learn more link, which will take you directly to the appropriate guidance related to the test. Test results that appear in the No action required category indicate compliance with the relevant rule and don't display additional details when selected.

The information in the Diagnostics tests tab won't tell you how to design pages, but will highlight factors that may impact page performance. Some page functionality and customizations have an unavoidable impact on page performance, and should be reviewed for potential remediation or omission from the page if their impact is substantial.

Red or yellow results may also indicate web parts that refresh data too frequently. For example, corporate news isn't updated every second but custom web parts are often built to fetch the latest news every second instead of implementing caching elements that could improve the overall user experience. Keep in mind when including web parts on a page that there are often simple ways to reduce their performance impact by evaluating the value of each available parameter to ensure it's set appropriately for its intended purpose.

How to use the Network Trace tab and how to export a HAR file

The Network Trace tab provides detailed information about both requests to build the page and the responses received from SharePoint.

1. Look for item load times flagged as red. Each request and response is color coded to indicate its impact on overall page performance using the following latency metrics:

   • Green: < 500 ms
   • Yellow: 500-1000 ms
   • Red: > 1000 ms

   

   In the image shown above, the red item pertains to the default page. It will always show red unless the page loads in < 1000 ms (less than 1 second).

2. Test item load times. In some cases there will be no time or color indicator because the items have already been cached by the browser. To test this correctly, open the page, clear browser cache, and then click Start as that will force a "cold" page load and be a true reflection of the initial page load. This should then be compared to the "warm" page load as that will also help determine what items are being cached on the page.

3. Share relevant details with others who can help investigate issues. To share the details or information provided in the tool with your developers or a technical support person, using the Enable exporting to HTTP Archive (HAR) is the recommended approach.

   

Exporting should be enabled prior to clicking Start, which will then enable debug mode in your browser. This generates an HTTP Archive file (HAR) which can then be accessed through the "Network Trace" tab. Click the "Export to HAR" button to download the file to your computer and you can then share it accordingly. The file can be opened in various debug tools, like F12 Developer Tools and Fiddler.

Engaging with Microsoft Support

We've included a Microsoft Support level feature that should only be utilized when working directly on a support case. Utilizing this feature will provide no benefit to you when used without support team engagement, and can make the page perform significantly slower. There's no additional information when using this feature in the tool as the additional information is added to the logging in the service.

No change is visible except that you'll be notified that you have enabled it and your page performance will be degraded by 2-3 times slower performance whilst enabled. It will only be relevant for the particular page and that active session. For this reason, this should be used sparingly and only when actively engaged with support.

To enable the Microsoft Support level feature

1. Open the Page Diagnostics for SharePoint tool.

2. On your keyboard, press ALT-Shift-L. This will display the Enable support logging check box.

3. Select the check box, and then click Start to reload the page and generate verbose logging.

   

   You should note the CorrelationID (displayed at the top of the tool) and provide it to your support representative to enable them to gather additional information about the diagnostic session.

Related articles

Tune SharePoint Online performance

Tune Office 365 performance

Performance in the modern SharePoint experience

Content delivery networks

Use the Office 365 Content Delivery Network (CDN) with SharePoint Online