Usar a ferramenta diagnóstico de página para SharePointUse the Page Diagnostics for SharePoint tool

Este artigo descreve como usar a ferramenta diagnóstico de página para SharePoint para analisar as páginas de site modernas e clássicas do SharePoint Online em um conjunto de critérios de desempenho predefinido.This article describes how to use the Page Diagnostics for SharePoint tool to analyze SharePoint Online modern and classic site pages against a pre-defined set of performance criteria.

A ferramenta diagnóstico de página para SharePoint pode ser instalada para:The Page Diagnostics for SharePoint tool can be installed for:

Tip

A versão 2.0.0 e posterior inclui suporte para páginas modernas, além de páginas de site clássicas.Version 2.0.0 and later includes support for modern pages in addition to classic site pages. Se não tiver certeza sobre qual versão da ferramenta você está usando, você pode selecionar o link sobre ou as reticências (...) para verificar sua versão.If you are unsure which version of the tool you are using, you can select the About link or the ellipses (...) to verify your version. Sempre atualize para a versão mais recente ao usar a ferramenta.Always update to the latest version when using the tool.

A ferramenta Diagnóstico de Página para SharePoint é uma extensão do navegador para os novos navegadores Microsoft Edge (https://www.microsoft.com/edge) e Chrome que analisam o portal moderno do SharePoint Online e as páginas clássicas de site de publicação.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. Essa ferramenta só funciona no SharePoint Online e não pode ser usada em uma página de sistema do SharePoint.This tool only works for SharePoint Online, and cannot be used on a SharePoint system page.

A ferramenta gera um relatório para cada página analisada mostrando como a página é executada em um conjunto de regras predefinido e exibe informações detalhadas quando os resultados de um teste ficam fora do valor da linha de base.The tool generates a report for each analyzed page showing how the page performs against a pre-defined set of rules and displays detailed information when results for a test fall outside the baseline value. Os administradores e designers do SharePoint Online podem usar a ferramenta para solucionar problemas de desempenho e garantir que as novas páginas sejam otimizadas antes da publicação.SharePoint Online administrators and designers can use the tool to troubleshoot performance issues and to ensure that new pages are optimized prior to publishing.

A ferramenta diagnóstico de página foi projetada para analisar somente as páginas do site do SharePoint, e não as páginas do sistema, como AllItems. aspx ou SharePoint. aspx.The Page Diagnostics tool is designed to analyze SharePoint site pages only, not system pages such as allitems.aspx or sharepoint.aspx. Se você tentar executar a ferramenta em uma página do sistema ou em qualquer outra página que não seja do site, receberá uma mensagem de erro informando que a ferramenta não pode ser executada para esse tipo de página.If you attempt to run the tool on a system page or any other non-site page, you will receive an error message advising that the tool cannot be run for that type of page.

Deve ser executado em uma página do SharePoint

Isso não é um erro na ferramenta, já que não há nenhum valor em avaliar bibliotecas ou páginas do sistema.This is not an error in the tool as there is no value in assessing libraries or system pages. Navegue até uma página de site do SharePoint para usar a ferramenta.Please navigate to a SharePoint site page to use the tool. Se esse erro ocorrer em uma página do SharePoint, verifique a página mestra para garantir que as marcas meta do SharePoint não foram removidas.If this error occurs on a SharePoint page, please check the master page to ensure that the SharePoint metatags have not been removed.

Para fornecer comentários sobre a ferramenta, selecione as reticências no canto superior direito da ferramenta e, em seguida, selecione enviar comentários.To provide feedback about the tool, select the ellipsis at the top right corner of the tool and then select Give feedback.

Envie comentários

Instalar a ferramenta diagnóstico de página para o SharePointInstall the Page Diagnostics for SharePoint tool

O procedimento de instalação nesta seção funcionará para os navegadores Chrome e Microsoft Edge.The installation procedure in this section will work for both the Chrome and Microsoft Edge browsers.

Important

A Microsoft não lê dados ou conteúdo de página que é analisado pela ferramenta diagnóstico de página para SharePoint e não capturamos informações pessoais, sites ou informações de download.Microsoft does not read data or page content that is analyzed by the Page Diagnostics for SharePoint tool, and we do not capture any personal information, website or download information. As únicas informações identificáveis registradas na Microsoft pela ferramenta são o nome do locatário, as contagens de regras que falharam e a data e a hora em que a ferramenta foi executada.The only identifiable information logged to Microsoft by the tool is the tenant name, counts of rules that have failed and the date and time the tool was run. Essas informações são usadas pela Microsoft para entender melhor as tendências de uso do site de publicação e portal e problemas comuns de desempenho.This information is used by Microsoft to better understand modern portal and publishing site usage trends and common performance issues.

  1. Instale a ferramenta diagnóstico de página para o SharePoint para Microsoft Edge (extensão de borda) ou Chrome (extensão Chrome).Install the Page Diagnostics for SharePoint tool for Microsoft Edge (Edge extension) or Chrome (Chrome extension). Revise a política de privacidade do usuário fornecida na página de descrição da loja.Please review the User Privacy Policy provided on the description page in the store. Ao adicionar a ferramenta ao navegador, você verá o aviso de permissões a seguir.When adding the tool to your browser, you will see the following permissions notice.

    Permissões de extensão

    Este aviso está no local porque uma página pode conter conteúdo de locais fora do SharePoint, dependendo das Web Parts e personalizações na página.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. Isso significa que a ferramenta lerá as solicitações e respostas quando o botão iniciar for clicado e apenas para a guia ativa do SharePoint, onde a ferramenta está em execução.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. Essas informações são capturadas localmente pelo navegador da Web e estão disponíveis por meio do botão exportar para JSON ou exportar para o Har na guia de rastreamento de rede da ferramenta. as informações não são enviadas ou capturadas pela Microsoft.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. (A ferramenta respeita a política de privacidade da Microsoft acessível aqui).(The tool respects the Microsoft privacy policy accessible here.)

    A permissão gerenciar seus downloads abrange o uso da funcionalidade exportar para JSON da ferramenta.The Manage your downloads permission covers use of the tool's Export to JSON functionality. Siga as diretrizes de privacidade da sua empresa antes de compartilhar o arquivo JSON fora da sua organização, já que os resultados contêm URLs e que podem ser classificados como PII (informações de identificação pessoal).Please 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. Se você quiser usar a ferramenta no modo incógnito ou InPrivate, siga o procedimento para seu navegador:If you want to use the tool in Incognito or InPrivate mode, follow the procedure for your browser:

    1. No Microsoft Edge, navegue até extensões ou digite Edge://Extensions na barra URL e selecione detalhes para a extensão.In Microsoft Edge, navigate to Extensions or type edge://extensions in the URL bar and select Details for the extension. Nas configurações de extensão, marque a caixa de seleção para permitir no InPrivate.In the extension settings, select the checkbox for allow in InPrivate.
    2. No Chrome, navegue até extensões ou digite Chrome://Extensions na barra URL e selecione detalhes para a extensão.In Chrome, navigate to Extensions or type chrome://extensions in the URL bar and select Details for the extension. Nas configurações de extensão, selecione o controle deslizante para permitir no incógnito.In the extension settings, select the slider for allow in Incognito.
  3. Navegue até a página do site do SharePoint no SharePoint Online que você gostaria de revisar.Navigate to the SharePoint site page on SharePoint Online that you would like to review. Nós permitimos o "carregamento de atraso" dos itens nas páginas; Portanto, a ferramenta não será interrompida automaticamente (o design para acomodar todos os cenários de carregamento de página).We have allowed for "delay loading" of items on pages; therefore, the tool will not stop automatically (this is by design to accommodate all page load scenarios). Para interromper a coleta, selecione parar.To stop collection, select Stop. Certifique-se de que a carga da página foi concluída antes de interromper a coleta de dados ou você só Capture um rastreamento parcial.Make sure that the page load has completed before you stop data collection or you will only capture a partial trace.

  4. Clique no botão da barra de ferramentas da extensãoClick on the extension's toolbar button Diagnóstico de página para o logotipo do SharePoint para carregar a ferramenta e será exibida a seguinte janela pop-up de extensão:to load the tool and you will be presented with the following extension popup window:

    Pop-up de ferramentas de diagnóstico de página

Selecione Iniciar para começar a coletar dados para análise.Select Start to begin collecting data for analysis.

O que você verá na ferramenta diagnóstico de página para SharePointWhat you'll see in the Page Diagnostics for SharePoint tool

  1. Clique nas reticências (...) no canto superior direito da ferramenta para localizar os seguintes links:Click the ellipses (...) in the top right corner of the tool to find the following links:

    1. O link recursos adicionais fornece orientações gerais e detalhes sobre a ferramenta, incluindo um link de volta para este artigo.The Additional resources link provides general guidance and details regarding the tool including a link back to this article.
    2. O link fornecer feedback fornece um link para o site de voz do usuário de colaboração e sites do SharePoint .The Give feedback link provides a link to the SharePoint Sites and Collaboration User Voice site.
    3. O link about inclui a versão atualmente instalada da ferramenta e um link direto para o aviso de terceiros da ferramenta.The About link includes the currently installed version of the tool and a direct link to the tool's third party notice.
  2. A ID de correlação, SPRequestDuration, SPIISLatency, tempo de carregamento de páginae detalhes de URL são informativas e podem ser usadas para alguns fins.The Correlation ID, SPRequestDuration, SPIISLatency, Page load time, and URL details are informational and can be used for a few purposes.

    Detalhes de diagnóstico de página

    • O CorrelationId é um elemento importante ao trabalhar com o suporte da Microsoft, pois ele permite coletar dados de diagnóstico adicionais para a página específica.CorrelationID is an important element when working with Microsoft Support as it allows them to gather additional diagnostic data for the specific page.
    • SPRequestDuration é o tempo necessário para que o SharePoint processe a página.SPRequestDuration is the time taken for SharePoint to process the page. Navegação estrutural, imagens grandes, muitas chamadas de API podem contribuir para durações mais longas.Structural navigation, large images, lots of API calls could all contribute to longer durations.
    • SPIISLatency é o tempo em milissegundos levado para o SharePoint Online começar a carregar a página.SPIISLatency is the time in milliseconds taken for SharePoint Online begin loading the page. Esse valor não inclui o tempo gasto para o aplicativo Web responder.This value does not include the time taken for the web application to respond.
    • Tempo de carregamento da página é o tempo total registrado pela página a partir da hora da solicitação até o momento em que a resposta foi recebida e renderizada no navegador.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. Esse valor é afetado por vários fatores, incluindo latência de rede, o desempenho do computador e o tempo necessário para o navegador carregar a página.This value is affected by a variety of factors including network latency, the performance of the computer and the time it takes for the browser to load the page.
    • A URL da página (Uniform Resource Locator) é o endereço da Web da página atual.The Page URL (Uniform Resource Locator) is the web address of the current page.
  3. A guia testes de diagnóstico exibe os resultados da análise em três categorias; Nenhuma ação é necessária, oportunidades de melhoria e atenção requeridas.The Diagnostic tests tab displays the analysis results in three categories; No action required, Improvement opportunities and Attention required. Cada resultado de teste é representado por um item em uma destas categorias, conforme descrito na tabela a seguir:Each test result is represented by an item in one of these categories as described in the following table:

    CategoriaCategory CorColor DescriçãoDescription
    Atenção requeridaAttention required VermelhoRed O resultado do teste fica fora do valor da linha de base e afeta o desempenho da página.Test result falls outside the baseline value and is affecting page performance. Siga as orientações de correção.Follow remediation guidance.
    Oportunidades de aprimoramentoImprovement opportunities AmareloYellow O resultado do teste fica fora do valor da linha de base e pode estar contribuindo para problemas de desempenho.Test result falls outside the baseline value and could be contributing to performance issues. Critérios específicos de teste podem ser aplicados.Test-specific criteria may apply.
    Nenhuma ação é necessáriaNo action required VerdeGreen O resultado do teste cai dentro do valor da linha de base do teste.Test result falls within the test's baseline value.

    Diagnóstico de página

  4. Uma guia rastreamento de rede fornece detalhes sobre solicitações e respostas de compilação de página.A Network trace tab provides details about page build requests and responses.

Como usar a guia testes de diagnósticoHow to use the Diagnostic tests tab

Quando você analisa uma página de portal moderna do SharePoint ou uma página de site de publicação clássica com a ferramenta diagnóstico de página para SharePoint, os resultados são analisados usando regras predefinidas que comparam resultados nos valores de linha de base e exibidos na guia testes de diagnóstico . as regras para determinados testes podem usar valores de linha de base diferentes para o portal moderno e sites de publicação clássicos, dependendoWhen you analyze a SharePoint modern portal page or classic publishing site page with the Page Diagnostics for SharePoint tool, results are analyzed using pre-defined 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.

Os resultados do teste que aparecem nas categorias oportunidades de melhoria ou atenção obrigatória indicam áreas que devem ser revisadas em relação às práticas recomendadas e podem ser selecionadas para exibir informações adicionais sobre o resultado.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. Os detalhes de cada item incluem um link saiba mais , que o levará diretamente para a orientação apropriada relacionada ao teste.Details for each item include a Learn more link which will take you directly to the appropriate guidance related to the test. Os resultados do teste que aparecem na categoria nenhuma ação necessária indicam conformidade com a regra relevante e não exibem detalhes adicionais quando selecionados.Test results that appear in the No action required category indicate compliance with the relevant rule and do not display additional details when selected.

As informações na guia testes de diagnóstico não mostrarão como projetar páginas, mas destacarão fatores que podem afetar o desempenho da página.The information in the Diagnostics tests tab will not tell you how to design pages, but will highlight factors that may impact page performance. Algumas funcionalidades e personalizações de página têm um impacto inevitável no desempenho da página e devem ser examinadas em busca de possíveis remediação ou omissões da página, se o impacto for substancial.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.

Os resultados vermelhos ou amarelos também podem indicar Web Parts que atualizam os dados com muita frequência.Red or yellow results may also indicate web parts that refresh data too frequently. Por exemplo, as notícias corporativas não são atualizadas a cada segundo, mas as Web Parts personalizadas costumam ser criadas para buscar as últimas notícias a cada segundo, em vez de implementar os elementos de cache que podem aprimorar a experiência geral do usuário.For example, corporate news is not 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. Tenha em mente quando incluir Web Parts em uma página que costuma haver maneiras simples de reduzir o impacto do desempenho, avaliando o valor de cada parâmetro disponível para garantir que ele seja definido apropriadamente para o objetivo desejado.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 is set appropriately for its intended purpose.

Note

Os sites de equipe clássicos que não têm o recurso de publicação habilitado não podem fazer uso do CDNs.Classic team sites that don't have the publishing feature enabled cannot make use of CDNs. Quando você executa a ferramenta nesses sites, espera-se que o teste da CDN falhe e seja ignorado, mas todos os testes restantes são aplicáveis.When you run the tool on these sites, the CDN test is expected to fail and can be ignored, but all of the remaining tests are applicable. A funcionalidade adicional do recurso de publicação do SharePoint pode aumentar o tempo de carregamento da página, portanto, ela não deve ser habilitada apenas para permitir a funcionalidade da CDN.The additional functionality of the SharePoint publishing feature can increase page load times, so it should not be enabled just to allow CDN functionality.

Important

As regras de teste são adicionadas e atualizadas regularmente, portanto, confira a versão mais recente da ferramenta para obter detalhes sobre as regras atuais e informações específicas incluídas nos resultados do teste.Test rules are added and updated regularly so please refer to the latest version of the tool for details about current rules and specific information included in test results. Você pode verificar a versão Gerenciando suas extensões e a extensão avisará se uma atualização está disponível.You can verify the version by managing your extensions and the extension will advise whether an update is available.

Como usar a guia rastreamento de redeHow to use the Network Trace tab

A guia rastreamento de rede fornece informações detalhadas sobre as duas solicitações para criar a página e as respostas recebidas do SharePoint.The Network Trace tab provides detailed information about both requests to build the page and the responses received from SharePoint.

  1. Procure tempos de carregamento de item sinalizados como vermelho.Look for item load times flagged as red. Cada solicitação e resposta é codificada por cores para indicar seu impacto no desempenho geral da página usando as seguintes métricas de latência:Each request and response is color coded to indicate its impact on overall page performance using the following latency metrics:

    • Verde: < 500 milhõesGreen: < 500ms
    • Amarelo: 500-1000msYellow: 500-1000ms
    • Vermelho: > 1000msRed: > 1000ms

    Rastreamento de rede

    Na imagem mostrada acima, o item vermelho pertence à página padrão.In the image shown above, the red item pertains to the default page. Ele sempre mostrará vermelho, a menos que a página seja carregada no < 1000ms (menos de 1 segundo).It will always show red unless the page loads in < 1000ms (less than 1 second).

  2. Teste os tempos de carregamento do item.Test item load times. Em alguns casos, não haverá nenhum indicador de tempo ou de cor porque os itens já foram armazenados em cache pelo navegador.In some cases there will be no time or color indicator because the items have already been cached by the browser. Para testar corretamente, abra a página, limpe o cache do navegador e, em seguida, clique em Iniciar como isso forçará uma carga de página "Cold" e será uma reflexão verdadeira da carga inicial da página.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. Isso deve ser comparado com a carga de página "quente" como isso também ajudará a determinar quais itens estão sendo armazenados em cache na página.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. Compartilhar detalhes relevantes com outras pessoas que podem ajudar a investigar problemas.Share relevant details with others who can help investigate issues. Para compartilhar os detalhes ou as informações fornecidas na ferramenta com seus desenvolvedores ou um profissional de suporte técnico, clique em exportar para JSON (conforme mostrado na imagem acima).To share the details or information provided in the tool with your developers or a technical support person, click Export to JSON (as shown in the image above). Isso permitirá que você baixe os resultados, exibíveis com um visualizador de arquivos JSON.That will enable you to download the results, viewable with a JSON file viewer.

    Se você optou por usar o recurso de visualização habilitar exportação para Har , o tipo de exportação aparecerá como exportar para Har.If you have opted to use the preview feature enable Export to HAR then the export type will show as Export to HAR.

    Rastreamento de rede

Important

Esses resultados contêm URLs e que podem ser classificados como PII (informações de identificação pessoal).These results contain URLs and that can be classified as PII (Personally Identifiable Information). Certifique-se de seguir as diretrizes da sua organização antes de distribuir essas informações.Make sure to follow your organization's guidelines before distributing that information.

Contratando o suporte da MicrosoftEngaging with Microsoft Support

Incluímos um recurso de nível de suporte da Microsoft que só deve ser utilizado ao trabalhar diretamente em um caso de suporte.We have included a Microsoft Support level feature that should only be utilized when working directly on a support case. A utilização desse recurso não fornecerá nenhum benefício quando for usada sem o contrato de equipe de suporte e poderá fazer com que a página seja executada de forma significativamente mais lenta.Utilizing this feature will provide no benefit to you when used without support team engagement, and can make the page perform significantly slower. Não há informações adicionais ao usar esse recurso na ferramenta, pois as informações adicionais são adicionadas ao registro em log no serviço.There is no additional information when using this feature in the tool as the additional information is added to the logging in the service.

Nenhuma alteração é visível, exceto que você será notificado de que a habilitou e o desempenho da página será significativamente reduzido por 2-3 vezes o desempenho mais lento durante a habilitação.No change is visible except that you will be notified that you have enabled it and your page performance will be significantly degraded by 2-3 times slower performance whilst enabled. Ele só será relevante para a página específica e essa sessão ativa.It will only be relevant for the particular page and that active session. Por esse motivo, isso deve ser usado com moderação e apenas quando ativamente envolvido no suporte.For this reason, this should be used sparingly and only when actively engaged with support.

Para habilitar o recurso de nível de suporte da MicrosoftTo enable the Microsoft Support level feature

  1. Abra a ferramenta diagnóstico de página para SharePoint.Open the Page Diagnostics for SharePoint tool.

  2. No teclado, pressione Alt-Shift-L.On your keyboard, press ALT-Shift-L. Isso exibirá a caixa de seleção habilitar o log de suporte .This will display the Enable support logging check box.

  3. Marque a caixa de seleção e clique em Iniciar para recarregar a página e gerar o registro em log detalhado.Select the check box, and then click Start to reload the page and generate verbose logging.

    Opção de suporte habilitada

    Você deve anotar o CorrelationId (exibido na parte superior da ferramenta) e fornecer ao representante de suporte para permitir que eles coletem informações adicionais sobre a sessão de diagnóstico.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.

Ajustar o desempenho do SharePoint OnlineTune SharePoint Online performance

Ajustar o desempenho do Office 365Tune Office 365 performance

Desempenho na experiência moderna do SharePointPerformance in the modern SharePoint experience

Redes de distribuição de conteúdoContent delivery networks

Usar a Rede de Distribuição de Conteúdo (CDN) do Office 365 com o SharePoint OnlineUse the Office 365 Content Delivery Network (CDN) with SharePoint Online