Visão geral do log de diagnóstico nos Serviços Corporativos de Conectividade (SharePoint Foundation 2010)

Artigo
02/18/2017

Aplica-se a: SharePoint Foundation 2010

Tópico modificado em: 2016-11-30

Você pode solucionar problemas relacionados ao Microsoft Serviços Corporativos de Conectividade em servidores que estão executando o Microsoft SharePoint Foundation 2010 usando logs de eventos e de rastreamento no cliente ou servidor. Além disso, cada entrada no log de eventos ou de rastreamento tem uma ID de Atividade associada que pode ser usada para acompanhar um problema desde o servidor até a fonte de dados externa.

Observação

Além dos métodos de log abordados neste tópico, você pode usar o Pacote de Gerenciamento do Microsoft System Center Operations Manager para monitorar uma solução com base nos Microsoft Serviços Corporativos de Conectividade. Para obter mais informações sobre como configurar o Pacote de Gerenciamento do System Center Operations Manager, consulte o guia incluído no download do pacote de gerenciamento no artigo sobre pacote de gerenciamento dos Produtos do Microsoft SharePoint 2010 (https://go.microsoft.com/fwlink/?linkid=184971&clcid=0x416).

Neste artigo:

Logs de diagnóstico nos Serviços Corporativos de Conectividade
Sobre IDs de Atividade
Logs de diagnóstico em servidores
Exemplo: usando logs de diagnóstico

Logs de diagnóstico nos Serviços Corporativos de Conectividade

Para soluções que são baseadas nos Microsoft Serviços Corporativos de Conectividade, o log de diagnóstico ocorre em servidores que estão executando o Microsoft SharePoint Foundation. Há dois logs: o de eventos e o de rastreamento. Ambos registram informações de diagnóstico geradas pelos Microsoft Serviços Corporativos de Conectividade. Os logs de eventos registram mensagens de erro. Os logs de rastreamento contêm informações mais aprofundadas, como rastreamentos de pilha e mensagens informativas. Em geral, os logs de rastreamento fornecem mais detalhes do que os de eventos.

Cada informação registrada inclui uma ID de Atividade, que é um valor de GUID exclusivo. Os valores de ID de Atividade também podem ser enviados a sistemas externos quando uma operação de Criação, Atualização ou Exclusão ocorre em um item. Com o uso de IDs de Atividade, uma ação pode ser rastreada desde o servidor ou cliente até a fonte de dados externa. Para obter mais informações sobre IDs de Atividade, consulte Sobre IDs de Atividade.

Você pode definir o nível de log de diagnóstico para os logs de eventos e de rastreamento. Isso limitará os tipos e a quantidade de informações gravadas em cada log. As tabelas a seguir definem os níveis de log disponíveis para os log de eventos e de rastreamento:

Níveis do log de eventos

Nível	Definição
Nenhum	Não ocorre registro em log.
Crítico	Esse tipo de mensagem indica um erro sério que causou falha grave na solução.
Erro	Esse tipo de mensagem indica uma condição urgente. Todos os eventos de erro devem ser investigados.
Aviso	Esse tipo de mensagem indica um problema em potencial ou que pode exigir atenção. As mensagens de aviso devem ser examinadas e acompanhadas para a detecção de padrões ao longo do tempo.
Informações	As mensagens de informações não exigem ação alguma, mas podem fornecer dados valiosos para o monitoramento do estado de sua solução.
Detalhado	Esse nível de log de eventos corresponde a mensagens ou eventos longos.

Níveis de log de rastreamento

Nível	Definição
Nenhum	Nenhum log de rastreamento é gravado.
Inesperado	Esse nível é usado para registrar mensagens sobre eventos que interrompem o processamento de soluções. Quando é definido com esse nível, o log inclui apenas os eventos desse nível.
Monitorável	Esse nível é usado para registrar mensagens sobre eventos irrecuperáveis que limitam a funcionalidade da solução, mas não interrompem o aplicativo. Quando é definido com esse nível, o log também inclui erros críticos (nível Inesperado).
Alto	Esse nível é usado para registrar eventos que são inesperados, mas que não paralisam o processamento de uma solução. Quando é definido com esse nível, o log inclui avisos, erros (nível Monitorável) e erros críticos (nível Inesperado).
Médio	Quando é definido com esse nível, o log de rastreamento inclui tudo, exceto mensagens Detalhadas. Esse nível é usado para registrar todas as informações de alto nível sobre operações que foram executadas. Nesse nível, são registrados detalhes suficientes para construir o fluxo de dados e a sequência de operações. Esse nível de log pode ser usado por administradores ou analistas de suporte para solução de problemas.
Detalhado	Quando é definido com esse nível, o log inclui mensagens de todos os outros níveis. Quase todas as ações executadas são registradas quando você usa esse nível. O rastreamento detalhado produz muitas mensagens de log. Esse nível geralmente é usado apenas para depuração em um ambiente de desenvolvimento.

Os logs de diagnóstico são úteis em ambientes de desenvolvimento e de produção, mas os requisitos para o nível de log provavelmente são diferentes, dependendo do tipo de ambiente. Ao planejar logs de diagnóstico nos Microsoft Serviços Corporativos de Conectividade, considere as necessidades comerciais e o estágio do ciclo de vida do ambiente antes de definir o nível de log.

Por exemplo, durante o design de soluções, para fins de depuração, é possível definir ambos os níveis de log como Detalhado para capturar todas as mensagens geradas sobre o estado do sistema. Por outro lado, em um ambiente de produção, convém capturar apenas mensagens das categorias Alto, Monitorável e Inesperado para logs de rastreamento e das categorias Crítico e Erro para logs de eventos. Isso poupa espaço em disco para logs e limita os efeitos negativos sobre o desempenho causados pelos logs.

Sobre IDs de Atividade

Um valor de GUID exclusivo, denominado ID de Atividade, é gerado para cada operação de Criação, Atualização ou Exclusão em dados externos em uma solução baseada nos Microsoft Serviços Corporativos de Conectividade. Qualquer item relacionado à operação que é registrado no log de rastreamento ou de eventos inclui seu valor de ID de Atividade.

Importante

Nos arquivos de logs de eventos e de rastreamento no servidor, valores de ID de Atividade são rotulados como “CorrelationId”.

O valor de ID de Atividade gerado para uma operação de Criação, Atualização ou Exclusão é enviado ao sistema externo, juntamente com outras informações relacionadas à operação. Se o sistema externo tiver um mecanismo de log, esse valor poderá ser capturado e registrado no sistema. Portanto, se uma operação gerar entradas nos logs do SharePoint, a mesma operação poderá ser rastreada para o sistema externo com o uso de seu valor de ID de Atividade. Isso possibilita a solução de problemas de ponta a ponta.

Frequentemente, uma operação como Criar faz com que vários eventos sejam gravados nos logs. Quando isso ocorre, o mesmo valor de ID de Atividade é usado para todos os eventos registrados para a operação. Isso é útil para solução de problemas, porque com o valor recorrente de ID de Atividade é possível localizar todos os eventos de uma operação específica. Por outro lado, quando o mesmo tipo de operação ocorre repetidamente, um valor exclusivo de ID de Atividade é gerado para cada instância da operação. Por exemplo, se um item de um tipo de conteúdo externo for atualizado duas vezes, cada operação de atualização será associada a um valor exclusivo de ID de Atividade.

Dica

Em certas circunstâncias, o Serviço de Conectividade de Dados Corporativos tentará executar uma operação novamente se ela não tiver passado para o sistema externo. Nesse caso, a mesma ID de Atividade será usada para a operação tentada novamente.

Logs de diagnóstico em servidores

Por padrão, os logs dos Microsoft Serviços Corporativos de Conectividade são habilitados nos servidores do SharePoint Foundation. Os níveis de log padrão são:

Para o log de eventos: Crítico e Erro
Para o log de rastreamento: Médio

Se os logs de diagnóstico dos Microsoft Serviços Corporativos de Conectividade forem desabilitados, habilite-os selecionando Serviços Corporativos de Conectividade na página Log de Diagnóstico na Administração Central do SharePoint Foundation. Você também pode usar o Windows PowerShell para configurar logs de eventos e de rastreamento no servidor. Por exemplo, é possível alterar a unidade na qual os logs são gravados e definir o nível de detalhamento dos logs.

Para obter mais informações sobre logs no SharePoint Foundation 2010, como, por exemplo, a maneira de definir a localização dos arquivos de log, consulte Configure diagnostic logging (SharePoint Foundation 2010).

Você pode usar o Windows PowerShell para exibir os logs de eventos no servidor e pode exportar os logs para um programa de planilha, por exemplo. Para obter mais informações, consulte View diagnostic logs (SharePoint Foundation 2010).

Os Microsoft Serviços Corporativos de Conectividade geram duas categorias para o log de rastreamento nos servidores Web front-end do SharePoint Foundation: BDC_Shared_Services e SS_Shared_Service. Você pode usar o Visualizador de Eventos para abrir o log de rastreamento e pode filtrar as entradas de log relevantes pesquisando “SPS_BusinessData” (para a saída dos Microsoft Serviços Corporativos de Conectividade) e “SPS_SecureStoreService”.

Exemplo: usando logs de diagnóstico

Esse cenário curto e simplificado ilustra o uso de logs de diagnóstico em um ambiente de produção. Uma empresa implantou uma nova solução de envio de cartão de ponto com base nos Microsoft Serviços Corporativos de Conectividade. A solução usa um sistema externo para armazenar informações de cartão de ponto para os funcionários, como férias e licença médica, e para interagir com os funcionários e o sistema de folha de pagamento quando os funcionários relatam sua licença do trabalho. Os funcionários usam uma Web Part para interagir com o sistema.

No farm de servidores, os níveis de log são definidos com os valores padrão para os Microsoft Serviços Corporativos de Conectividade:

Para o log de eventos: Crítico e Erro
Para o log de rastreamento: Médio

Nesse cenário, um funcionário envia um valor correspondente ao número de horas de licença médica, mas o funcionário e seu gerente não recebem uma mensagem de email de confirmação relatando que o período de licença médica foi enviado com êxito. O funcionário liga para o serviço de suporte técnico interno e relata o problema.

A técnica de suporte reconhece que o aplicativo de cartão de ponto se baseia nos Microsoft Serviços Corporativos de Conectividade. Ela verifica o log de eventos, mas não encontra erros associados à identidade do usuário no momento em que ele enviou a solicitação de cartão de ponto. Ela verifica então o log de rastreamento, no qual encontra a prova da atividade: uma operação Atualizar associada ao usuário no horário adequado. A operação Atualizar no log de rastreamento inclui um valor de ID de Atividade que a técnica de suporte anota.

A técnica de suporte sabe que também há suporte para logs no sistema externo. Usando a ID de Atividade, ela localiza o item registrado no sistema externo e encontra prova de um erro gravado no log ao final da operação Atualizar: a atualização falhou porque o funcionário tinha usado todo o seu tempo de licença médica alocado. Ela também observa que não há uma entrada de log confirmando que uma mensagem de email foi gerada no sistema externo imediatamente ao final da operação Atualizar. A técnica de suporte conclui que há um erro na lógica do aplicativo de cartão de ponto. Embora o aplicativo tenha funcionado corretamente ao deixar de alocar pagamento para o período de licença médica quando o funcionário excedeu sua quantidade de horas alocada, ele não gerou uma mensagem de email informando o funcionário a respeito do problema. Ela relata o problema à equipe de desenvolvimento que criou o aplicativo, e a equipe de desenvolvimento o atualiza.

Compartilhar via