Show Menu
TÓPICOS×

Microsoft IIS no Windows Server 2000 ou posterior

Instruções sobre como instalar e configurar o Sensor para o Internet Information Services (IIS) 5.x ou 6.x em execução no Microsoft Windows Server 2000 ou posterior.
Ao usar o IIS 6.x, o registro deve estar habilitado para que o Sensor funcione corretamente. Se você tiver desabilitado o registro para reduzir a E/S do disco, poderá habilitar o registro sem gravar dados nos registros. Para isso, ative o registro em log e, em seguida, limpe todos os campos na guia Avançado das Propriedades do Formato de Arquivo de Log Estendido W3C. Se precisar de assistência, entre em contato com os Serviços de consultoria da Adobe.
Os arquivos de programa do Sensor são empacotados em um arquivo de instalação que você obtém do site de download da Adobe. Se você ainda não tiver o arquivo de instalação do Sensor para seu servidor Web específico, baixe-o (ou obtenha-o do seu representante da Adobe) antes de começar os procedimentos a seguir.
Para instalar e configurar o Sensor, execute as seguintes etapas de alto nível:

1. Instale os arquivos de programa

Ao executar o Sensor no Windows IIS, os arquivos de programa e o arquivo de fila de disco devem residir no mesmo diretório.
Portanto, antes de instalar os arquivos do programa, você deve determinar onde deseja manter a fila de discos, pois também é onde você deve instalar os arquivos do programa.
Use o procedimento a seguir para extrair e instalar os arquivos de programa do Sensor.
  1. No computador Windows, crie um diretório no qual os arquivos de programa Sensor serão instalados. Lembre-se de que sua fila de discos também reside neste diretório, portanto, verifique se o dispositivo escolhido tem espaço suficiente para manter uma fila do tamanho necessário.
    Por exemplo: C:\VisualSensor
  2. Extraia o conteúdo do arquivo de instalação para o diretório que você acabou de criar. Durante esta etapa, o Sensor instala os seguintes arquivos:
Arquivo Descrição
EventMessages.dll Mensagens do Visualizador de eventos.
qlog.dll O módulo coletor (um filtro ISAPI).
TestExperiment.xls
Um arquivo de planilha do Excel que os arquitetos podem usar para configurar um experimento controlado.
O sensor não usa este arquivo.
trust_ca_cert.pem O certificado usado para validar o certificado digital que o Insight Server apresenta durante o processo de conexão.
TXLog.exe O programa do transmissor.
txlogd.conf O arquivo de configuração do sensor.
O pacote de instalação contém um arquivo de planilha chamado TestExperiment.xls. Esta planilha é uma ferramenta que os arquitetos usam para configurar um experimento controlado. O próprio sensor não usa esse arquivo, portanto, não é necessário instalar o arquivo na máquina em que o Sensor está sendo executado (embora você possa optar por fazê-lo). Em vez disso, copie o arquivo para um local onde seus arquitetos possam acessá-lo ou simplesmente extraia o arquivo do pacote de instalação, conforme necessário. Para obter mais informações sobre a experimentação controlada, consulte o Guia de Experimentos Controlados Insight.

2. Editar o arquivo de configuração

O arquivo txlogd.conf contém os parâmetros de configuração do Sensor.
Você deve editar o arquivo para especificar, entre outras coisas, o tamanho da fila de discos, o endereço do Insight Server e a ID que será anexada aos dados produzidos por esse sensor. O arquivo de configuração contém parâmetros obrigatórios e opcionais.
  • Parâmetros obrigatórios são configurações que você deve especificar ao instalar o Sensor. Sem essas configurações, o sensor não é executado com êxito.
  • Parâmetros opcionais são configurações padrão para valores predefinidos (que podem ser modificados) ou habilitam recursos opcionais.
Para editar o arquivo de configuração do sensor
  1. Abra o <SensorDirectory>/txlogd.conf arquivo em um editor de texto e defina os parâmetros necessários, bem como quaisquer parâmetros opcionais desejados.
    Para obter descrições dos parâmetros txlogd.conf, consulte Parâmetros do arquivo Sensor Txlogd.conf.
    Para obter exemplos de arquivos de configuração concluídos, consulte Arquivos de configuração de amostra de sensor.
  2. Salve e feche o arquivo.

3. Inicie o transmissor e crie a fila de discos

Depois de configurar o arquivo txlogd.conf, você pode iniciar o programa transmissor, registrá-lo como um serviço do Windows e criar a fila de discos.
  1. No menu Iniciar do Windows, selecione Acessórios > Prompt de comando.
  2. Na janela da tela de comandos, navegue até o diretório no qual você instalou o Sensor e execute o seguinte comando:
    txlog /regserver
    
    
    Esse comando inicia o transmissor, cria a fila de discos e registra o Sensor como um serviço do Windows.
  3. Para confirmar se o transmissor está sendo executado corretamente, clique em Iniciar > Painel de controle > Ferramentas administrativas > Serviços.
    Essa sequência de comando pode variar dependendo da versão do Windows que você está usando.
    1. Na lista de serviços, localize a entrada Sensor e confirme se seu status é Iniciado e seu tipo de inicialização é Automático.
    2. Feche o painel de controle Serviços.
  4. Para verificar se o transmissor apresentou erros durante a inicialização, clique em Iniciar > Painel de controle > Ferramentas administrativas > Visualizador de eventos para abrir o Visualizador de eventos.
    Essa sequência de comando pode variar dependendo da versão do Windows que você está usando.
    1. No painel esquerdo da janela Visualizador de eventos, selecione o registro Aplicativos.
    2. No painel direito, procure eventos com "Adobe" na coluna Origem.
    3. Se encontrar um erro em "Adobe", clique duas vezes no erro para exibir a janela Propriedades do evento. Esta janela fornece informações detalhadas sobre o erro.
  5. Quando terminar de examinar o log de Aplicativos, feche o Visualizador de Eventos.
  6. Verifique se o transmissor criou a fila de discos (Diskq2000.log) no diretório onde você instalou os arquivos de programa do Sensor e se é do tamanho especificado no parâmetro QueueSize no arquivo txlogd.conf.
    Se a fila não tiver sido criada corretamente:
    1. Examine o arquivo txtlogd.conf e verifique se o parâmetro QueueSize está definido corretamente.
    2. Verifique se o dispositivo no qual você instalou o Sensor tem espaço suficiente disponível para manter um arquivo do tamanho especificado no parâmetro QueueSize.
    3. Usando o painel de controle de serviços no Windows, pare o transmissor.
    4. Exclua o arquivo da fila.
    5. Registre novamente o Sensor como um serviço do Windows: no menu Iniciar do Windows, selecione Acessórios > Prompt de comando. Na janela da tela de comandos, navegue até o diretório no qual você instalou o Sensor e execute o seguinte comando:
      txlog /regserver
      
      
O transmissor foi projetado para funcionar continuamente. Se você reiniciar a máquina, o transmissor será reiniciado automaticamente. Se você precisar iniciar e parar o transmissor manualmente, poderá fazê-lo usando o painel de controle Serviços no Windows.

Adicionar o Coletor ao Servidor Web

Para o IIS, o coletor é um filtro ISAPI que você adiciona ao seu servidor Web no IIS.
  1. Abra o Gerenciador do IIS usando Iniciar > Ferramentas administrativas > Gerenciador dos Serviços de Informações da Internet (IIS).
  2. Expanda os nós Computador local e Sites da Web.
  3. Clique com o botão direito do mouse no site ao qual deseja adicionar o coletor e selecione Propriedades.
  4. Selecione a guia Filtros ISAPI e clique em Adicionar.
  5. No campo Nome do filtro, digite um nome para exibição para o filtro. O nome do filtro sugerido é "Sensor".
  6. Clique em Procurar, selecione o arquivo qlog.dll (localizado no diretório onde você instalou o Sensor) e clique em OK.
  7. Clique em OK para adicionar o filtro.
    Depois de adicionar o filtro, o coletor estará imediatamente operacional e pronto para coletar dados. Uma seta verde para cima deve aparecer na coluna Status da guia Filtros ISAPI do Gerenciador do IIS. Você pode não ver a seta verde até que o tráfego flua pelo filtro. Nesse caso, é necessário enviar uma solicitação ao servidor da Web para confirmar se o coletor está funcionando corretamente.
Se a seta verde não aparecer depois que o tráfego fluir para o coletor, conclua as seguintes etapas:
  1. Clique em Iniciar > Ferramentas administrativas > Visualizador de eventos para verificar se há erros no Visualizador de eventos.
    Essa sequência de comando pode variar dependendo da versão do Windows que você está usando.
  2. No painel esquerdo da janela do Visualizador de eventos, selecione o log de aplicativos.
  3. No painel direito, procure eventos com "Adobe" na coluna Origem.
  4. Se encontrar um erro, clique duas vezes no erro para exibir a janela Propriedades do evento.

Captura de dados adicionais

Geralmente, as páginas da Web são estruturadas usando a linguagem de programação ASP (Ative Server Pages).
ASP é uma tecnologia da Microsoft que funciona dentro do IIS. Quando um navegador solicita um arquivo ASP, o IIS transmite a solicitação para o mecanismo ASP. O mecanismo ASP lê o arquivo ASP, linha por linha, e executa os scripts no arquivo. Por fim, o arquivo ASP é retornado ao navegador como HTML simples. O ASP fornece objetos RESPOND ou REQUEST que, além de outras utilizações, permitem a resposta ou solicitação de consultas de usuários ou dados enviados de formulários HTML.
Em certos casos, talvez você não queira anexar os valores inseridos nos formulários ao URL que é exibido na barra de endereços do navegador de um usuário ou que é visível no próprio código HTML. O script ASP simples do lado do servidor permite anexar nomes de campos de formulário e seus respectivos valores ao arquivo de log sem disponibilizá-los no navegador do usuário ou incorporá-los ao arquivo HTML. Para capturar os valores de formulário reais inseridos em formulários específicos dentro do site, algumas linhas de código devem ser adicionadas para anexar os valores de formulário à solicitação de log.
Na página de processamento de um formulário, inclua o seguinte código para anexar os valores de formulário inseridos aos dados de solicitação (além de gravar os valores de formulário enviados em um banco de dados externo ou em outro local):
var sName= Request.Form("Name"); 
var sCity= Request.Form("City"); 
var sState= Request.Form("State"); 
var sZip= Request.Form("Zip"); 
 
Response.AppendToLog("&v_1=" +  sName); 
Response.AppendToLog("&v_2=" +  sCity); 
Response.AppendToLog("&v_3=" +  sState); 
Response.AppendToLog("&v_4=" +  sZip);

Esse processo anexaria os valores do formulário, conforme definido para os dados da solicitação para a página Processamento de formulário. Nos dados de log, os valores anexados estariam disponíveis como sequências de consulta da página Processamento de formulário, conforme ilustrado abaixo. Por exemplo, v_1, v_2, v_3 e v_4 agora são strings de consulta que contêm os dados inseridos nos campos de formulário apropriados. A sintaxe descrita no exemplo anterior pode ser duplicada para quaisquer campos de formulário e valores adicionais que você deseja capturar:
http://www.myserver.com/path/to/formprocessingpage.asp?v_1=John+Smith&v_2=Los+Angeles&v_3=California&v_4=90210

Se quiser que todos os campos e valores de formulário sejam capturados e disponibilizados para análise, use a seguinte sintaxe:
var formvalues = Response.Form; 
Response.AppendToLog(formvalues);

Este exemplo utilizaria todos os campos de formulário presentes no HTML junto com seus respectivos valores e os anexaria como sequências de consulta à entrada de registro da página Processamento de formulário. Observe que isso incluiria quaisquer campos ocultos presentes no formulário.
Os dados de log seriam aumentados conforme detalhado na tabela a seguir:
Dados Coletados
Explicação
Exemplo
v_1
Valor associado à string de consulta NAME
v_1=John Smith
v_2
Valor associado à string de consulta CITY
v_2=Los Angeles
v_3
Valor associado à string de consulta STATE
v_3=Califórnia
v_4
Valor associado à string de consulta ZIP
v_4=90210