Leia mais sobre Datas Workbench Anúncio do fim da vida útil.
Instruções detalhadas para instalar e configurar o Sensor para WebSphere 5.x em execução no AIX 5.1 ou posterior.
Os arquivos de programa para Sensor são embaladas em um arquivo de instalação obtido do site de download do Adobe. Se você ainda não tiver a variável Sensor arquivo de instalação para seu servidor da Web específico, baixe-o (ou obtenha-o do representante do Adobe) antes de começar os procedimentos a seguir.
O Sensor para servidores WebSphere não suporta experimentação controlada. Para obter informações sobre a experimentação controlada, consulte o Guia de experimentos controlados pela Data Workbench.
Procedimento para extrair e instalar os arquivos de programa do Sensorto na máquina do servidor.
Faça logon como o usuário raiz ou como um usuário com autoridade raiz.
Descomprima e descompacte o arquivo de instalação usando o seguinte comando:
gunzip installationFilename.tar.gz
tar -xf installationFilename.tar
Copie os arquivos de programa descompactados para os diretórios identificados na tabela a seguir:
Arquivo | Descrição | Diretório de destino |
---|---|---|
libvisual_sciences.so | O módulo de carregamento do coletor | /usr/local/visual_sciences |
J2EECollector.jar | As bibliotecas do módulo de carregamento do coletor | Diretório WebSphere /lib |
txlogd | O programa transmissor | /usr/local/bin --OR-- /usr/local/sbin |
txlogd.conf | O arquivo de configuração do sensor | /etc |
trust_ca_cert.pem | O certificado usado para validar o certificado digital que o Insight Server apresenta durante o processo de conexão | /usr/local/visual_sciences |
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.
Permissões nos arquivos do programa
Permissões incorretas nos arquivos do programa causam a maioria dos problemas encontrados ao instalar o Sensor.
Certifique-se de definir as permissões exatamente como declarado nesta seção.
Por padrão, os arquivos de programa no arquivo tar têm as seguintes permissões. Dependendo de como seu sistema está configurado, essas configurações podem ser alteradas (não mascaradas) ao extrair os arquivos.
Para redefinir as permissões para as configurações padrão recomendadas, use os comandos chmod abaixo.
Verifique se os diretórios nos quais você instalou os arquivos permitem pelo menos esse nível de acesso.
Arquivo | Permissões padrão | comando chmod |
---|---|---|
libvisual_sciences.so | rwx —x —x | chmod 711 |
J2EECollector.jar | rw- rw- r— | chmod 664 |
txlogd | rwx —x —x | chmod 711 |
txlogd.conf | rw- rw- r— | chmod 664 |
trust_ca_cert.pem | rw- rw- r— | chmod 664 |
Se quiser usar permissões além dos padrões recomendados, revise as informações em Permissões de arquivo UNIX do sensor, para ter certeza de que entende como esses arquivos são usados.
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
Procedimento para criar a fila de discos, depois de configurar o arquivo txlogd.conf.
Se o diretório em que está a fila de discos ainda não existir, crie-o. Certifique-se de que o diretório forneça o módulo coletor e o programa transmissor com acesso de leitura/gravação ao arquivo.
No computador em que o Sensor está instalado, execute o seguinte comando para iniciar o transmissor:
/usr/local/bin/txlogd -ic -f /etc/txlogd.conf
Verifique se o transmissor criou a fila de discos no local especificado no parâmetro QueueFile e do tamanho especificado no parâmetro QueueSize.
Se a fila não tiver sido criada corretamente, digite Ctrl+C para encerrar o transmissor e faça o seguinte:
Para servidores WebSphere, o coletor opera como um filtro no contêiner de servlet.
Para adicionar o coletor à aplicação web, adicione o filtro ao descritor de implantação web.xml da aplicação web e reinicie a aplicação web.
Usando um editor de texto, abra o arquivo web.xml para o servidor da Web cujos eventos o Sensor captura.
Adicione o seguinte <filter>
e <filter-mapping>
elementos para o arquivo descritor. Se você não instalou o txlogd.conf no diretório /etc, é necessário inserir 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 diferenciam maiúsculas de minúsculas. Digite-os exatamente como aparecem acima.
Reinicie o aplicativo Web. O coletor é carregado com o aplicativo e começará a coletar dados do evento e gravá-los na fila do disco.
Procedimento para editar o script de inicialização do Websphere para declarar o local dos arquivos J2EECollector.jar e libvisual_sciences.so.
Abra o arquivo setupCmdLine.sh no diretório Websphere /bin.
Após a linha que define a variável $WAS_CLASSPATH, adicione a seguinte linha:
WAS_CLASSPATH="$WAS_CLASSPATH":"$WAS_HOME"/lib/J2EECollector.jar
Após o bloco de caso que define a variável $WAS_LIBPATH, adicione a seguinte linha:
WAS_LIBPATH="$WAS_LIBPATH":/usr/local/visual_sciences
Salve as setupCmdLine.sh arquivo.
Procedimento para iniciar o transmissor e verificar se ele pode se conectar com êxito ao Servidor Insight e transmitir dados do evento para ele.
Para verificar se o transmissor pode enviar dados de evento com êxito para o servidor Insight, verifique se o servidor Insight de destino está instalado e em execução antes de iniciar o teste a seguir.
Se o transmissor ainda não estiver em execução, reinicie-o usando o seguinte comando:
/usr/local/bin/txlogd -i -f /etc/txlogd.conf
Abra um navegador (em qualquer máquina) e solicite uma página do servidor da Web em que o Sensor está sendo executado (certifique-se de selecionar uma página que o Sensor esteja monitorando).
Depois de emitir a solicitação, verifique o console do transmissor quanto a mensagens indicando que ele está enviando dados do evento para o servidor Insight de destino.
Se o sensor não estiver transmitindo os dados com êxito, verifique se:
Informações para garantir que o transmissor carregue automaticamente quando a máquina do servidor da Web for reiniciada.
Adicione o seguinte comando (que inicia o transmissor) ao script de inicialização do sistema.
/usr/local/bin/txlogd -f /etc/txlogd.conf
Esse comando inicia o transmissor como um daemon. Mensagens de erro e operacionais geradas pelo transmissor são gravadas no syslog.
Os sensores para todas as plataformas podem coletar qualquer um dos dados disponíveis nos cabeçalhos de solicitação e resposta HTTP.
Os Sensores da Plataforma J2EE fornecem um mecanismo de coleta de dados que não está disponível em outras plataformas. O coletor da plataforma J2EE (coletor J2EE) fica na camada do aplicativo, o que permite coletar dados confidenciais que estão disponíveis apenas para o aplicativo e não devem ser expostos por meio de marcação de página ou nos cabeçalhos.
Embora as tags de página e a modificação de cabeçalho possam ocultar os dados, eles ainda estão disponíveis para aqueles que examinam o código-fonte de uma página ou olham os cabeçalhos usando as ferramentas de plug-in do navegador.
Por exemplo, o coletor J2EE pode ser usado para capturar dados de custo por clique (CPC) para links exibidos em uma página, informações confidenciais do parceiro em uma página e muitos outros pontos de dados. O ambiente J2EE facilita a modificação de seu WEBAPP para capturar esses dados personalizados usando nossa classe de coletores.
Quando um Sensor da Plataforma J2EE recebe uma solicitação, ele chama uma classe de coletor que importa a função appendToLog . A função appendToLog anexa à solicitação inicial os parâmetros da string de consulta especificados na função appendToLog . Isso resulta no URI da solicitação inicial contendo pares de nome-valor de sequência de consulta adicionais que correspondem aos nomes e valores dos dados que estão sendo capturados. Por exemplo, CPC=20 seria anexado à solicitação inicial quando o valor de um determinado posicionamento de anúncio ou link de click-through é 20 centavos. O Insight Server processa esses valores no conjunto de dados para análise. Um benefício adicional para essa metodologia de coleta é que ela permite a coleta de dados adicionais sem criar entradas de log extras, como pode ser criado usando metodologias de marcação de página.
Para obter mais informações sobre o processamento, consulte o Guia de configuração do conjunto de dados.
Adicione o seguinte código à parte superior da página .jsp da qual 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 à sequência de consulta da página .jsp solicitada. O exemplo a seguir anexa "A=1" e "B=2" à sequência 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 da solicitação resultante é /index.jsp?A=1&B=2.
Repita esse procedimento para cada página .jsp da qual deseja capturar dados adicionais.