Use the Site Diagnostics Tool for SharePoint Online - Microsoft 365 Enterprise (2023)

  • Article

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

Page Diagnostics for SharePoint can be installed on:


Version2.0.0and later includes support for modern pages in addition to classic site pages. If you are not sure which version of the tool you are using, you can chooseAboutthe link or ellipses (...) to confirm your version.Always update to the latest versionwhen using the tool.

The Page Diagnostics for SharePoint tool is a browser extension for the new Microsoft Edge ( and Chrome browsers that parse the modern SharePoint Online portal and classic publishing sites.


This tool works for SharePoint Online only and cannot be used on a SharePoint system page or a SharePoint application page. The app page type is designed to be used for specific business apps in SharePoint Online, not portals. The tool is designed to optimize portal pages and team site pages.

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

The Page Diagnostics Tool is designed to only analyze SharePoint site pages, not system pages likeall items.aspxosharepoint.aspx. If you try to run the tool on a system page or any other page outside the site, you will get an error message that the tool cannot run for that type of page.

Use the Site Diagnostics Tool for SharePoint Online - Microsoft 365 Enterprise (1)

(Video) How to Utilize Diagnostic Tab in the SharePoint Online Page Diagnostics Tool - Dock 365 Blog

This is not a bug in the tool as there is no value in evaluating libraries or system pages. Go to a SharePoint page to use the tool. If this error occurs on a SharePoint page, check the master page to ensure that the SharePoint meta tags have not been removed.

To provide feedback on the tool, select the ellipsis in the upper-right corner of the tool and selectgive feedback.

Use the Site Diagnostics Tool for SharePoint Online - Microsoft 365 Enterprise (2)

The installation process in this section works for Chrome and Microsoft Edge browsers.


Microsoft does not read the data or page content analyzed by the Page Diagnostics for SharePoint tool and does not log personal information, website or download information. The only identifiable information recorded with Microsoft by the tool is the tenant name, the number of rules that failed, and the date and time the tool was run. This information is used by Microsoft to better understand current trends in portal and publishing site usage and common performance issues.

  1. Install the Diagnostic Pages tool for SharePointMicrosoft edge (Kantudvidlês)oChrome (Chrome extension). Read the user protection policy on the store description page. When adding the tool to your browser, you will see the following permission message.

    Use the Site Diagnostics Tool for SharePoint Online - Microsoft 365 Enterprise (3)

    This warning applies because a page can contain content from locations outside of SharePoint, depending on the web parts and customizations on the page. This means that the tool reads requests and responses when the Start button is clicked, and only for the active SharePoint tab the tool is running on. This information is logged locally by your web browser and is available to you viaExport to JSONoExport for HARbutton on toolnetwork monitoringaba.The information is not sent or recorded by Microsoft.(The tool complies with Microsoft's privacy policy, which is availablewhether.)

    Omanage your downloadsthe license covers the use of the toolExport to JSONFunctionality. Follow your company's privacy guidelines before sharing the JSON file outside your organization, as the results contain URLs that could be classified as PII (Personally Identifiable Information).

  2. To use the tool in Incognito or InPrivate mode, follow the procedure for your browser:

    1. In Microsoft Edge, go toExtensionsor typeedge://extensionsin the URL bar and selectDetailsfor the extension. In extension settings, check the box toallowed in InPrivate.
    2. In Chrome, go toExtensionsor typechrome://extensionsin the URL bar and selectDetailsfor the extension. In the extension settings, select the slider toAllow incognito browsing.
  3. Go to the SharePoint site page in SharePoint Online that you want to verify. We enable "lazy loading" of elements on pages. Therefore, the tool does not stop automatically (this is designed to accommodate all page load scenarios). Select to stop collectionhope. Make sure the page has finished loading before stopping collecting data, otherwise you will only capture a partial crawl.

  4. Click the extension toolbar buttonUse the Site Diagnostics Tool for SharePoint Online - Microsoft 365 Enterprise (4)to load the tool and the following extension popup will appear:

    (Video) Analyze and diagnose SharePoint site performance

    Use the Site Diagnostics Tool for SharePoint Online - Microsoft 365 Enterprise (5)

to choosePrincipleto start collecting data for analysis.

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

    1. Oadditional resourcesThe link provides general instructions and details about the tool, including a link to this article.
    2. Ogive feedbacklink provides a link toSharePoint Sites and Collaboration User VoiceWeb site.
    3. OAboutthe link includes the currently installed version of the tool and a direct link to the third-party advertisement for the tool.
  2. OKorrelations-id, SPrequestDuration, SPIISLlatency,Page load time, eURLDetails are informational and can be used for certain purposes.

    Use the Site Diagnostics Tool for SharePoint Online - Microsoft 365 Enterprise (6)

    • ID-correlationsis an important item when working with Microsoft Support as it allows you to collect more diagnostic data for this page.
    • SPrequestDurationis the time that SharePoint takes to process the page. Structure navigation, large images, lots of API calls can contribute to longer duration.
    • the hidden spiritis the time in milliseconds it takes for SharePoint Online to start loading the page. This price does not include the time it takes for the web application to respond.
    • Page load timeis the total time taken by the page from the time of the request until the time the response is received and rendered to the browser. This value is affected by many factors, including network latency, computer performance, and the time it takes your browser to load the page.
    • OURL lateral(Uniform Resource Locator) is the web address of the current page.
  3. Odiagnostic examsthe tab displays the analysis results in three categories.No action required,improvement opportunitieseCaution is necessary. Each test result is represented by an item in one of these categories, as described in the following table:

    Caution is necessaryRedThe test result is outside the baseline value and affects page performance. Follow repair instructions.
    improvement opportunitiesGulThe test result is outside the baseline value and can contribute to performance issues. Specific criteria may apply to the test.
    No action requiredVerdeThe test result is within the test reference value.

    Use the Site Diagnostics Tool for SharePoint Online - Microsoft 365 Enterprise (7)

  4. EMnetwork monitoringThe tab provides details about page creation requests and responses.

How to use the Diagnostics tab

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

Test results displayed inimprovement opportunitiesoCaution is necessaryCategories indicate areas to review against best practice and can be selected to display additional information about the result. Details for each item include ato know morelink, which takes you directly to the relevant instructions regarding the test. Test results displayed inNo action requiredThe category indicates compliance with the relevant rule and does not provide further details when selected.

The information on the Diagnostics tab does not tell you how to create pages, but it does point out factors that can affect page performance. Some page features and customizations have an unavoidable impact on page performance and should be reviewed for mitigation or page removal if the impact is significant.

Results in red or yellow can also indicate web parts that update data too frequently. For example, company news is not updated every second, but custom web parts are often built to retrieve the latest news every second rather than implementing caching elements that can improve the overall user experience. Keep in mind that when including web parts on a page, there are often simple ways to reduce the performance impact by evaluating the value of each available parameter to ensure it is set correctly for its intended purpose.


(Video) How to use Microsoft SharePoint

Classic team sites that don't have publishing enabled can't use a CDN. When running the tool on these sites, the CDN test is expected to fail and can be skipped, but all other tests apply. The additional functionality of the SharePoint publishing feature can increase page load time, so it should not be enabled just to enable CDN functionality.


Test rules are added and updated regularly, so please refer to the latest version of the tool for details on current rules and specific information included in the test results. You can confirm the version by managing your extensions and the extension will notify you if an update is available.

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

Onetwork monitoringThe tab provides detailed information about the requests to create the page and the responses received from SharePoint.

  1. Look for loading times for items highlighted in red. Each request and response is color-coded to indicate its impact on the page's overall performance, using the following latency metrics:

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

    Use the Site Diagnostics Tool for SharePoint Online - Microsoft 365 Enterprise (8)

    In the image above, the red element is associated with the default page. It will always show red unless the page loads in < 1000 ms (less than 1 second).

  2. Loading times for test items. In some cases, there will be no indication of time or color because the information has already been cached by the browser. To verify correctly, open the page, clear your browser's cache, and clickPrincipleas it will force a "cold" page load and will be a true reflection of the original page load. This should be compared to "hot" page loading as it will also help determine which elements are cached on the page.

  3. Share relevant details with others who can help investigate issues. To share the details or information in the tool with its developers or a technical support usingEnable export to HTTP file (HAR)is the recommended approach.

    Use the Site Diagnostics Tool for SharePoint Online - Microsoft 365 Enterprise (9)

It must be enabled before you click Start, which will enable debug mode in your browser. It will create an HTTP Archive (HAR) file, which you can access through the Network Tracing tab. Click "Export to HAR" and it will download the file to your computer and you can share it properly. The file can be opened in various debugging tools such as F12 Developer Tools and Fiddler.

Use the Site Diagnostics Tool for SharePoint Online - Microsoft 365 Enterprise (10)


These results contain URLs that can be classified as PII (Personally Identifiable Information). Be sure to follow your organization's guidelines before distributing this information.

(Video) Microsoft 365 - Page Analytics for SharePoint Online pages

Working with Microsoft Support

We include aMicrosoft support level capabilitywhich should only be used when working directly on a support case. Using this feature will not benefit you when used without the involvement of the support team and may cause the performance of the site to be significantly slower. There is no additional information when using this feature in the tool as the additional information is added to the log on the service.

No changes are visible except that you will be notified that you have enabled it and your page performance will be significantly degraded with 2-3x slower performance while enabled. It will only be relevant for this page and the active session. For this reason, it should be used sparingly and only when actively involved with support.

To enable the Microsoft Support Level feature

  1. Open the Diagnostic Pages tool for SharePoint.

  2. Tap on your keyboardALT-Shift-L. this will showEnable support logcontrol box.

  3. Select the checkbox and clickPrincipleto reload the page and generate verbose logging.

    Use the Site Diagnostics Tool for SharePoint Online - Microsoft 365 Enterprise (11)

    You should make a note of the CorrelationID (displayed at the top of the tool) and provide it to your support agent so that they can gather additional information about the diagnostic session.

Tune SharePoint Online performance

Tune Office 365 performance

Performance in the modern SharePoint experience

Content delivery network

Use o Office 365 Content Delivery Network (CDN) para o SharePoint Online

(Video) Support Webcast, Diagnostics in Office 365


1. How to troubleshoot SharePoint Online Storage, Permissions and Sharing | Microsoft
(Microsoft Helps)
2. How to Monitor Microsoft SharePoint Online Performance
3. O365Eh! - Episode #89 - Troubleshooting Microsoft Teams with Self-Help Diagnostics
(O365 Eh!)
4. SharePoint Online - You need permission to access this site [Solved]
(M365 World Blog)
5. How to Monitor ALL of Microsoft 365 (8 Different Apps)
6. Troubleshooting Performance Issues in SharePoint Online
(Boston Office 365 User Group)


Top Articles
Latest Posts
Article information

Author: Nathanial Hackett

Last Updated: 25/08/2023

Views: 5706

Rating: 4.1 / 5 (52 voted)

Reviews: 83% of readers found this page helpful

Author information

Name: Nathanial Hackett

Birthday: 1997-10-09

Address: Apt. 935 264 Abshire Canyon, South Nerissachester, NM 01800

Phone: +9752624861224

Job: Forward Technology Assistant

Hobby: Listening to music, Shopping, Vacation, Baton twirling, Flower arranging, Blacksmithing, Do it yourself

Introduction: My name is Nathanial Hackett, I am a lovely, curious, smiling, lively, thoughtful, courageous, lively person who loves writing and wants to share my knowledge and understanding with you.