Instruções detalhadas para a instalação e configuração do Sensor para o Apache Jakarta Tomcat 4.1 ou posterior em execução no Windows Server 2000 ou posterior.
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.
As implementações J2EE suportadas incluem:
Para instalar e configurar o Sensor, execute as seguintes etapas:
Procedimento para extrair e instalar os arquivos de programa do Sensor.
No servidor Tomcat, crie um diretório no qual os arquivos de programa Sensor serão instalados. Lembre-se de que sua fila de discos está nesse diretório, portanto, verifique se o dispositivo escolhido tem espaço suficiente para manter uma fila do tamanho necessário.
C:\VisualSensor
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 | Diretório de destino |
---|---|---|
visual_sciences.dll | O módulo de carregamento do coletor. | Em qualquer diretório. |
J2EECollector.jar | As bibliotecas do módulo de carregamento do coletor | WEB-INF/lib |
txlogd.exe |
O programa do transmissor. | Em qualquer diretório |
txlogd.conf | O arquivo de configuração do sensor. | Em qualquer diretório |
trust_ca_cert.pem | O certificado usado para validar o certificado digital que o Insight Server apresenta durante o processo de conexão | Em qualquer diretório |
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.
O txlogd.conf arquivo contém os parâmetros de configuração do Sensor.
É necessário editar esse arquivo para especificar, entre outras coisas, o tamanho e o local do arquivo de fila de disco, o endereço do Insight Server e a ID que será anexada aos dados de evento produzidos por esse sensor.
O arquivo de configuração contém parâmetros obrigatórios e opcionais.
Para editar o arquivo de configuração do sensor
Para editar o arquivo de configuração do sensor
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.
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
Esse comando inicia o transmissor, cria a fila de discos e registra o Sensor como um serviço do Windows.
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.
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.
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 é do 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 manter um arquivo do tamanho especificado no parâmetro QueueSize.
Usando o painel de controle de 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 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.
Para servidores JBoss, o coletor opera como um filtro no contêiner de servlet.
Para adicionar o coletor ao servidor da Web, edite o web.xml arquivo conforme descrito abaixo e reinicie o aplicativo da Web.
Usando um editor de texto, abra o web.xml arquivo para o servidor da Web cujos eventos o Sensor captura.
Adicione os seguintes elementos <filter>
e <filter-mapping>
ao arquivo do descritor. Se você não instalou txlogd.conf no diretório /etc, é necessário digitar o caminho correto para esse arquivo no <param-value>
elemento:
<filter>
<filter-name>VSCollectorFilter</filter-name>
<description></description>
<filter-class>
com.visualsciences.collector.VSCollectorFilter
</filter-class>
<init-param>
<param-name>configPath</param-name>
<param-value>C:/VisualSensor/txlogd.conf</param-value>
<description></description>
</init-param>
</filter>
<filter-mapping>
<filter-name>VSCollectorFilter</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>
Essas linhas fazem distinção entre maiúsculas e minúsculas. Digite-os exatamente como aparecem acima.
Reinicie o processo do servidor da Web (você não precisa reinicializar o computador inteiro do servidor, simplesmente reinicie o processo do servidor da Web). O coletor é carregado com o servidor da Web e começa a coletar dados de eventos e gravá-los na fila de discos.
Instruções para adicionar o visual_sciences.dll ao caminho da biblioteca java do Tomcat.
No servidor Windows, navegue até o diretório de instalação do Tomcat. (Tomcat > bin)
Em bin folder, execute Tomcat9w.exe (Common daemon service manager).
Na guia Java, em Opções Java, adicione uma nova linha:
-Djava.library.path=C:\Sensor directory
Onde o C:\Sensor diretório é o diretório que contém o visual_sciences.dll arquivo.
Você pode capturar dados de medição adicionais de aplicativos da Web baseados em J2EE usando a funcionalidade appendToLog().
Adicione o seguinte código à parte superior da página .jsp da qual você deseja capturar dados:
<%@ page import="com.visualsciences.collector.VSCollector" %>
Use o método appendToLog() do objeto coletor para anexar os pares de nome-valor desejados à string de consulta da página .jsp solicitada. O exemplo a seguir anexa "A=1" e "B=2" à string de consulta da página .jsp solicitada para a página /index.jsp:
<html>
<body>
<h1>Hello World</h1>
<%
VSCollector collector = new VSCollector(request, response);
collector.appendToLog("A", "1");
collector.appendToLog("B", "2");
%>
</body>
</html>
O URI de solicitação resultante é /index.jsp?A=1&B=2.
Repita esse procedimento para cada página .jsp da qual deseja capturar dados adicionais.