Definir e configurar SPDiag
Atualizado em: 2009-08-27
Leia esta seção para obter informações sobre os detalhes de configuração da ferramenta SPDiag e sobre como configurar servidores de farm para o processo de solução de problemas. Leia o tópico apropriado de instalação do SharePoint Administration Toolkit para obter detalhes de instalação.
Configurando o SPDiag
Depois de abrir um novo projeto SPDiag e antes de iniciar a coleta de dados com SPDiag, utilize a caixa de diálogo Opções para configurar essa ferramenta. Na maioria dos casos, os valores padrão irão funcionar, mas, se os locais de arquivos de monitores de desempenho ou de arquivos de log do IIS tiverem sido alterados e forem diferentes dos locais padrão em qualquer um dos servidores no farm, você poderá especificar esses locais diferentes aqui.
Também é possível especificar um compartilhamento de rede a partir do qual coletar arquivos de log quando você possui um arquivamento de log na rede.
Guia Arquivos
Na guia Arquivos, é possível definir os locais dos arquivos de dados utilizados pela ferramenta SPDiag para coletar informações. Observe que, para cada servidor, é necessário especificar o caminho local exato das pastas que contêm os arquivos de log. É possível adicionar vários caminhos com cada entrada, separados por um ponto-e-vírgula. SPDiag não faz pesquisas recursivas e, portanto, qualquer subdiretório que contenha arquivos de log deve ser adicionado explicitamente.
Selecionar servidor: use esse campo para selecionar o servidor Web no qual você deseja especificar os locais de arquivos.
Local do arquivo de contador de desempenho: use esse campo para definir o caminho dos arquivos de contadores de desempenho no servidor Web.
Local do arquivo de log do IIS: use esse campo para definir o caminho dos arquivos de log do IIS no servidor.
Guia Diversos
Na guia Diversos, é possível definir várias opções para as informações coletadas.
Velocidade de carregamento do log: use esse campo para especificar a taxa na qual os logs serão carregados no banco de dados de projeto. A tabela a seguir exibe as configurações disponíveis.
Configuração
Descrição
Baixa
Coleta dados de um servidor por vez.
Média
Coleta dados de até 5 servidores simultaneamente. Este é o padrão.
Alta
Coleta dados de até 10 servidores simultaneamente.
Se você estiver usando o servidor de banco de dados do farm para armazenar o banco de dados de projeto, use Baixa ou Média para reduzir o impacto de desempenho no servidor de banco de dados. Se estiver usando um SQL Server dedicado para hospedar o banco de dados de projeto, poderá usar a configuração Alta para obter o máximo de desempenho.
Se quiser alterar a velocidade do carregamento de logs depois que a coleta de dados tiver começado, clique em Cancelar na janela de notificação de coleta de dados, altere a velocidade de carregamento de logs e reinicie a coleta de dados.
Número máximo de linhas em relatórios personalizados: use esse campo para especificar o número de linhas que você deseja exibir nos relatórios personalizados que você gerar. O padrão é 100 linhas.
Número máximo de linhas em logs mesclados: use esse campo para especificar o número de linhas que você deseja coletar a partir de todos os arquivos de log incluídos no projeto. O padrão é 50.000 linhas.
Intervalo de tempo do contador de desempenho(em segundos): use esse campo para especificar a taxa de atualização dos contadores de desempenho usados para coleta de dados. O padrão é 5 segundos.
Dica
Essa configuração não afeta a taxa de atualização dos dados coletados através da Captura Dinâmica. Consulte a seção "Coletando dados de contadores de desempenho usando a Captura Dinâmica", mais adiante neste artigo, para obter mais informações.
Configurando os servidores do farm
Antes de começar a usar SPDiag, é preciso garantir que os servidores no farm estejam configurados para fornecer os dados exigidos por SPDiag.
Embora a maioria dos dados necessários para solução de problemas seja registrada por padrão nos servidores do farm, existem certos pontos de dados que precisam ser manualmente configurados.
Configurando contadores de desempenho
Antes de usar SPDiag para coletar informações dos servidores do farm, você pode usar o snap-in Monitor de Desempenho (Perfmon.msc) para criar logs PerfMon binários (.blg) nos servidores do farm. A ferramenta SPDiag pode coletar dados de qualquer arquivo .blg que ela encontrar no local do arquivo de contador de desempenho que você especificou para cada servidor do farm.
Ao solucionar problemas com um farm do SharePoint, é útil registrar uma ampla gama de dados de desempenho, especialmente no que diz respeito ao uso de processador e memória, E/S de disco e contadores importantes do IIS. Se possível, registre todos os contadores de desempenho que possam conter informações úteis em cada servidor farm por um período de tempo suficiente para capturar medidas que se englobem o uso farm dentro e fora do horário de pico.
Também é possível usar o recurso Captura Dinâmica de SPDiag para criar conjuntos de coletores de dados nos servidores do farm. Consulte Coletando dados de contadores de desempenho usando a Captura Dinâmica, mais adiante neste artigo, para obter mais informações.
Configurando logs do IIS
SPDiag coleta informações dos logs do IIS em servidores da Web do farm. O IIS registra em log a maioria das informações necessárias por padrão, mas SPDiag requer certos dados que não fazem parte desse padrão.
Use as informações nesta seção para garantir a configuração correta do IIS.
Os logs do IIS devem ser conferidos para garantir que sejam criados no Formato de Log Estendido W3C (padrão do IIS) e que todos os campos necessários para criar relatórios, como mostra a tabela a seguir, estejam presentes nos logs. Se o formato dos logs não for W3C, você poderá usar LogParser.exe para convertê-los nesse formato.
Dica
SPDiag considera que os arquivos de log do IIS são coletados no horário UTC, enquanto todos os outros logs representam o horário do servidor local. Se for necessário converter seus logs no formato W3C, os logs do IIS serão importados para o LogParser em UTC. Por isso, antes de coletar os logs do IIS convertidos com SPDiag, você deve converter em UTC todos os registros de hora nos arquivos de log.
A tabela a seguir exibe os campos de logs do IIS que são frequentemente utilizados para solução de problemas e indica se eles são registrados em log por padrão e se são necessários para a solução de problemas da ferramenta SPDiag.
Campo |
Aparece como |
Descrição |
Registrado em log por padrão? |
Obrigatório? |
Tempo necessário |
time-taken |
O tempo gasto pela ação, em milissegundos. Observe que esse é um campo obrigatório para a solução de problemas do SPDiag e não está habilitado por padrão. |
N |
S |
Host |
cs-host |
O nome do cabeçalho de host, se houver. Observe que esse é um campo obrigatório para a solução de problemas do SPDiag e não está habilitado por padrão. |
N |
S |
Data |
date |
A data na qual a atividade ocorreu. |
S |
S |
Hora |
time |
O horário, em UTC (tempo universal coordenado), no qual a atividade ocorreu. |
S |
S |
Endereço IP do cliente |
c-ip |
O endereço IP do cliente que fez a solicitação. |
S |
S |
Método |
cs-method |
A ação necessária, por exemplo, um método GET. |
S |
S |
Tronco URI |
cs-uri-stem |
O destino da ação, por exemplo, default.htm. |
S |
S |
Consulta URI |
cs-uri-query |
A consulta, se houver, que o cliente estava tentando executar. Uma consulta URI (Identificador de Recurso Universal) apenas é necessária para páginas dinâmicas. |
S |
S |
Status HTTP |
sc-status |
O código de status HTTP. |
S |
S |
Agente do usuário |
cs(User-Agent) |
O tipo de navegador ou outro cliente a partir do qual a solicitação foi originada. |
S |
S |
Nome do usuário |
cs-username |
O nome do usuário autenticado que acessou seu servidor. Usuários anônimos são indicados por um hífen. |
S |
N |
Endereço IP do servidor |
s-ip |
O endereço IP do servidor no qual a entrada do arquivo de log foi gerada. |
S |
N |
Porta do servidor |
s-port |
O número da porta do servidor configurado para o serviço. |
S |
N |
Substatus do protocolo |
sc-substatus |
O código de erro do substatus. |
S |
N |
Nome do Serviço e Número da Instância |
s-sitename |
O nome do serviço da Internet e o número da instância em execução no cliente. |
N |
N |
Nome do servidor |
s-computername |
O nome do servidor no qual a entrada do arquivo de log foi gerada. |
N |
N |
Status Win32 |
sc-win32-status |
O código de status do Windows. |
N |
N |
Bytes enviados |
sc-bytes |
O número de bytes enviados pelo servidor. |
N |
N |
Bytes recebidos |
cs-bytes |
O número de bytes recebidos pelo servidor. |
N |
N |
Versão do protocolo |
cs-version |
A versão do protocolo — HTTP ou FTP — que o cliente usou. |
N |
N |
Cookie |
cs(Cookie) |
O conteúdo do cookie enviado ou recebido, se houver. |
N |
N |
Referenciador |
cs(Referrer) |
O último site visitado pelo usuário. Esse site forneceu um link para o site solicitado. |
N |
N |
Como a ferramenta SPDiag coleta dados de logs do IIS a partir de arquivos de log do IIS existentes, antes de executar essa ferramenta, convém habilitar todos os campos de log do IIS da tabela que ainda não estejam sendo registrados em log nos servidores do seu farm. Se você optar por habilitar um campo de log do IIS específico, deverá fazer isso em todos os servidores Web do farm.
Dica
Se campos obrigatórios estiverem faltando nos logs do IIS, será possível configurar o IIS manualmente para adicioná-los. Se você optar por não adicionar esses campos obrigatórios, alguns relatórios não ficarão completos. Um círculo vermelho com um ponto de exclamação aparecerá na parte superior do painel Exibição de Logs Consolidados se os logs coletados estiverem incompletos. É possível verificar o log de rastreamento do SPDiag na pasta de instalação da ferramenta (por padrão, C:\Arquivos de Programas\Microsoft\SPAdministrationToolkit\SharePoint Diagnostics\SPDiag.log) para obter mais informações.
Configurando o banco de dados SQL Server de projeto
A ferramenta de Diagnóstico do SharePoint usa um banco de dados SQL Server 2005 ou SQL Server 2008 como repositório para dados coletados. Embora você possa usar o SQL Server usado pelo farm do SharePoint, convém fazer isso somente se você tiver certeza de que o servidor possui recursos suficientes ou se estiver usando SPDiag fora do horário de pico.
Cada projeto lógico possui um único banco de dados de projeto que pode conter até sete dias de dados. Em grandes ambientes de farm, isso pode representar um extenso volume de dados, e os processos de coleta e recuperação podem levar várias horas e consumir uma quantidade significativa de recursos no banco de dados de projeto e na rede entre a ferramenta SPDiag e o servidor de banco de dados de projeto. Por esse motivo, convém utilizar um servidor de banco de dados separado como repositório de dados de projeto, a não ser que o servidor de banco de dados do farm tenha a capacidade de lidar com a carga extra sem causar problemas de desenho para os usuários do farm.
O usuário da ferramenta SPDiag deve ter permissões para criação na instância do servidor de banco de dados de projeto. Quando um novo projeto é criado nessa ferramenta, um novo banco de dados de projeto é automaticamente criado no servidor de banco de dados, no contexto da conta de domínio do usuário.
Se você planeja criar bancos de dados de projeto SPDiag em um servidor de banco de dados usando um domínio diferente da sua conta de usuário, ou se o Active Directory não for usado no seu ambiente, verifique se a sua conta possui os privilégios apropriados para se autenticar no banco de dados SQL Server.
Para baixar uma versão de avaliação do SQL Server 2005, consulte o link de download do software SQL Server 2005 para avaliação (em inglês) (https://go.microsoft.com/fwlink/?linkid=141485\&clcid=0x416) (em inglês).