Partilhar via


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

Pode resolver problemas no farm com dados dos registos do Serviço de Registo Unificado (ULS) no SharePoint Server. Os registos ULS podem recolher dados em diferentes níveis, consoante as definições de registo. Utilize o PowerShell para filtrar os dados, apresentá-lo de várias formas e exportar os dados para uma grelha de dados com a qual pode filtrar, ordenar, agrupar e exportar dados para o Excel 2016.

Ver e filtrar eventos de registo com o PowerShell

Pode utilizar o PowerShell para ver e filtrar eventos de registo. Não pode ver ou filtrar eventos de registo através do site da Administração Central do SharePoint.

Para ver e filtrar eventos de registo 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.

    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>}

Em que< Área> é o valor da propriedade Área.

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

Em <que Categoria> é o valor da propriedade Categoria .

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

Em <que EventID> é o valor da propriedade EventID .

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

Em <que cadeia> é a cadeia encontrada na mensagem do evento.

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

Em que< Processo> é o valor da propriedade Processo.

Por predefinição, o comando obtém dados da pasta de registo ULS predefinida. Para ver e filtrar eventos de rastreio que estão na pasta partilhada numa rede, utilize o parâmetro Diretório do cmdlet Get-SPLogEvent .

Para ver mais detalhes sobre cada evento de rastreio, utilize 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.

Ver e exportar registos de diagnóstico com o cmdlet Out-GridView do PowerShell

O PowerShell fornece uma funcionalidade avançada e fácil de utilizar que apresenta dados tabulares resultantes de comandos do PowerShell numa grelha de dados filtráveis e pesquisáveis numa janela separada. Pode utilizar esta grelha para ver eventos de registo e para realizar 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

Não é possível utilizar o cmdlet Out-GridView com cmdlets que utilizam o verbo Formatar . O cmdlet Out-GridView recebe objetos, enquanto os cmdlets que utilizam o verbo Formatar devolvem apenas texto formatado. > Pode ver um subconjunto dos dados com o cmdlet Where-Object que filtra e transmite os resultados para o cmdlet Out-GridView . Por exemplo, Get-SPLogEvent | Where-Object {$_.Area -eq "SharePoint Foundation"} | Out-GridView. > Se a grelha apresentar mais de várias centenas de linhas, poderá ser executada lentamente, especialmente se realizar 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 procurar uma cadeia específica, escreva a cadeia na caixa Filtro . A pesquisa é efetuada em todas as colunas e linhas. Para limpar a pesquisa, clique em X.

  3. Para filtrar dados apenas num critério, escreva o seguinte na caixa Procurar : <nome> da propriedade:<valor>. Por exemplo, para procurar todas as entradas de registo levantadas pelo SharePoint Foundation 2013, escreva 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 alterar para um método de filtro diferente. Os métodos disponíveis 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 pretende exportar. Pode selecionar múltiplas linhas utilizando SHIFT+ARRASTAR para selecionar um bloco de linhas, CTRL+CLIQUE para selecionar linhas específicas ou CTRL+A para selecionar todas as linhas.

    Também pode filtrar e ordenar os resultados antes de copiar os dados para uma folha de cálculo. Quando ordena ou filtra dados, apenas 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.