Como Usar IDs de Correlação em Solicitações de Suporte do SharePoint: Melhores Configurações para Microsoft 365

Ao enviar uma solicitação de suporte para o SharePoint Online, os engenheiros de suporte da Microsoft geralmente pedem um ID de correlação. Este é um identificador único vinculado a uma operação específica que falhou no sistema do SharePoint. Sem ele, as equipes de suporte não conseguem rastrear os logs de erro exatos, eventos do servidor e ações do usuário que causaram o problema. Este artigo explica como encontrar IDs de correlação no SharePoint, quais configurações você deve definir no Microsoft 365 para torná-los mais úteis e como incluí-los em suas solicitações de suporte para uma resolução mais rápida.

O que é um ID de Correlação e por que ele é importante para o suporte?

Um ID de correlação é um GUID (Identificador Global Exclusivo) que o SharePoint Online gera para cada solicitação que chega ao farm de servidores. Quando ocorre um erro, o sistema registra o ID junto com a hora exata, o contexto do usuário e o caminho do código que falhou. Os engenheiros de suporte da Microsoft usam esse ID para acessar os logs correspondentes de milhares de servidores no datacenter do Microsoft 365.

Sem um ID de correlação, os engenheiros de suporte precisam confiar em descrições genéricas de erro e carimbos de data/hora, que geralmente apontam para várias causas possíveis. Isso retarda o diagnóstico e pode levar a uma identificação incorreta da causa raiz. Ao fornecer um ID de correlação, você dá à equipe de suporte um link direto para o ponto exato da falha, reduzindo o tempo de resolução de dias para horas.

Os IDs de correlação também são valiosos para solução de problemas interna. Se você gerencia sites do SharePoint, pode usá-los para correlacionar problemas relatados por usuários com eventos do lado do servidor na central de administração do Microsoft 365 ou por meio de scripts do PowerShell.

Como o SharePoint gera um ID de correlação

Quando um usuário faz uma solicitação ao SharePoint Online — como carregar uma página, enviar um arquivo ou executar uma pesquisa — a solicitação passa por um balanceador de carga, um front-end web e um servidor de aplicativos. Cada componente adiciona suas próprias informações de log, mas o ID de correlação permanece constante em todos os saltos. Isso permite que a equipe de suporte reconstrua todo o caminho da solicitação.

Quais informações um ID de correlação contém

O ID em si é uma string hexadecimal de 32 caracteres, por exemplo: 5f8a1b2c-3d4e-5f6a-7b8c-9d0e1f2a3b4c. Ele não contém dados do usuário ou conteúdo do site. É puramente um identificador para a transação da solicitação. Os logs associados incluem o nome do usuário, a URL do site, o método HTTP (GET ou POST), o código de status da resposta e o módulo que gerou a exceção.

Etapas para encontrar e usar um ID de correlação em solicitações de suporte do SharePoint

1. Capture o ID de correlação de uma página de erro
   Quando o SharePoint exibe um banner de erro vermelho ou um erro de página inteira, o ID de correlação aparece na parte inferior da mensagem de erro. Geralmente é rotulado como “ID de correlação” ou “Correlação:” seguido pelo GUID. Copie a string inteira exatamente, incluindo os hífens. Não feche a guia do navegador até salvar o ID.
2. Use as Ferramentas do Desenvolvedor F12 para capturar IDs de erros intermitentes
   Abra as ferramentas do desenvolvedor do navegador pressionando F12. Vá para a guia Rede e recarregue a página ou repita a ação que falha. Procure por solicitações com código de status vermelho (400, 401, 403, 500, etc.). Clique na solicitação com falha, vá para a seção Cabeçalhos de Resposta e encontre o cabeçalho sprequestguid ou X-SharePointHealthScore. O ID de correlação geralmente está no campo sprequestguid. Copie o valor.
3. Ative o log de diagnóstico detalhado na central de administração do SharePoint
   Vá para Central de administração do SharePoint > Saúde > Logs de diagnóstico. Em Coleta de logs, selecione o conjunto de sites ou o escopo do locatário. Defina o nível de log como Detalhado. Isso garante que cada operação grave uma entrada de log com um ID de correlação. Observe que o log detalhado gera grandes quantidades de dados, portanto, ative-o apenas quando estiver solucionando problemas ativamente.
4. Colete o ID de um fluxo de trabalho ou fluxo do Power Automate com falha
   Quando um fluxo de trabalho do SharePoint ou um fluxo do Power Automate falha, abra o histórico de execução do fluxo. Nos detalhes do erro, procure um campo chamado correlationId ou runId. Copie este valor. Para fluxos de trabalho clássicos do SharePoint, use a página de Status do Fluxo de Trabalho e verifique a mensagem de erro para obter o ID.
5. Use a central de administração do Microsoft 365 para recuperar logs de um usuário específico
   Vá para Central de administração do Microsoft 365 > Saúde > Integridade do serviço. Selecione o serviço SharePoint Online. Em Problemas recentes, encontre o incidente que corresponde ao seu erro. Abra o incidente e procure por IDs de correlação que a Microsoft já coletou. Você também pode usar a Central de Mensagens para encontrar IDs vinculados a problemas conhecidos.
6. Envie o ID de correlação em sua solicitação de suporte
   Ao criar um tíquete de suporte na central de administração do Microsoft 365, inclua o ID de correlação no campo de descrição. Forneça também a data e hora exatas (incluindo fuso horário) em que o erro ocorreu, a URL do site afetado e a conta de usuário que encontrou o erro. Essa combinação permite que o engenheiro de suporte encontre os logs imediatamente.

Se a equipe de suporte precisar de mais informações

Às vezes, um único ID de correlação não é suficiente. O suporte da Microsoft pode solicitar vários IDs da mesma sessão de usuário ou de um intervalo de tempo específico. Isso é comum quando o erro é causado por uma condição de corrida ou uma degradação transitória do serviço. Nesse caso, colete IDs de várias tentativas com falha e forneça a lista completa.

O SharePoint falha, mas nenhum ID de correlação aparece

Se a página de erro não mostrar um ID de correlação, a falha provavelmente ocorreu antes que o SharePoint pudesse gerar um. Isso pode acontecer quando o navegador não consegue alcançar o servidor ou quando um proxy ou firewall bloqueia a solicitação. Verifique o console do navegador em busca de erros de rede e confirme se a URL do site está correta. Se o problema estiver no lado do cliente, a equipe de suporte não poderá usar um ID de correlação.

O ID de correlação aponta para um problema conhecido

Depois de enviar o ID, o suporte da Microsoft pode informar que o erro corresponde a um incidente de serviço conhecido. Nesse caso, eles fornecerão um aviso de integridade do serviço com um tempo estimado de resolução. Você não precisa realizar nenhuma solução de problemas adicional. O ID de correlação permitiu que eles associassem seu problema ao incidente existente sem mais investigação.

O ID de correlação expira ou não é encontrado

O SharePoint Online retém logs de diagnóstico por um período limitado, geralmente de 14 a 30 dias. Se você tentar usar um ID de correlação de um erro ocorrido há mais de 30 dias, os logs podem ter sido removidos. Sempre capture o ID assim que o erro acontecer. Para investigações de longo prazo, ative o log detalhado e exporte os logs para o Azure Log Analytics para retenção mais longa.

Métodos para capturar IDs de correlação: Navegador vs PowerShell vs Central de Administração

Método	Quando usar	Prós	Contras
Página de erro do navegador	O usuário vê um erro visível	Nenhuma ferramenta necessária, captura imediata	Funciona apenas para erros de página inteira, não para falhas parciais
Ferramentas do Desenvolvedor F12	Falhas intermitentes ou silenciosas	Captura IDs para qualquer erro HTTP	Requer habilidade técnica para interpretar cabeçalhos
Logs de diagnóstico da central de administração do SharePoint	Monitoramento proativo de operações do site	Captura IDs para todos os usuários e operações	O log detalhado pode encher o armazenamento rapidamente
PowerShell (Get-SPLogEvent)	Recuperação em massa de logs para administradores de locatário	Automatiza a coleta de vários IDs	Requer o SharePoint Online Management Shell e direitos de administrador

Com um ID de correlação em mãos, você pode reduzir o tempo que o suporte da Microsoft gasta localizando seus logs de erro. A melhor abordagem é capturar o ID imediatamente após o erro ocorrer, ativar o log detalhado apenas durante a solução de problemas ativa e sempre incluir o ID junto com o carimbo de data/hora exato e o contexto do usuário. Essa prática transforma um relatório de erro vago em uma ferramenta de diagnóstico precisa para você e para a equipe de suporte.