ID de correlação do SharePoint em mensagens de erro: o que é e como usá-la

ID de correlação do SharePoint em mensagens de erro: o que é e como usá-la

Observação: Desejamos fornecer o conteúdo da Ajuda mais recente no seu idioma da forma mais rápida possível. Esta página foi traduzida de forma automatizada e pode conter imprecisões ou erros gramaticais. Nosso objetivo é que este conteúdo seja útil para você. As informações foram úteis? Dê sua opinião no final desta página. Aqui está o artigo em inglês para facilitar a referência.

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

Se você for um usuário de uma empresa e estiver recebendo erros, contate a pessoa que gerencia o site interno da sua empresa.    Esses tipos de problemas geralmente só podem ser corrigidos pelo webmaster (SharePoint admin) ou por alguém em sua empresa.

Se você for um administrador do SharePoint, webmaster ou gerente de site   e seus usuários estiverem fazendo perguntas sobre IDs de correlação, este artigo poderá ajudá-lo.

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

A ID de correlação não é um número de erro ou código. Simplesmente, é um GUID (identificador global exclusivo) gerado automaticamente para cada solicitação que o servidor SharePoint recebe. É exclusivo de cada solicitação, não 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 deve ser usada para ajudar um administrador de SharePoint a rastrear o que estava acontecendo no momento de um erro. É apenas útil como uma ferramenta interativa para ajudar o administrador a rastrear seu erro. Um administrador usa a ID de correlação como "trilhas" para refazer o rastreamento de solicitações ou processos no sistema de registro unificado do SharePoint(ULS) para encontrar o que leva para cima e causar um problema. Se o SharePoint receber um erro que não pode ser identificado enquanto estiver trabalhando nessa tarefa, ele lança uma mensagem "ocorreu um erro inesperado" e inclui a ID de correlação. A ID de correlação pode ajudar a descobrir o que aconteceu, mas não identifica o que aconteceu.

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

Solicitações bem-sucedidas são marcadas com uma ID de correlação, bem como aquelas com falhas. A ID é exclusiva e diferente para cada nova solicitação e dura apenas a duração da solicitação. Não é como um erro do Windows que fornece um número 80xxxxxx que identifica o problema exato. Ele não ajuda a pesquisar uma ID de correlação específica na Web, uma vez que cada uma é diferente e exclusiva do seu servidor e esse point-in-time.

Onde uma ID de correlação é valiosa é o rastreamento por meio de um processo. o SharePoint cria um log (ULS) de tudo o que ele faz ao processar solicitações, e a ID de correlação é basicamente o thread que une cada etapa juntos. Como o SharePoint faz milhares de solicitações ao mesmo tempo, a ID de correlação pode ser usada para filtrar apenas as etapas que SharePoint estava fazendo para qualquer solicitação específica.

Para o administrador, uma ID de correlação pode ser usada para rastrear erros, bem como problemas de desempenho e outros problemas. Ao usar as IDs de correlação para solicitações que estão apresentando o comportamento problemático, elas podem investigar mais detalhadamente.  Se nenhuma falha estiver acontecendo e nenhuma mensagem de erro estiver sendo gerada, o painel de 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 a assistência técnica ou administrador. Explique o problema e trabalhe com eles para ajudar a diagnosticar o problema. Dê a elas a ID de correlação que você vê na sua mensagem de erro, elas podem precisar.

Como um profissional ou administrador de ti, para descobrir o que aconteceu, você precisa encontrar os logs ULS durante o tempo em que o evento ocorreu e pesquisar a ID de correlação nesses logs. Talvez seja necessário examinar vários dos front-ends da Web para encontrar aquele que tenha a ID de correlação que você está procurando. A ID de correlação não soluciona seu erro, mas pode ajudar você a rastrear uma solicitação para poder ver o que deu errado. Você pode ter uma visão geral do que aconteceu antes de o erro ter sido gerado, quais mensagens de erro apareciam ou quais eventos foram acionados devido a esse erro (se houver). Você pode usar uma ferramenta como ULSViewer para facilitar a pesquisa desses dados e filtrar as solicitações que você não precisa ver. Consulte o log e a solução de problemas do SharePoint usando a postagem de blog do ULSViewer para obter mais ideias e dicas.

Aqui está 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 data/hora do incidente:

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

  • Encontre a ID de correlação que você está procurando. Você pode filtrar pelo nível dos eventos, além de 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 alguns recursos de administração para ajudar na depuração de erros de SharePoint. Além desses links, tente pesquisar na Web, pois há vários sites de terceiros e comunidades que oferecem suporte e ferramentas para trabalhar com o SharePoint. Como o SharePoint é uma plataforma, há uma comunidade de milhares de desenvolvedores, profissionais de ti e usuários que estão desenvolvendo ferramentas, aplicativos e documentação para ajudar uns aos outros.

Expanda suas habilidades no Office
Explore o treinamento
Obtenha novos recursos primeiro
Ingressar no Office Insider

Essas informações foram úteis?

Obrigado por seus comentários!

Agradecemos pelos seus comentários! Parece que pode ser útil conectar você a um de nossos agentes de suporte do Office.

×