Partilhar via

Exibir logs de diagnóstico (SharePoint Server 2010)

  • Artigo

 

Aplica-se a: SharePoint Foundation 2010, SharePoint Server 2010

Tópico modificado em: 2016-11-30

Use os dados dos registros de ULS (Serviço de Registro Unificado) do Microsoft SharePoint Server 2010 para solucionar problemas do farm. O registro de ULS pode coletar dados em vários níveis, dependendo das definições de registro. Você pode usar o Windows PowerShell para filtrar dados, exibi-los de várias maneiras e enviá-los para uma grade de dados para poder filtrar, classificar, agrupar e exportar dados para o Microsoft Excel 2010.

Para obter mais informações, consulte Configure diagnostic logging (SharePoint Server 2010).

Exibir e filtrar eventos de log usando o Windows PowerShell

Use o Windows PowerShell para exibir e filtrar eventos de log. Não é possível exibir ou filtrar eventos de log usando a Administração Central.

Para exibir e filtrar eventos de log usando o Windows PowerShell

  1. Verifique se você atende aos seguintes requisitos mínimos: Consulte Add-SPShellAdmin.

  2. No menu Iniciar, clique em Todos os Programas.

  3. Clique em Produtos do Microsoft SharePoint 2010.

  4. Clique em Shell de Gerenciamento do SharePoint 2010.

  5. No prompt de comando do Windows PowerShell, digite um dos comandos a seguir:

    • Todos o eventos de rastreamento:

      Get-SPLogEvent

    • Por nível:

      Get-SPLogEvent | Where-Object {$_.Level -eq [Information | Warning | Error | Critical | Verbose | Unexpected | Monitorable | High | Medium]}

    • Por área:

      Get-SPLogEvent | Where-Object {$_.Area -eq <Area>}

      Onde <Área> é o valor da propriedade Area.

    • Por categoria:

      Get-SPLogEvent | Where-Object {$_.Category -eq <Category>

      Onde <Categoria> é o valor da propriedade Category.

    • Por ID de evento:

      Get-SPLogEvent | Where-Object {$_.EventID -eq <EventID>}

      Onde <IDdoEvento> é o valor da propriedade EventID.

    • Por texto da mensagem:

      Get-SPLogEvent | Where-Object {$_.Message -like "*<string>*"}

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

    • Por processo:

      Get-SPLogEvent | Where-Object {$_.Process -like "*<Process>*"}

      Onde <Processo> é o valor da propriedade Process.

    Dica

    Por padrão, o comando recupera dados da pasta padrão do registro de ULS. Para exibir e filtrar os eventos de rastreamento que estão em uma pasta compartilhada, em uma rede, use o parâmetro Directory do cmdlet Get-SPLogEvent.
    Para exibir mais detalhes sobre cada evento de rastreamento, use Format-List no final do comando. Por exemplo, Get-SPLogEvent | Where-Object {$_.Area -eq "SharePoint Foundation"} | Format-List.

Para obter mais informações, consulte Get-SPLogEvent.

Observação

Recomendamos que você use o Windows PowerShell ao executar tarefas administrativas de linha de comando. A ferramenta de linha de comando Stsadm está obsoleta, mas está incluída para oferecer suporte à compatibilidade com versões anteriores do produto.

Exibir e exportar logs de diagnóstico usando o cmdlet Out-GridView do Windows PowerShell

O Windows PowerShell fornece um recurso poderoso e fácil de usar, que exibe dados tabulares resultantes dos comandos do Windows 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 utilizem o verbo Format. O cmdlet Out-GridView recebe objetos; já os cmdlets que usam o Format retornam somente texto formatado. Entretanto, você pode pré-filtrar os dados enviados para o modo de exibição de grade usando o pipeline Where-Object — por exemplo, Get-SPLogEvent | Where-Object {$_.Area -eq "SharePoint Foundation"} | Out-GridView.
Se a grade exibir mais de algumas centenas de linhas, a execução poderá ficar lenta, especialmente se essa execução envolver operações complexas de filtragem. Para acelerar o desempenho, exporte os dados para o Excel 2010.

Para obter mais informações, consulte Out-GridView (https://go.microsoft.com/fwlink/?linkid=181248&clcid=0x416) e Out-GridView Revisited (https://go.microsoft.com/fwlink/?linkid=181249&clcid=0x416).

Para exibir e filtrar logs de diagnóstico usando o Windows PowerShell

  1. Verifique se você atende aos seguintes requisitos mínimos: Consulte Add-SPShellAdmin.

  2. No menu Iniciar, clique em Todos os Programas.

  3. Clique em Produtos do Microsoft SharePoint 2010.

  4. Clique em Shell de Gerenciamento do SharePoint 2010.

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

    Get-SPLogEvent | Out-GridView

  6. Para exibir os resultados em grupos:

    1. Clique com botão direito do mouse no cabeçalho da coluna, clique em Mostrar em Grupos e clique no cabeçalho de coluna do valor pelo qual você deseja agrupar os resultados.

    2. Para expandir ou recolher um grupo específico, clique na seta ao lado do nome do grupo.

    3. Para remover o agrupamento, clique com o botão direito do mouse no cabeçalho da coluna e clique em Mostrar em Grupos.

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

  8. Para pesquisar uma determinada cadeia de caracteres, digite a cadeia na caixa Pesquisa. A pesquisa é executada em todas as colunas e linhas. Para limpar a pesquisa, clique em Limpar Tudo.

  9. Para filtrar dados usando somente um critério, digite o seguinte na caixa Pesquisa: <nome da propriedade>:<valor>. Por exemplo, para pesquisar todas as entradas de log por Windows SharePoint Foundation 2010, digite: Area:SharePoint Foundation. Para limpar o filtro, clique em Limpar Tudo.

  10. 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:

    1. Clique em Consulta.

    2. Clique em Adicionar.

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

    4. Clique em contém para alterar o método de filtragem. Os métodos disponíveis são contém, não contém, começa com, igual a, diferente de, termina com, está vazio e não está vazio.

    5. Digite um valor na caixa de texto.

    6. Repita as etapas "e" e "f" para cada propriedade selecionada na etapa "c".

    7. Quando todos os critérios de filtragem estiverem especificados, clique no botão de pesquisa para filtrar a grade de dados.

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

    9. 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 a serem exportadas. Você pode selecionar várias linhas usando SHIFT+DRAG para selecionar um bloco de linhas, CTRL+CLICK para selecionar linhas específicas e CTRL+A para selecionar todas as linhas.

    Também é possível filtrar e classificar os resultados antes de copiar os dados em 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.

See Also

Concepts

Configure diagnostic logging (SharePoint Server 2010)
Monitoring overview (SharePoint Server 2010)