Use IDs de Correlação em Solicitações de Suporte do SharePoint: Checklist Prático para Proprietários

Quando uma página do SharePoint não carrega, uma biblioteca de documentos para de sincronizar ou uma alteração de permissão não surte efeito, a mensagem de erro geralmente contém uma longa sequência de letras e números chamada ID de Correlação. Muitos proprietários de site ignoram esse código porque não sabem o que significa ou como usá-lo. Um ID de Correlação atua como um ponteiro que permite que os engenheiros de suporte da Microsoft localizem a entrada exata do log do servidor para uma solicitação com falha. Este artigo explica o que é um ID de Correlação, por que ele é importante para a solução de problemas e fornece um checklist prático que você pode seguir para coletar e enviar IDs de Correlação em suas solicitações de suporte.

O que é um ID de Correlação e por que o SharePoint gera um

Um ID de Correlação é um GUID exclusivo que o SharePoint atribui a cada solicitação HTTP que passa pelo servidor. Quando você abre um site, carrega um arquivo ou altera uma permissão, o SharePoint registra os detalhes dessa solicitação — incluindo o usuário, a hora, a URL e quaisquer erros — e a marca com um ID de Correlação. O ID é gerado pelo SharePoint Unified Logging Service (ULS) e é armazenado nos logs de rastreamento ULS no servidor.

O objetivo do ID de Correlação é vincular um erro visível ao usuário à entrada de log correspondente no servidor. Sem ele, os engenheiros de suporte teriam que pesquisar milhões de entradas de log por hora e usuário, o que é lento e não confiável. Com o ID de Correlação, eles podem ir diretamente para a solicitação que falhou e ver a exceção exata, o rastreamento de pilha e o contexto ao redor.

Os IDs de Correlação aparecem em vários lugares: na página de erro do navegador, nos logs ULS do SharePoint, no Visualizador de Eventos do Windows no servidor SharePoint e em ferramentas de diagnóstico como Fiddler ou as ferramentas do desenvolvedor do navegador. Para SharePoint Online, o ID de Correlação fica visível na página de erro e no tráfego de rede do navegador, mas os logs ULS não são acessíveis aos usuários finais. Para SharePoint Server, você pode acessar os logs ULS diretamente no servidor.

Onde os IDs de Correlação aparecem no SharePoint Online

No SharePoint Online, o local mais comum para ver um ID de Correlação é a página de erro que aparece quando uma solicitação falha. A página de erro mostra uma mensagem como “Desculpe, algo deu errado” seguida por uma seção de detalhes técnicos que inclui o ID de Correlação. Você também pode encontrar o ID de Correlação abrindo as ferramentas do desenvolvedor do seu navegador, recarregando a página e inspecionando as solicitações de rede. Procure a solicitação que retornou um código de status 500 ou 400 e verifique os cabeçalhos de resposta para o campo chamado “SPRequestGuid” ou “X-SharePointHealthScore.”

Onde os IDs de Correlação aparecem no SharePoint Server

No SharePoint Server, o ID de Correlação aparece na mesma página de erro que no Online. Além disso, o ID é registrado nos logs de rastreamento ULS localizados no servidor em C:\Program Files\Common Files\Microsoft Shared\Web Server Extensions\16\LOGS. Você também pode encontrá-lo no Log de Eventos do Windows Application sob a origem “SharePoint Foundation” ou “SharePoint Server.”

Checklist: Etapas para Coletar e Enviar um ID de Correlação em uma Solicitação de Suporte

Siga este checklist sempre que você tiver um erro do SharePoint que precise ser escalado para o suporte da Microsoft. Cada etapa é independente, então você pode começar com o método que for mais conveniente para você.

1. Capture o ID de Correlação da página de erro
   Quando a página de erro aparecer, procure uma seção chamada “ID de Correlação” ou “Detalhes Técnicos.” O ID é uma string hexadecimal de 32 caracteres agrupada em cinco seções, por exemplo: a1b2c3d4-e5f6-7890-abcd-ef1234567890. Copie a string inteira para um arquivo de texto ou anotação. Se a página de erro não mostrar o ID, vá para a próxima etapa.
2. Abra as ferramentas do desenvolvedor do navegador (F12) e recarregue a página
   Pressione F12 para abrir as ferramentas do desenvolvedor. Clique na guia Rede. Recarregue a página ou repita a ação que causou o erro. Encontre a solicitação que falhou — procure uma entrada vermelha ou um código de status começando com 4 ou 5. Clique na solicitação e vá para a guia Cabeçalhos. Procure o cabeçalho de resposta chamado “SPRequestGuid” ou “X-SharePointHealthScore.” O valor de SPRequestGuid é o ID de Correlação. Clique com o botão direito no cabeçalho e selecione Copiar Valor.
3. Verifique a Integridade do Serviço na central de administração do Microsoft 365
   Vá para a central de administração do Microsoft 365 em admin.microsoft.com. Navegue até Saúde > Integridade do Serviço. Procure por qualquer aviso ou incidente ativo que mencione o SharePoint. Se você encontrar um incidente, anote o ID do incidente. O suporte da Microsoft pode pedir tanto o ID de Correlação quanto o ID do incidente para confirmar que seu problema está relacionado a um problema de serviço conhecido.
4. Colete a hora exata e o fuso horário do erro
   Registre a data e a hora em que o erro ocorreu, incluindo seu fuso horário. Os engenheiros de suporte usam a hora para restringir a janela de pesquisa do log. Use o formato de 24 horas para clareza, por exemplo: 2025-03-18 14:35 UTC.
5. Registre a URL completa e a ação que você executou
   Anote a URL completa da página onde o erro ocorreu. Descreva a ação exata que você executou — por exemplo, “cliquei no botão Carregar na biblioteca Documentos em https://contoso.sharepoint.com/sites/marketing/Shared%20Documents.” Inclua o nome da biblioteca, lista ou página.
6. Abra o log ULS no servidor SharePoint (apenas on-premises)
   Se você estiver usando SharePoint Server, navegue até C:\Program Files\Common Files\Microsoft Shared\Web Server Extensions\16\LOGS no servidor. Abra o arquivo de log mais recente que corresponda à hora do erro. Pesquise pelo ID de Correlação que você capturou. A entrada de log mostra o tipo de exceção, o rastreamento de pilha e o componente que falhou. Copie a seção relevante do log para um arquivo de texto.
7. Crie uma solicitação de suporte na central de administração do Microsoft 365
   Vá para a central de administração do Microsoft 365 e navegue até Suporte > Nova Solicitação de Serviço. Na descrição, cole o ID de Correlação, a hora exata, a URL e a ação que você executou. Anexe quaisquer arquivos de log que você coletou. Selecione o nível de gravidade que corresponde ao impacto.

Erros Comuns ao Usar IDs de Correlação em Solicitações de Suporte

Enviei o ID de Correlação errado de uma solicitação diferente

Um erro comum é copiar o ID de Correlação de uma solicitação bem-sucedida em vez da que falhou. Nas ferramentas do desenvolvedor do navegador, uma solicitação bem-sucedida retorna um código de status 200 e não é a origem do erro. Apenas solicitações com código de status 4xx ou 5xx contêm o ID de Correlação para a falha. Sempre verifique o código de status antes de copiar o ID.

Meu ID de Correlação está ausente na página de erro

Em alguns erros do SharePoint Online, a página de erro pode não exibir o ID de Correlação. Isso geralmente acontece quando o erro ocorre antes que o SharePoint possa gerar uma entrada de log — por exemplo, um tempo limite de rede ou um erro de proxy reverso. Nesse caso, verifique as ferramentas do desenvolvedor do navegador para o cabeçalho SPRequestGuid. Se o cabeçalho também estiver ausente, o problema provavelmente está no nível de rede ou DNS, não no SharePoint. Entre em contato com sua equipe de rede primeiro.

Enviei uma solicitação de suporte sem o ID de Correlação

Enviar uma solicitação de suporte sem um ID de Correlação força o engenheiro de suporte a pesquisar logs manualmente, o que atrasa a resolução. Se você não conseguir encontrar o ID de Correlação, forneça a hora exata, a conta de usuário e a URL. O engenheiro pode então executar uma consulta de log ULS no lado do servidor, mas isso leva mais tempo. Sempre tente capturar o ID de Correlação primeiro.

Item	SharePoint Online	SharePoint Server
ID de Correlação visível na página de erro	Sim	Sim
Acesso aos logs ULS	Não (a Microsoft gerencia os logs)	Sim (no servidor)
Método das ferramentas do desenvolvedor do navegador	Funciona (cabeçalho SPRequestGuid)	Funciona (cabeçalho SPRequestGuid)
Painel de Integridade do Serviço disponível	Sim	Não
Tempo de resposta típico do suporte com ID	1-4 horas	1-2 horas (se os logs forem fornecidos)

Agora você pode coletar um ID de Correlação de qualquer erro do SharePoint usando as ferramentas do desenvolvedor do navegador e a página de erro. Na próxima vez que abrir uma solicitação de suporte, inclua o ID de Correlação, a hora exata, a URL e a ação que você executou. Para SharePoint Server, anexe também a seção relevante do log ULS. Este checklist reduz a troca de mensagens com o suporte e ajuda a resolver problemas mais rapidamente.