ID de correlação do SharePoint em mensagens de erro: o que é e como usá-la
Aplica-se aSharePoint Server 2016 SharePoint no Microsoft 365

Se você for um usuário com problemas em um site público ou pesquisa, email ou outro aplicativo, ligue para a empresa proprietária do site e solicite ajuda.   Geralmente, você pode encontrar informações de contato de um site ou pesquisa na parte inferior de uma página ou nas seções Sobre ou Contate-nos dos menus de navegação.

Se você for um usuário de negócios e estiver recebendo erros, entre em contato com a pessoa que gerencia o site interno da sua empresa.   Esses tipos de problemas geralmente só podem ser corrigidos pelo webmaster (administração do Microsoft Office SharePoint Online) ou por alguém da sua empresa.

Se você for administrador, webmaster ou gerente de site do Microsoft Office SharePoint Online,   este artigo poderá ajudar se seus usuários estiverem fazendo perguntas sobre IDs de correlação.

O que é e o que não é uma ID de correlação

A ID de correlação não é um número ou código de erro. Basicamente, é um GUID (identificador global exclusivo) gerado automaticamente para cada solicitação recebida pelo servidor Microsoft Office SharePoint Online. É exclusivo para cada solicitação, não para cada erro. No entanto, quando ocorre um erro, a mensagem de erro contém a ID de correlação que era válida para a solicitação no momento.

A ID de correlação é destinada a ajudar um administrador do Microsoft Office SharePoint Online a rastrear o que estava acontecendo no momento de um erro. Ela só é útil como ferramenta interativa para ajudar o administrador a localizar o erro. Um administrador usa a ID de correlação como "trilhas" para refazer o caminho de solicitações ou processos no Microsoft Office SharePoint OnlineSistema de Log Unificado (ULS) e descobrir o que leva a um problema e o que o causa. Se Microsoft Office SharePoint Online encontrar um erro que não consegue identificar ao trabalhar nessa tarefa, ele exibirá a mensagem "Ocorreu um erro inesperado" e incluirá a ID de correlação. A ID de correlação pode ajudar a descobrir o que ocorreu, mas não identifica o que ocorreu.

Diagrama de como uma ID de correlação é atribuída

Solicitações bem-sucedidas são marcadas com uma ID de correlação, assim como as que falharam. A ID é exclusiva e diferente para cada nova solicitação e só dura enquanto a solicitação estiver ativa. Não é como um erro do Windows, que fornece um número 80xxxxxx que identifica o problema exato. Não adianta pesquisar uma ID de correlação específica na web, pois cada uma é diferente e exclusiva para o seu servidor e aquele momento.

Onde uma ID de correlação é valiosa é no rastreamento de um processo. Microsoft Office SharePoint Online cria um log (ULS) de tudo o que faz ao processar solicitações, e a ID de correlação é basicamente o thread que conecta cada etapa. Como Microsoft Office SharePoint Online faz milhares de solicitações ao mesmo tempo, a ID de correlação pode ser usada para filtrar apenas as etapas que Microsoft Office SharePoint Online estava realizando para qualquer solicitação.

Para o Administrador, uma ID de correlação pode ser usada para rastrear erros, bem como problemas de desempenho e outros problemas. Usando as IDs de correlação para solicitações que estão apresentando o comportamento problemático, é possível investigar mais a fundo.  Se não houver falha e nenhuma mensagem de erro for gerada, o painel do desenvolvedor poderá ser usado para exibir a ID de correlação gerada pelos processos. 

Se você for um usuário final, provavelmente não terá acesso aos logs que fornecem as informações em que uma ID de correlação pode ser útil. Nesse caso, você pode parar aqui e ligar para o suporte técnico ou para a Administração. Explique o problema e trabalhe com eles para ajudar a diagnosticá-lo. Forneça a eles a ID de correlação exibida na mensagem de erro, que pode ser necessária.

Como Profissional de TI ou Administrador, para descobrir o que aconteceu, você precisa encontrar os logs do ULS da hora em que o evento ocorreu e pesquisar a ID de Correlação nesses logs. Pode ser necessário pesquisar em vários front-ends da Web para encontrar um que inclua a ID de correlação que você procura. A ID de correlação não resolverá seu erro, mas pode ajudar a rastrear uma solicitação para talvez ver o que deu errado. Talvez você obtenha informações sobre o que aconteceu imediatamente antes de o erro ser gerado, quais mensagens de erro foram exibidas ou quais eventos foram disparados devido a esse erro (se houver). Você pode usar uma ferramenta como ULSViewer para facilitar a visualização desses dados e filtrar as solicitações que não precisam ser exibidas. Consulte a postagem no blog Log e solução de problemas do SharePoint usando o ULSViewer para obter mais ideias e dicas.

Veja um cenário típico que um Administrador usará ao usar uma ID de correlação:

  • O usuário recebe um erro ao abrir um arquivo no Excel, que fornece ao Administrador a ID de correlação e a data/hora do incidente:

  • Encontre o diretório do log e a data que você está procurando, e abra o arquivo no Excel:

  • Localize a ID de correlação que está procurando. Você também pode filtrar pelo nível dos eventos para ter uma ideia do que está acontecendo:

  • Se você não encontrar a ID de correlação, experimente outro servidor web que estava em rotação no momento do problema relatado.

Aqui estão mais alguns recursos de Administração para ajudar na depuração de erros do Microsoft Office SharePoint Online. Além desses links, experimente pesquisar na web, pois há muitos sites de terceiros e comunidades que oferecem suporte e ferramentas para trabalhar com Microsoft Office SharePoint Online. Como o Microsoft Office SharePoint Online é uma plataforma, há uma comunidade de milhares de desenvolvedores, Profissionais de TI e usuários desenvolvendo ferramentas, aplicativos e documentação para ajudar uns aos outros.

Precisa de mais ajuda?

Quer mais opções

Explore os benefícios da assinatura, procure cursos de treinamento, saiba como proteger seu dispositivo e muito mais.