Como Coletar Detalhes de Erro do SharePoint Antes de Escalar

Quando um site ou recurso do SharePoint para de funcionar, você precisa de detalhes específicos do erro antes de contatar o suporte. Mensagens genéricas como “Algo deu errado” não ajudam os engenheiros de suporte da Microsoft a diagnosticar o problema. Este artigo explica exatamente quais logs, capturas de tela e dados de configuração coletar antes de abrir um ticket de suporte. Você aprenderá a reunir detalhes de erro do SharePoint pelo navegador, PowerShell e centro de administração do SharePoint.

Por que as Mensagens de Erro do SharePoint Geralmente São Inúteis

O SharePoint exibe páginas de erro genéricas para usuários finais para evitar expor informações sensíveis do servidor. Uma página de erro típica mostra “Ocorreu um erro inesperado” ou “Desculpe, algo deu errado.” Essas mensagens não contêm os detalhes técnicos que os engenheiros de suporte precisam. Por trás da página genérica, o SharePoint gera logs com IDs de correlação, rastreamentos de pilha e códigos de status HTTP. As equipes de suporte usam esses logs para rastrear a requisição exata que falhou. Sem esses detalhes, a escalada leva mais tempo porque o suporte precisa pedir as mesmas informações repetidamente.

O Papel do ID de Correlação

Cada requisição ao SharePoint gera um ID de correlação único. Esse GUID vincula o erro aos logs do servidor. Quando você fornece o ID de correlação, o suporte pode localizar a entrada de log exata para sua sessão. Sem ele, o suporte precisa pesquisar nos logs por intervalo de tempo, o que é menos preciso e mais lento.

Códigos de Status HTTP e Seus Significados

Os erros do SharePoint retornam códigos de status HTTP padrão. Um código 403 significa que o usuário não tem permissão. Um código 404 significa que a página ou arquivo não existe. Um código 500 indica um erro no servidor. Capturar esses códigos ajuda o suporte a categorizar o problema imediatamente.

Passos para Coletar Detalhes de Erro do SharePoint pelo Navegador

1. Abra as Ferramentas do Desenvolvedor do Navegador
   Pressione F12 no Chrome, Edge ou Firefox. Mude para a aba Network antes de reproduzir o erro.
2. Reproduza o Erro
   Execute a ação que dispara o erro. Por exemplo, abra uma biblioteca de documentos ou clique em um link do SharePoint que falha.
3. Localize a Requisição com Falha
   Na aba Network, procure a requisição que retornou um código de status vermelho ou 4xx/5xx. Clique nessa requisição para ver os detalhes.
4. Copie o ID de Correlação
   Na aba Headers, encontre o cabeçalho SPRequestGuid ou X-SharePointHealthScore. O ID de correlação parece uma string hexadecimal de 32 caracteres: a1b2c3d4-e5f6-7890-abcd-ef1234567890.
5. Copie o Corpo da Resposta
   Mude para a aba Response. Copie o texto completo do erro, incluindo qualquer rastreamento de pilha ou mensagem de exceção.
6. Tire uma Captura de Tela da Aba Network
   Capture a aba Network inteira mostrando a requisição com falha e seus cabeçalhos. Inclua a barra de URL para que o suporte veja o endereço exato do site.

Passos para Coletar Detalhes de Erro do SharePoint Usando PowerShell

Para SharePoint Online, use o SharePoint Online Management Shell. Para SharePoint Server, use o SharePoint Management Shell. O PowerShell fornece acesso a logs que o navegador não pode mostrar.

Conectar ao SharePoint Online

1. Instale o Módulo
   Execute Install-Module -Name Microsoft.Online.SharePoint.PowerShell como administrador.
2. Conecte-se ao Serviço
   Execute Connect-SPOService -Url https://yourtenant-admin.sharepoint.com e faça login com uma conta de administrador global.
3. Obtenha Logs do Conjunto de Sites
   Execute Get-SPOSite -Identity https://yourtenant.sharepoint.com/sites/siteurl | Select-Object para recuperar propriedades do site. Procure pelos campos StorageUsageCurrent, LastContentModifiedDate e SharingCapability.
4. Verifique a Saúde do Conjunto de Sites
   Execute Get-SPOSiteHealth -Identity https://yourtenant.sharepoint.com/sites/siteurl para ver avisos ou erros de saúde.

Conectar ao SharePoint Server

1. Abra o SharePoint Management Shell
   Clique com o botão direito e execute como administrador no servidor SharePoint.
2. Obtenha Logs ULS
   Execute Get-SPLogEvent -StartTime (Get-Date).AddMinutes(-30) -EndTime (Get-Date) | Where-Object {$_.Level -eq "Error" -or $_.Level -eq "Critical"} | Export-Csv C:\temp\uls_errors.csv para exportar erros recentes.
3. Verifique o Status do Timer Job
   Execute Get-SPTimerJob | Where-Object {$_.Status -eq "Failed"} para identificar jobs de timer com falha que podem causar erros no site.

Passos para Coletar Detalhes de Erro do SharePoint pelo Centro de Administração

1. Abra o Centro de Administração do SharePoint
   Vá para https://admin.microsoft.com e navegue até o centro de administração do SharePoint ou Centros de administração > SharePoint.
2. Verifique a Integridade do Serviço
   Clique em Saúde > Integridade do Serviço. Procure por incidentes ou avisos ativos para SharePoint Online. Se um incidente estiver ativo, o erro provavelmente é causado por um problema de serviço, não pela sua configuração.
3. Revise os Relatórios do Conjunto de Sites
   No centro de administração, vá para Relatórios > Uso. Exporte o relatório de uso do site para o site afetado. Esse relatório mostra armazenamento, tráfego e atividade de compartilhamento que podem se correlacionar com o erro.
4. Verifique as Configurações de Compartilhamento e Permissão
   Vá para Políticas > Compartilhamento. Anote se o compartilhamento externo está habilitado ou restrito. Erros de permissão geralmente decorrem de políticas de compartilhamento que bloqueiam o acesso de convidados.

Se o SharePoint Ainda Mostrar Mensagens de Erro Vagas Após a Coleta

Erro do SharePoint Não Inclui um ID de Correlação

Alguns sites personalizados ou de terceiros suprimem o ID de correlação. Nesse caso, use a aba Network das Ferramentas do Desenvolvedor do navegador conforme descrito acima para capturar os cabeçalhos da requisição. O ID de correlação sempre aparece nos cabeçalhos de resposta, mesmo que a página o oculte.

Conexão PowerShell Falha

Se o SharePoint Online Management Shell não conseguir conectar, verifique se sua conta tem a função de administrador global ou administrador do SharePoint. Verifique também se a URL do locatário está correta e se você não está atrás de um proxy que bloqueia a conexão. Use Set-ExecutionPolicy RemoteSigned se a execução do script estiver bloqueada.

Logs ULS São Muito Grandes para Pesquisar

No SharePoint Server, os logs ULS podem crescer para vários gigabytes. Reduza a janela de tempo para 15 minutos antes e depois do erro. Use o cmdlet Get-SPLogEvent com horários de início e fim precisos para reduzir o conjunto de resultados.

Ferramentas do Desenvolvedor do Navegador vs PowerShell: O Que Cada Um Fornece

Item	Ferramentas do Desenvolvedor do Navegador	PowerShell
ID de Correlação	Sim, nos cabeçalhos de resposta	Não, não disponível diretamente
Código de status HTTP	Sim, visível na aba Network	Não
Corpo da resposta com rastreamento de pilha	Sim, na aba Response	Não
Propriedades do conjunto de sites	Não	Sim, via Get-SPOSite
Logs ULS (on-premises)	Não	Sim, via Get-SPLogEvent
Status de integridade do serviço	Não	Não, use o centro de administração

Conclusão

Agora você pode coletar detalhes de erro do SharePoint usando as Ferramentas do Desenvolvedor do navegador, PowerShell e o centro de administração do SharePoint. Sempre comece com a aba Network para capturar o ID de correlação e o código de status HTTP. Use o PowerShell para recuperar a saúde do site e logs ULS para ambientes locais. Antes de escalar, exporte o status de integridade do serviço do centro de administração para descartar um incidente de serviço da Microsoft. Esses dados reduzem a troca de mensagens com o suporte e aceleram a resolução do seu problema no SharePoint.