Coletar Detalhes de Erro do SharePoint Antes de Escalar: Checklist Prático para Proprietários

Quando ocorre um erro no SharePoint, sua primeira reação pode ser contatar o Suporte Microsoft imediatamente. Sem as informações certas, os engenheiros de suporte não conseguem diagnosticar o problema rapidamente, e você enfrentará pedidos repetidos de logs e capturas de tela. Este artigo explica exatamente quais dados você precisa coletar antes de abrir um ticket de suporte. Seguir este checklist ajuda a resolver o problema mais rápido e reduz a troca de mensagens com a equipe de suporte.

Por Que Coletar Detalhes do Erro Antes de Escalar é Importante

O Suporte Microsoft usa pontos de dados específicos para identificar a causa raiz de erros do SharePoint. Sem esses detalhes, o engenheiro de suporte precisa pedir as mesmas informações repetidamente, o que atrasa a resolução. As peças mais comuns que faltam são o ID de correlação, a mensagem de erro exata e as etapas que acionaram o erro. Coletar esses dados por conta própria garante que a equipe de suporte possa começar a trabalhar no seu caso imediatamente.

O SharePoint Online e o SharePoint Server geram diferentes tipos de logs. Para o SharePoint Online, você depende de ferramentas do navegador e da central de administração do SharePoint. Para o SharePoint Server local, você acessa logs ULS e o Visualizador de Eventos. Este guia cobre ambos os ambientes.

O Que é um ID de Correlação

Um ID de correlação é um identificador único que o SharePoint atribui a cada solicitação. Quando ocorre um erro, o ID de correlação aparece na página de erro ou no console do navegador. Esse ID permite que os engenheiros de suporte rastreiem a solicitação pelos servidores SharePoint e localizem a entrada de log exata que causou a falha. Sem o ID de correlação, encontrar a entrada de log relevante é quase impossível.

Checklist: Dados a Coletar Antes de Abrir um Ticket de Suporte

Passo 1: Capture a Mensagem de Erro Exata e uma Captura de Tela

1. Copie o texto do erro
   Selecione a mensagem de erro completa exibida na tela. Se o erro estiver em uma caixa de diálogo, pressione Ctrl+C para copiar o texto. Cole em um arquivo de texto.
2. Tire uma captura de tela
   Pressione Windows+Shift+S para abrir a Ferramenta de Captura. Capture a janela inteira do navegador, incluindo a barra de endereços e quaisquer detalhes do erro. Salve a imagem como PNG.
3. Registre a URL
   Copie a URL completa da barra de endereços do navegador. Inclua quaisquer parâmetros de consulta. Essa URL informa ao suporte qual site e página causaram o erro.

Passo 2: Localize o ID de Correlação

1. Verifique a página de erro
   Muitas páginas de erro do SharePoint exibem o ID de correlação na parte inferior. Procure uma linha que diga “Correlation ID: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx”. Copie esse GUID.
2. Use as Ferramentas do Desenvolvedor do navegador
   Abra as Ferramentas do Desenvolvedor pressionando F12. Vá para a guia Rede. Atualize a página e reproduza o erro. Encontre a solicitação com falha (status 4xx ou 5xx). Clique na solicitação e procure pelo cabeçalho x-ms-correlation-id na seção Cabeçalhos de Resposta.
3. Copie o ID de correlação
   Clique com o botão direito no valor do cabeçalho e selecione Copiar valor. Cole no seu arquivo de texto junto com a mensagem de erro.

Passo 3: Colete Detalhes da Solicitação e Resposta HTTP

1. Abra a guia Rede
   Pressione F12 e clique na guia Rede. Certifique-se de que a gravação está ativada (ícone de círculo vermelho).
2. Reproduza o erro
   Execute exatamente a ação que causou o erro. A guia Rede listará todas as solicitações.
3. Exporte o arquivo HAR
   Clique com o botão direito em qualquer solicitação e selecione Salvar tudo como HAR com conteúdo. Salve o arquivo .har na sua área de trabalho. Esse arquivo contém todos os cabeçalhos de solicitação e resposta, cookies e carimbos de data/hora.

Passo 4: Reúna Informações do Site e do Locatário

1. Abra a central de administração do SharePoint
   Vá para https://admin.microsoft.com e navegue até a central de administração do SharePoint. Selecione Sites ativos.
2. Encontre o site afetado
   Pesquise pela URL do site que você registrou. Clique no nome do site para abrir o painel de detalhes.
3. Copie os detalhes do site
   Anote o ID do Site, Modelo, Armazenamento usado e Cota de armazenamento. Verifique também as configurações de Compartilhamento e quaisquer políticas aplicadas.
4. Verifique a saúde do locatário
   Na central de administração do SharePoint, vá para Saúde > Saúde do serviço. Verifique se nenhum incidente ativo afeta o SharePoint.

Passo 5: Colete Logs ULS (Apenas SharePoint Server)

1. Abra o ULS Viewer
   No servidor SharePoint, execute UlsViewer.exe a partir do diretório raiz do SharePoint (geralmente C:\Program Files\Common Files\Microsoft Shared\Web Server Extensions\16\BIN).
2. Defina um filtro
   No ULS Viewer, vá em Edit > Filter. Insira o ID de correlação que você coletou. Isso filtra os logs para mostrar apenas entradas relacionadas ao erro.
3. Exporte os logs
   Selecione todas as entradas filtradas. Pressione Ctrl+C para copiá-las. Cole em um arquivo de texto e salve como ULS_Logs.txt.

Passo 6: Verifique o Visualizador de Eventos (Apenas SharePoint Server)

1. Abra o Visualizador de Eventos
   Pressione Windows+R, digite eventvwr.msc e pressione Enter.
2. Navegue até o log Aplicativo
   Expanda Logs do Windows e selecione Aplicativo. Procure eventos com Origem contendo “SharePoint” ou “Windows SharePoint Services”.
3. Filtre por hora
   No painel Ações, clique em Filtrar Log Atual. Defina o intervalo de tempo para corresponder ao momento em que o erro ocorreu. Copie quaisquer eventos com Nível Erro ou Aviso.

Passo 7: Reproduza o Erro Passo a Passo

1. Anote as etapas exatas
   Liste cada clique e tecla pressionada desde o momento em que você abriu o navegador até o erro aparecer. Inclua o tipo e a versão do navegador.
2. Teste com outro navegador
   Tente reproduzir o erro em um navegador diferente. Registre se o erro persiste. Isso ajuda a identificar problemas específicos do navegador.
3. Teste com um usuário diferente
   Peça a um colega com as mesmas permissões para reproduzir o erro. Observe se o erro ocorre também para ele.

Se o SharePoint Ainda Tiver Problemas Após Coletar os Dados

A Mensagem de Erro Não Inclui um ID de Correlação

Alguns erros do SharePoint, especialmente os de código personalizado ou complementos de terceiros, podem não exibir um ID de correlação. Nesse caso, abra as Ferramentas do Desenvolvedor do navegador, vá para a guia Console e procure por erros JavaScript. Copie o rastreamento de pilha completo. Verifique também a guia Rede em busca de solicitações com falha e anote a URL da solicitação.

A Exportação do Arquivo HAR Falha

Se a guia Rede não permitir salvar um arquivo HAR, tire uma captura de tela da guia Rede mostrando a solicitação com falha. Expanda os cabeçalhos da solicitação e da resposta para que a equipe de suporte possa ver o código de status e o ID de correlação. Como alternativa, use o Fiddler ou outro proxy de depuração HTTP para capturar o tráfego.

Os Logs ULS Estão Vazios para o ID de Correlação

Se a filtragem dos logs ULS pelo ID de correlação não retornar resultados, o erro pode ter ocorrido em um servidor diferente no farm. Repita o erro várias vezes e verifique os logs ULS em cada servidor SharePoint. Verifique também se o nível de log ULS está definido como Detalhado para a categoria afetada. Você pode ajustar os níveis de log em Administração Central > Monitoramento > Configurar log de diagnóstico.

Item	SharePoint Online	SharePoint Server
Localização do ID de correlação	Página de erro ou cabeçalhos da guia Rede	Página de erro, logs ULS ou Visualizador de Eventos
Formato do arquivo de log	Arquivo HAR do navegador	Logs ULS (.txt) e Visualizador de Eventos (.evtx)
Fonte de informações do site	Central de administração do SharePoint	Administração Central ou PowerShell
Conta de usuário necessária	Administrador global ou administrador do SharePoint	Administrador do farm ou administrador local do servidor
Tipos de erro típicos	403, 404, 500, limitação	Conexão de banco de dados, trabalho do timer, configuração

Depois de coletar todos os itens deste checklist, abra um ticket de suporte na central de administração do Microsoft 365. Anexe o arquivo de texto com a mensagem de erro e o ID de correlação, a captura de tela, o arquivo HAR e os detalhes do site. Inclua as notas de reprodução passo a passo na descrição do ticket. Esse pacote completo permite que o engenheiro de suporte comece a solucionar problemas imediatamente, sem solicitar informações adicionais.

Para erros frequentes, considere configurar alertas do SharePoint para notificá-lo quando eventos de erro específicos ocorrerem. Você também pode usar scripts do PowerShell para automatizar a coleta de logs ULS e detalhes do site. Quanto menos tempo você gastar coletando dados manualmente, mais rápido poderá resolver problemas e restaurar a produtividade dos seus usuários.