Configurar o log de diagnóstico no SharePoint Server

APLICA-SE A:yes-img-132013 yes-img-162016 yes-img-192019 yes-img-seSubscription Edition no-img-sopSharePoint no Microsoft 365

Pré-requisitos

A conta de usuário que está executando os procedimentos do Administração Central deve ser membro do grupo Administradores de Farm do SharePoint.

Práticas recomendadas para configuração de log de diagnóstico

O ambiente do SharePoint Server pode exigir a configuração do log de diagnóstico após a implantação inicial, após a atualização, e se uma alteração for feita no ambiente, como a adição ou remoção de um servidor. As diretrizes na lista a seguir podem ajudá-lo a formar as práticas recomendadas para o ambiente específico.

  • Altere a unidade em que o servidor grava logs.

    Por padrão, o SharePoint Server grava logs de diagnóstico na mesma unidade e partição nas quais foi instalado. Como o log de diagnóstico pode usar uma grande quantidade de espaço da unidade e comprometer o desempenho da unidade, configure o SharePoint Server para gravar em outra unidade na qual o SharePoint Server não está instalado. Considere também a velocidade de conexão com a unidade na qual o SharePoint Server grava os logs. Se o log em nível detalhado estiver configurado, o servidor registrará uma grande quantidade de dados. Portanto, uma conexão lenta pode resultar em um desempenho ruim do log.

  • Restrinja o uso de espaço de disco para log.

    Por padrão, a quantidade de espaço em disco que o log de diagnóstico pode usar é ilimitada. Portanto, restrinja o espaço em disco usado pelo log, especialmente se você configurar o log para gravar eventos de nível detalhado. Quando o disco alcança a restrição, o SharePoint Server remove os logs mais antigos antes de registrar novos dados de log.

  • Use a configuração Detalhada esporadicamente.

    É possível configurar o log de diagnóstico para registrar eventos detalhados. Isso significa que o SharePoint Server registra cada ação realizada. O log de nível detalhado pode usar rapidamente o espaço da unidade e afetar o desempenho da unidade e do servidor. É possível usar o log detalhado para registrar mais detalhes quando você estiver fazendo alterações críticas e reconfigurar o log para gravar apenas eventos de nível superior após a alteração.

  • Faça backups regulares dos logs.

    Os logs de diagnóstico contêm dados importantes. Portanto, faça backup dos logs regularmente para assegurar a preservação desses dados. Ao restringir o uso do espaço na unidade pelo log, ou se você manter os logs apenas por alguns dias, o SharePoint Server exclui automaticamente os arquivos de log, começando com os arquivos mais antigos primeiro, quando o limite for atingido.

  • Habilite a proteção contra inundação do log de eventos.

    Ao habilitar essa configuração, o SharePoint Server detecta eventos repetidos no log de eventos do Windows e os suprime até que as condições retornem a um estado normal.

Você pode definir o nível de log de diagnóstico para os logs de eventos e de rastreamento. Isso limita 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 ocorrem logs.
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. Investigue todos os eventos de erro.
Aviso
Esse tipo de mensagem indica um problema em potencial ou que pode exigir atenção. Revise e acompanhe as mensagens de aviso em busca de padrões com o passar do tempo.
Informações
As mensagens de informação não exigem qualquer ação. No entanto, podem fornecer dados importantes para o monitoramento do estado de sua solução.
Detalhado
Este 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 registra mensagens sobre eventos que fazem com que as soluções parem de processar. Quando for definido como esse nível, o log incluirá eventos nos níveis Inesperado, Exceção, Declarar e Crítico.
Monitorável
Esse nível registra mensagens sobre todos os eventos irrecuperáveis que limitam a funcionalidade da solução, mas não param o aplicativo. Quando definido como esse nível, o log também inclui eventos registrados pela configuração Inesperado.
Alta
Esse nível registra todos os eventos inesperados, mas que não param o processamento de uma solução. Quando definido para registrar nesse nível, o log também inclui todos os eventos registrados pela configuração Monitorável.
Médio
Quando é definido com esse nível, o log de rastreamento inclui todas as mensagens, exceto mensagens Verbose e VerboseEx. Esse nível registra todas as informações de nível superior sobre operações que foram executadas. Esse nível fornece detalhes suficientes para a construção do fluxo de dados e para a sequência de operações. Os administradores ou profissionais de suporte podem usar esse nível de registro em log para solucionar problemas. Quando definido como esse nível, o log também incluirá todos os eventos registrados pela configuração Alta.
Detalhado
Quando é definido com esse nível, o log inclui a maioria das ações. O rastreamento detalhado produz muitas mensagens de log. Esse nível geralmente é usado apenas para depuração em um ambiente de desenvolvimento. Quando definido para registrar nesse nível, o log também incluirá todos os eventos registrados pela configuração Média.
VerboseEx
Esse nível é suportado somente pelo cmdlet Set-SPLogLevel PowerShell e inclui dados de diagnóstico de nível muito baixo. Esse nível deve ser usado somente em um ambiente de desenvolvimento. Quando definido como esse nível, o log inclui todos os eventos registrados pela configuração Verbose.

Configurar o log de diagnóstico usando a Administração Central

Você pode usar o site da Administração Central do SharePoint para configurar o log de diagnóstico.

Para configurar o log de diagnóstico usando a Administração Central

  1. No Administração Central, na página inicial, clique em Monitoramento.

  2. Na página Monitoramento, na seção Relatório, clique em Configurar log de diagnóstico.

  3. Na página Log de Diagnóstico, na seção Limitação de Evento, configure a limitação de evento da seguinte maneira:

    Para configurar a limitação de evento para todas as categorias:

  4. Marque a caixa de seleção Todas as Categorias.

  5. Selecione o nível do log de eventos na lista Evento menos crítico a ser relatado no log de eventos.

  6. Selecione o nível do log de rastreamento na lista Evento menos crítico a ser relatado no log de rastreamento.

    Para configurar a limitação de evento para uma ou mais categorias:

  7. Marque as caixas de seleção das categorias que você deseja.

  8. Selecione o nível do log de eventos na lista Evento menos crítico a ser relatado no log de eventos.

  9. Selecione o nível do log de rastreamento na lista Evento menos crítico a ser relatado no log de rastreamento.

    Para configurar a limitação de evento para uma ou mais subcategorias (expanda uma ou mais categorias e selecione qualquer subcategoria):

  10. Clique no sinal de adição (+) ao lado da categoria para expandi-la.

  11. Marque a caixa de seleção da subcategoria.

  12. Selecione o nível do log de eventos na lista Evento menos crítico a ser relatado no log de eventos.

  13. Selecione o nível do log de rastreamento na lista Evento menos crítico a ser relatado no log de rastreamento.

    Para retornar a limitação de evento de todas as categorias para as configurações padrão:

  14. Marque a caixa de seleção Todas as Categorias.

  15. Selecione Redefinir como padrão na lista Evento menos crítico a ser relatado no log de eventos.

  16. Selecione Redefinir como padrão na lista Evento menos crítico a ser relatado no log de rastreamento.

  17. Na seção Proteção contra Inundação de Log de Eventos, marque a caixa de seleção Habilitar Proteção contra Inundação de Log de Eventos.

  18. Na seção Log de Rastreamento, na caixa Caminho, digite o caminho da pasta na qual você deseja gravar os logs.

  19. Na caixa Número de dias para armazenar arquivos de log, digite o número de dias (1 a 366) que você deseja manter os logs. Após esse período, os logs serão automaticamente excluídos.

  20. Para restringir o espaço em disco que os logs podem usar, marque a caixa de seleção Restringir o uso de espaço em disco do Log de Rastreamento e digite o número de gigabytes (GB) para restrição dos arquivos de log. Quando os logs atingem esse valor, os logs mais antigos são automaticamente excluídos.

  21. Depois de fazer as alterações desejadas na página Log de Diagnóstico, clique em OK.

Configurar o registo de diagnósticos com o PowerShell

Você pode usar o PowerShell para configurar o log de diagnóstico.

Para configurar o registo de diagnósticos com o PowerShell

  1. Verifique se você possui as seguintes associações:

    • A função de servidor fixa securityadmin na instância do SQL Server.

    • A função de banco de dados fixa db_owner em todos os bancos de dados que devem ser atualizados.

    • O grupo de administradores no servidor no qual você está executando o cmdlets do PowerShell.

    Um administrador pode usar o cmdlet Add-SPShellAdmin para conceder permissões para usar cmdlets PowerShell.

    Observação

    [!OBSERVAçãO] Se você não possui permissões, entre em contato com o Administrador da instalação ou com o administrador do SQL Server para solicitar permissões. Para mais informações sobre as permissões do PowerShell, consulte Add-SPShellAdmin.

  2. No Shell de Gerenciamento do SharePoint, altere a unidade na qual o servidor grava logs.

  3. No prompt de comando do PowerShell, digite o seguinte comando:

    Set-SPDiagnosticConfig -LogLocation D:\DiagnosticLogs
    
  4. Para restringir o uso do espaço de disco para log, no prompt de comando do PowerShell, digite o seguinte comando:

    Set-SPDiagnosticConfig -LogMaxDiskSpaceUsageEnabled
    

Ou atribua o espaço máximo em disco para logs:

Set-SPDiagnosticConfig -LogDiskSpaceUsageGB 500
  1. Para ver o nível de registro atual, no prompt de comando do PowerShell, digite o seguinte comando:

    Get-SPLogLevel
    
  2. Para alterar o nível de log, no prompt de comando do PowerShell, digite o seguinte comando:

    Set-SPLogLevel -TraceSeverity Monitorable
    

Para definir todas as categorias de volta aos níveis padrão, no prompt de comando do PowerShell, digite o seguinte comando e pressione Enter:

Clear-SPLogLevel
  1. Para habilitar a proteção contra inundação do log de eventos, no prompt de comando do PowerShell, digite o seguinte comando:

    Set-SPDiagnosticConfig -EventLogFloodProtectionEnabled
    

Para saber mais, confira Set-SPDiagnosticConfig, Set-SPLogLevel e Get-SPLogLevel.

Confira também

Conceitos

Visão geral do monitoramento no SharePoint Server 2016