Leia mais sobre Datas Workbench Anúncio do fim da vida útil.
Instruções sobre como instalar e configurar o Sensor para Serviços de Informações da Internet (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 ser ativado para que o Sensor funcione corretamente. Se você tiver desativado o registro para reduzir a E/S do disco, poderá ativar o registro sem gravar dados nos registros. Para fazer isso, ative o registro e, em seguida, limpe todos os campos na guia Advanced das Properties para o W3C Extended Log File Format. 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 obtido do site de download do Adobe. Se você ainda não tiver o arquivo de instalação do Sensor para seu servidor da Web específico, baixe-o (ou obtenha-o do representante do Adobe) antes de começar os seguintes procedimentos.
Para instalar e configurar o Sensor, você deve executar as seguintes etapas de alto nível:
Ao executar o Sensor no Windows IIS, os arquivos do programa e o arquivo da fila do disco devem residir no mesmo diretório.
Portanto, antes de instalar os arquivos do programa, você deve determinar onde deseja manter a fila do disco, 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.
Na máquina 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 nesse diretório, portanto, verifique se o dispositivo escolhido tem espaço suficiente para manter uma fila do tamanho necessário.
Por exemplo: C:\VisualSensor
Extraia o conteúdo do arquivo de instalação para o diretório que acabou de criar. Durante essa 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 esse 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 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, você pode querer copiar o arquivo para um local onde seus arquitetos possam acessá-lo ou simplesmente extrair o arquivo do pacote de instalação, conforme necessário. Para obter mais informações sobre experimentação controlada, consulte o Guia de experimentos controlados do Insight.
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 disco, o endereço do servidor Insight e a ID que será anexada aos dados produzidos por esse sensor. O arquivo de configuração contém parâmetros obrigatórios e parâmetros opcionais.
Para editar o arquivo de configuração do Sensor
Abra o <SensorDirectory>/txlogd.conf
em um editor de texto e defina os parâmetros obrigatórios, bem como quaisquer parâmetros opcionais desejados.
Para obter descrições dos parâmetros txlogd.conf, consulte Parâmetros do arquivo Txlogd.conf do sensor.
Para obter exemplos de arquivos de configuração concluídos, consulte Arquivos de configuração de amostra do sensor.
Salve e feche o arquivo.
Após configurar o arquivo txlogd.conf, você pode iniciar o programa transmissor, registrá-lo como um serviço do Windows e criar a fila de disco.
No menu Iniciar do Windows, selecione Acessórios > Prompt de comando.
Na janela da tela de comandos, navegue até o diretório em que o Sensor foi instalado e execute o seguinte comando:
txlog /regserver
Esse comando inicia o transmissor, cria a fila de disco e registra o Sensor como um serviço do Windows.
Para confirmar que 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ê estiver usando.
Para verificar se o transmissor apresentou algum erro 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ê estiver usando.
Quando terminar de examinar o log de Aplicativos, feche o Visualizador de Eventos.
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 é o tamanho especificado no parâmetro QueueSize no arquivo txlogd.conf.
Se a fila não tiver sido criada corretamente:
Examine o arquivo txtlogd.conf e verifique se o parâmetro QueueSize está definido corretamente.
Verifique se o dispositivo no qual você instalou o Sensor tem espaço suficiente disponível para armazenar um arquivo do tamanho especificado no parâmetro QueueSize .
Usando o painel de controle Serviços no Windows, pare o transmissor.
Exclua o arquivo da fila.
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 em que o Sensor foi instalado 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 precisar iniciar e parar o transmissor manualmente, faça isso usando o Painel de controle dos Serviços no Windows.
Para o IIS, o coletor é um filtro ISAPI adicionado ao servidor da Web no IIS.
Abra o Gerenciador do IIS usando Iniciar > Ferramentas Administrativas > Gerenciador dos Serviços de Informações da Internet (IIS).
Expanda os nós Computador local e Sites da Web .
Clique com o botão direito do mouse no site ao qual deseja adicionar o coletor e selecione Propriedades.
Selecione a guia Filtros de ISAPI e clique em Adicionar.
No campo Nome do filtro , insira um nome de exibição para o filtro. O nome do filtro sugerido é "Sensor".
Clique em Procurar, selecione o arquivo qlog.dll (localizado no diretório onde você instalou o Sensor) e clique em OK.
Clique em OK para adicionar o filtro.
Após adicionar o filtro, o coletor fica operacional imediatamente e pronto para coletar os dados. Uma seta verde para cima deve aparecer na coluna Status da guia Filtros de ISAPI do Gerenciador do IIS. Talvez você não veja a seta verde até que o tráfego flua pelo filtro. Nesse caso, você precisa enviar uma solicitação ao servidor da Web para confirmar que 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:
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ê estiver usando.
No painel esquerdo da janela Visualizador de eventos, selecione o log de aplicativos.
No painel direito, procure por eventos com "Adobe" na coluna Origem.
Se você encontrar um erro, clique duas vezes no erro para exibir a janela Propriedades do evento.
As páginas da Web geralmente são estruturadas usando a linguagem de programação ASP (Ative Server Pages).
ASP é uma tecnologia 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. Finalmente, 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 a 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 exibido na barra de endereços do navegador do usuário ou que seja 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 do 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 da solicitação (além de gravar os valores de formulário enviados em um banco de dados externo ou 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 de 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 seriam cadeias de caracteres de consulta contendo os dados inseridos nos campos de formulário apropriados. A sintaxe descrita no exemplo anterior pode ser duplicada para quaisquer campos e valores de formulário adicionais que você deseja capturar:
https://www.myserver.com/path/to/formprocessingpage.asp?v_1=John+Smith&v_2=Los+Angeles&v_3=California&v_4=90210
Se quiser que cada campo de formulário e valor sejam capturados e disponibilizados para análise, use a seguinte sintaxe:
var formvalues = Response.Form;
Response.AppendToLog(formvalues);
Esse exemplo usaria todos os campos de formulário presentes no HTML, juntamente com seus respectivos valores e os anexaria como cadeias de caracteres de consulta à entrada de log 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 à sequência de consulta NAME | v_1=John Smith |
v_2 | Valor associado à sequência de consulta CITY | v_2=Los Angeles |
v_3 | Valor associado à sequência de consulta STATE | v_3=Califórnia |
v_4 | Valor associado à sequência de consulta ZIP | v_4=90210 |