Exibir logs 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

Você pode solucionar problemas no farm usando dados dos logs do Serviço de Log Unificado (ULS) no SharePoint Server. Os logs do ULS podem coletar dados em níveis variados, dependendo das configurações de log. Use o PowerShell para filtrar os dados, exibi-los de várias maneiras e gerar os dados para uma grade de dados com a qual você pode filtrar, classificar, agrupar e exportar dados para o Excel 2016.

Exibir e filtrar eventos de log usando o PowerShell

Você pode usar o PowerShell para exibir e filtrar eventos de log. Você não pode exibir ou filtrar eventos de log usando o site da Administração Central do SharePoint.

Para exibir e filtrar eventos de log usando 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.

    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 Windows PowerShell, consulte Add-SPShellAdmin.

  1. Vá para o Shell de Gerenciamento do SharePoint.

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

  • Todos o eventos de rastreamento:
Get-SPLogEvent
  • Por nível:
Get-SPLogEvent | Where-Object {$_.Level -eq "Information" }
  • Por área:
Get-SPLogEvent | Where-Object {$_.Area -eq <Area>}

Onde <Area> é o valor da propriedade Area .

  • Por categoria:
Get-SPLogEvent | Where-Object {$_.Category -eq <Category>

Onde <Categoria> é o valor da propriedade Categoria .

  • Por ID de evento:
Get-SPLogEvent | Where-Object {$_.EventID -eq <EventID>}

Onde <EventID> é o valor da propriedade EventID .

  • Por texto da mensagem:
Get-SPLogEvent | Where-Object {$_.Message -like "<string>"}

Onde <string> é a cadeia de caracteres encontrada na mensagem de evento.

  • Por processo:
Get-SPLogEvent | Where-Object {$_.Process -like "<Process>"}

Onde <Process> é o valor da propriedade Process .

Por padrão, o comando recupera dados da pasta de log ULS padrão. Para exibir e filtrar eventos de rastreamento que estão em pasta compartilhada em uma rede, use o parâmetro Directory do cmdlet Get-SPLogEvent .

Para exibir mais detalhes sobre cada evento de rastreamento, use o cmdlet Format-List no final do comando. Por exemplo,

Get-SPLogEvent | Where-Object {$_.Area -eq "SharePoint Foundation"} | Format-List

Para saber mais, confira Get-SPLogEvent.

Visualize e exporte logs de diagnóstico usando o cmdlet de Out-GridView do PowerShell

O PowerShell fornece um recurso poderoso e fácil de usar que exibe dados tabulares resultantes de comandos do PowerShell em uma grade de dados filtrável e pesquisável em uma janela separada. Você pode usar essa grade para exibir eventos de log e executar as seguintes operações nos dados:

  • Classificar dados por qualquer coluna.

  • Exibir dados em grupos.

  • Filtrar os dados por Nível, Área, Categoria, Mensagem, ID de Evento ou Carimbo de Data/Hora.

  • Pesquisar os dados de qualquer cadeia de caracteres.

  • Exportar dados brutos, classificados ou filtrados para uma planilha.

Observação

O cmdlet Out-GridView não pode ser usado com cmdlets que usam o verbo Format . O cmdlet Out-GridView recebe objetos, enquanto os cmdlets que usam o verbo Format retornam apenas texto formatado. > Você pode exibir um subconjunto dos dados usando o cmdlet Where-Object que filtra e passa os resultados para o cmdlet Out-GridView . Por exemplo, Get-SPLogEvent | Where-Object {$_.Area -eq "SharePoint Foundation"} | Out-GridView. > Se a grade estiver exibindo mais de várias centenas de linhas, ela poderá ser executada lentamente, especialmente se estiver executando operações de filtragem complexas. Para um desempenho mais rápido, exporte os dados para o Excel 2016.

Para exibir e filtrar logs de diagnóstico usando o Windows 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.

    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 Windows PowerShell, consulte Add-SPShellAdmin.

  1. Vá para o Shell de Gerenciamento do SharePoint.

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

Get-SPLogEvent | Out-GridView

  1. Para classificar colunas, clique no cabeçalho da coluna.

  2. Para pesquisar uma cadeia de caracteres específica, digite-a na caixa Filtro . A pesquisa é executada em todas as colunas e linhas. Para limpar a pesquisa, clique em X.

  3. Para filtrar dados em apenas um critério, digite o seguinte na caixa de pesquisa : <nome> da propriedade:<valor>. Por exemplo, para pesquisar todas as entradas de log geradas pelo SharePoint Foundation 2013, digite o seguinte: Area:SharePoint Foundation. Para limpar o filtro, clique em X.

  4. Para filtrar dados usando mais de um critério ou usando critérios com contém, começa com, termina com ou outros métodos:

  5. Clique no botão Adicionar critérios.

  6. Marque a caixa de seleção das propriedades a serem filtradas e clique em Adicionar.

  7. Clique em contém para mudar para um método de filtro diferente. Os métodos disponíveis são: contém, não contém, começa com, é igual a, não é igual, termina com, está vazio e não está vazio.

  8. Digite um valor na caixa de texto.

  9. Repita as etapas "c" e "d" para cada propriedade selecionada na etapa "b".

  10. Quando todos os critérios de filtragem estiverem especificados, os dados que atendem aos critérios serão exibidos.

  11. Para limpar um determinado filtro, clique no botão X.

  12. Para limpar todos os filtros, recolha o modo de exibição de consulta e clique no botão Limpar Tudo.

Para exportar os dados da grade para uma planilha

  1. Selecione as linhas que você deseja exportar. Você pode selecionar várias linhas usando SHIFT+DRAG para selecionar um bloco de linhas, CTRL+CLICK para selecionar linhas específicas ou CTRL+A para selecionar todas as linhas.

    Você também pode filtrar e classificar os resultados antes de copiar os dados para uma planilha. Quando você classifica ou filtra dados, somente os dados visíveis resultantes são copiados.

  2. Copie as linhas selecionadas usando CTRL+C.

  3. Abra a página da pasta de trabalho da planilha e cole as linhas copiadas usando CTRL+V.

Para obter mais informações, consulte Out-GridView e Out-GridView Revisited.

  • Last updated on