Dados de exibição no banco de dados de registro em log do SharePoint 2010 (SharePoint Foundation 2010)
Aplica-se a: SharePoint Foundation 2010
Tópico modificado em: 2016-11-30
Este artigo introduz o banco de dados de registro em log do Produtos do Microsoft SharePoint 2010 e descreve como exibir a informação de monitoramento dentro do banco de dados de registro em log do SharePoint Foundation 2010 (por padrão, chamado WSS_Logging). Este artigo também descreve como usar as exibições personalizadas no banco de dados de registro em log e como exportar a informação de monitoramento para o Microsoft Excel.
Neste artigo:
Introdução ao banco de dados de registro em log
Exibições SQL predefinidas no banco de dados de registro em log
Exibições SQL personalizadas no banco de dados de registro em log
Introdução ao banco de dados de registro em log
Para monitorar os servidores do SharePoint Foundation 2010 e os serviços executados nos servidores, é possível acessar diretamente vários logs como os logs de evento do Windows Server, logs Universal Logging System (ULS) do SharePoint (também conhecidos como logs de rastreamento) ou logs de dados de uso. É também possível ir para a Administração Central do SharePoint Foundation 2010 para revisar vários relatórios. Os relatórios do analisador de integridade contêm regras do SharePoint Foundation 2010 para servidores ou serviços. Os relatórios de administração (diagnósticos) contêm informações relacionadas à pesquisa. Os relatórios do Web Analytics contêm métricas do web analytics. Para obter mais informações sobre os relatórios, consulte Viewing reports and logs (SharePoint Foundation 2010).
Todos os métodos de monitoramento mencionados anteriormente possuem limites. Por exemplo, os logs de evento do Windows Server, logs ULS do SharePoint e logs de dados de uso não são armazenados em um único local. Você deve ir para diferentes locais para localizar os logs relacionados. Da mesma forma, embora os relatórios da Administração Central conterem as métricas usadas mais comumente e as informações de monitoramento, se você desejar adicionar mais informações de monitoramento a estes relatórios, não é possível porque estes relatórios são predefinidos e não podem ser modificados.
é possível aumentar a eficiência do monitoramento usando o banco de dados de registro em log do SharePoint Foundation 2010. O banco de dados de registro em log é um repositório em todo o farm do SharePoint Foundation 2010 monitorando a informação de cada servidor do farm. O banco de dados de registro em log oferece a opção de exibir e personalizar várias informações de monitoramento em um local. Além disso, o banco de dados de registro em log é o único banco de dados do SharePoint Foundation 2010 no qual você pode personalizar relatórios modificando diretamente o banco de dados.
Observação
Para obter mais informações sobre os bancos de dados do SharePoint Foundation 2010, consulte Database types and descriptions (SharePoint Foundation 2010).
Observação
O nome padrão do banco de dados é WSS_Logging. É possível alterar o nome padrão e o local do servidor do banco de dados do SharePoint usando o Windows PowerShell. Para obter mais informações sobre o nome do banco de dados de registro em log e o local do servidor do banco de dados, consulte Configure usage and health data collection (SharePoint Foundation 2010).
Um único local que armazena várias informações de monitoramento ajuda você a monitorar com eficácia os servidores e serviços do SharePoint Foundation 2010. Mais importante, é possível criar seus próprios relatórios para monitoramento exclusivo, relatório e requisitos de solução de problemas baseados em tabelas dentro do banco de dados de registro em log. Este artigo descreve como criar relatórios usando as tabelas e exibições existentes. Você pode desejar gravar seus próprios provedores para criar novas tabelas. Para obter mais informações sobre a gravação de novos provedores para criar novas tabelas e exibições dentro do banco de dados de registro em log, consulte SharePoint 2010 (em inglês) (https://go.microsoft.com/fwlink/?linkid=224502&clcid=0x416) (em inglês).
Observação
Uma exibição SQL é uma tabela virtual. Uma diferença entre uma tabela e uma exibição SQL é que você pode modificar os dados dentro de uma tabela, mas não pode modificar os dados dentro de uma exibição SQL.
Você usa a Administração Central do SharePoint Foundation 2010 para configurar logs importados do banco de dados de registro em log. Para obter mais informações sobre como configurar as categorias de log, níveis de log e caminho do log de rastreamento (ULS), consulte Configure diagnostic logging (SharePoint Foundation 2010). Para obter mais informações sobre como habilitar o que está gravado no banco de dados de registro em log, consulte Configure usage and health data collection (SharePoint Foundation 2010). Para obter mais informações sobre como especificar o servidor do banco de dados de registro em log, nome e informação de autenticação do banco de dados, os eventos a serem gravados no banco de dados de registro em log e a frequência que os logs são gravados no banco de dados de registro em log (isto é, os trabalhos do timer relacionados ao uso da importação do banco de dados), consulte Configure SharePoint Health Analyzer timer jobs (SharePoint Foundation 2010).
Os procedimentos neste artigo usam o SQL Server Management Studio para acessar o banco de dados de registro em log. O Management Studio é um componente do Microsoft SQL Server 2008.
Observação
Para acessar o banco de dados de registro em log, você deve ter a autenticação do Windows (recomendado) ou a autenticação SQL. A informação da autenticação do banco de dados é configurada na Administração Central do SharePoint Foundation 2010. Para obter mais informações sobre os métodos de autenticação, consulte Configure usage and health data collection (SharePoint Foundation 2010).
Exibições SQL predefinidas no banco de dados de registro em log
Esta seção descreve as tabelas de partição e as exibições SQL dentro do banco de dados de registro em log do SharePoint Foundation 2010e inclui os seguintes três procedimentos:
Para acessar o banco de dados de registro em log usando o SQL Server Management Studio
Para exibir as informações do registro em log nas exibições padrões
Para exportar e exibir os dados de registro em log usando o Excel
O banco de dados de registro em log usa uma tabela de partição separada para os dados diários de cada categoria. Por exemplo, os dados de uso do trabalho de timer do primeiro dia são gravados na tabela dbo.TimerJobUsage_Partition0 e os dados de 32 dias depois são gravados na tabela dbo.TimerJobUsageUsage_Partition31. Os logs dentro de um dia são gravados em uma tabela de partição. Isto significa, para cada categoria de log, cada tabela de partição armazena um determinado log por dia.
Observação
O mapeamento entre uma tabela de partição e a data exata depende do período de retenção do banco de dados de registro em log e a data inicial para gravar logs no banco de dados de registro em log. É possível obter o mapeamento observando a informação de tempo dentro de cada tabela. Por exemplo, se o período de retenção é de 14 dias e os logs de hoje são gravados na tabela de partição 2, os logs de amanhã serão gravados na tabela de partição 3 e assim por diante. Após 14 dias, todos os logs serão excluídos e novos logs serão gravados nestas tabelas de partição iniciando pela tabela de partição 0.
É possível usar as exibições SQL predefinidas em Management Studio para exibir toda a informação de monitoramento em um local. Cada exibição predefinida coleta os dados de todas as 32 tabelas de partição para a categoria de log específica. Por exemplo, é possível exibir a informação de monitoramento em 32 tabelas do dbo.TimerJobUsage_Partition0 para o dbo.TimerJobUsageUsage_Partition31.
Para acessar as exibições predefinidas, você deve acessar o banco de dados de registro em log do SharePoint Foundation 2010. No banco de dados de registro em log, você visualiza a informação de monitoramento.
Para acessar o banco de dados de registro em log usando o Management Studio
Na barra de tarefas, clique em Iniciar, aponte para Todos os programas, clique em Microsoft SQL Server 2008 ou na versão mais atual do Microsoft SQL Server que está instalada e clique em SQL Server Management Studio.
Observação
Se você não tiver o Management Studio no seu servidor, reinstale o SQL Server 2008 e adicione o componente do Management Studio. Para obter mais informações, consulte Instalar o SQL Server (em inglês).
Na caixa de diálogo Conectar ao servidor, escolha Mecanismo do banco de dados. Especifique o nome do servidor, por exemplo, ServerName\SharePoint. Selecione o tipo de autenticação (Autenticação do Windows ou Autenticação do SQL Server) que você configurou através da Administração Central do SharePoint Foundation 2010. Se for a Autenticação do SQL Server, especifique as credenciais para o administrador do banco de dados. Após a informação ser definida, clique em Conectar.
Mude para a exibição do Explorador de Objetos clicando em Exibição e em Explorador de Objetos. Expanda os Bancos de dados para ver o banco de dados de registro em log que possui o nome padrão WSS_Logging ou um nome que você configurou na Administração Central do SharePoint Foundation 2010.
Opcionalmente, expanda o banco de dados de registro em log para ver as tabelas e exibições.
Para exibir a informação do registro em log nas exibições padrões
Em Management Studio, vá para o nó do banco de dados de registro em log usando o procedimento anterior.
Expanda o nó Exibições do banco de dados para ver as exibições padrões. Clique com o botão direito na exibição, por exemplo dbo.RequestUsage, e escolha Selecionar as 1000 maiores linhas.
A operação Selecionar as 1000 maiores linhas é o seguinte script de consulta do T-SQL:
/****** Script for SelectTopNRows command from SSMS ******/ SELECT TOP 1000 [PartitionId] ,[RowId] ,[LogTime] ,[MachineName] ,[FarmId] ,[SiteSubscriptionId] ,[UserLogin] ,[CorrelationId] ,[WebApplicationId] ,[ServerUrl] ,[SiteId] ,[SiteUrl] ,[WebId] ,[WebUrl] ,[DocumentPath] ,[ContentTypeId] ,[QueryString] ,[BytesConsumed] ,[HttpStatus] ,[SessionId] ,[ReferrerUrl] ,[ReferrerQueryString] ,[Browser] ,[UserAgent] ,[UserAddress] ,[RequestCount] ,[QueryCount] ,[QueryDurationSum] ,[ServiceCallCount] ,[ServiceCallDurationSum] ,[OperationCount] ,[Duration] ,[RequestType] ,[Title] ,[RowCreatedTime] FROM [WSS_Logging].[dbo].[RequestUsage]As maiores 1000 linhas da categoria da tabela Uso de solicitação são exibidas na janela de resultados.
É possível modificar a consulta T-SQL na janela do editor SQL. Por exemplo, se houverem mais de 1000 linhas nas tabelas, você pode desejar exibir as 5000 maiores linhas. Para fazer isso, mude o script substituindo “SELECT TOP 1000” por ”SELECT TOP 5000” e clique em Executar.
Se você deseja exibir os logs usando outras ferramentas além do Management Studio, é possível extrair a informação de monitoramento das exibições e salvar como um arquivo de texto ou um arquivo CSV. No procedimento a seguir, o Microsoft Excel é usado como exemplo.
Para exportar e exibir os dados de registro em log usando o Excel
No Management Studio, vá para o nó do banco de dados de registro em log.
Expanda o nó Exibições, clique com o botão direito na exibição da qual você deseja extrair dados e clique em Selecionar 1000 maiores linhas.
Na janela de resultados, clique com o botão direito e clique em Selecionar tudo. Clique com o botão direito e clique em Salvar resultado como….
Na janela Salvar resultados da grade, especifique a pasta na qual você deseja salvar o arquivo, especifique Salvar como tipo como CSV (Delimitado por vírgulas) e especifique um nome de arquivo adequado.
Abra o arquivo CSV clicando duas vezes no Excel.
Exibições SQL personalizadas no banco de dados de registro em log
O banco de dados de registro em log no SharePoint Foundation 2010 permite criar relatórios personalizados de duas formas. É possível gerar novas exibições combinando a informação relacionada das tabelas existentes ou é possível gravar provedores para gerar novas tabelas de partição dentro do banco de dados de registro em log. Os exemplos nesta seção mostram apenas a primeira forma.
Nas tabelas de uso e nas tabelas ULSTraceLog, o CorrelationId é um parâmetro importante para resolução de problemas. Isso ocorre porque cada mensagem de erro contém um CorrelationId exclusivo. O CorrelationId é um GUID que vincula todas as informações relacionadas com relação a uma solicitação. O seguinte procedimento exibe como criar uma exibição personalizada que vincula várias categorias de log usando o CorrelationId.
Para criar uma exibição SQL personalizada que usa tabelas existentes
No Management Studio, vá para o nó do banco de dados de registro em log.
No banco de dados de registro em log, expanda o nó Exibições. Escolha uma das exibições na qual você deseja coletar informações. Clique com o botão direito na exibição e clique em Nova exibição….
Na janela Adicionar tabela, escolha as tabelas para adicionar. Por exemplo, se você deseja obter informações sobre o recurso de solicitações do site de uso, é possível adicionar dbo.FeatureUsage_Partion1 e dbo.RequestUsage_Partion1.
A consulta T-SQL vincula internamente de forma automática a chave única PartionId nestas duas tabelas.
SELECT FROM dbo.FeatureUsage_Partition1 INNER JOIN dbo.RequestUsage_Partition1 ON dbo.FeatureUsage_Partition1.PartitionId = dbo.RequestUsage_Partition1.PartitionIdDesvincule as duas tabelas clicando com o botão direito no link entre estas tabelas e selecionando remover.
Para vincular as duas tabelas usando CorrelationId, clique na coluna CorrelationId em uma tabela e mova o cursor para a coluna CorrelationId em outra tabela. Ou é possível modificar a consulta SQL diretamente no Editor de Consultas.
SELECT FROM dbo.FeatureUsage_Partition1 INNER JOIN dbo.RequestUsage_Partition1 ON dbo.FeatureUsage_Partition1.CorrelationId = dbo.RequestUsage_Partition1.CorrelationIdEscolha as colunas em cada tabela que você deseja mostrar na nova exibição.
Clique com o botão direito e escolha Executar SQL. Os resultados são exibidos na janela resultados.