FAQ WebTrends

I. Migração da instalação do antigo servidor para o novo servidor – WebTrends Versão 7.x

Para migrar de servidor é necessário que a máquina nova tenha os mesmos drivers e diretórios.

Instale o WebTrends na máquina nova, com os mesmos usuários, senhas e locais utilizados na instalação antiga.

Pare os serviços do WT (Apache, Mysql, Tomcat, Scheduler e outros)
nas 2 máquinas e faça backup dos seguintes diretórios do servidor novo:

/webtrends/commom/database/mysql/data
/webtrends/storage

Copie o diretório storage da antiga para a nova, substituindo os arquivos, assim como:

(Dentro do diretório) "\webtrends\commom\database\mysql\data\wt_sched"

Copiar todas as tabelas que se iniciam com:
wt_event
wt_scheduler

(Dentro do diretório)
"\webtrends\commom\data\mysql\data\wtmaster"

Copiar todas as tabelas que se iniciam com:
wt_datasource
wt_profile
wt_scheduledevent
wt_user
wt_backup

Após transferir os arquivos citados da máquina antiga para a nova, reinicie os serviços que foram parados e verifique se as configurações estão OK.

II. Atualização de versão 7.x anterior para 7.x posterior

É necessário certificar a validade da chave de manutenção (Subscription) para que a migração possa ser feita, caso contrário, contate o departamento comercial da CLM.

Verifique se há alguma análise sendo realizada (Scheduler > JobQueue). Se houver, aguarde a finalização para prosseguir.

Faça backup de todo diretório de instalação do WebTrends (.\Program Files\WebTrends) com todos os serviços seguintes parados:

WebTrends User Interface
WebTrends Tomcat
WebTrends System Monitor
WebTrends Scheduler Agent
WebTrends Report Cache Server
WebTrends MySQL
WebTrends Apache
WebTrends GeoTrends Server, caso utilize a GeoTrends.

Após o backup, faça o download do instalador da versão atual
(O download só é possível através do site www.clm.com.br ).
Execute o instalador com todos os serviços do WebTrends parados, deixe apenas o WebTrends MySQL iniciado.

Durante a instalação nova, selecione o mesmo diretório da instalação antiga, os mesmos diretórios de armazenamento de dados (storage) e a mesma senha para o banco MySQL.

Caso seja solicitada a licença do produto, insira da seguinte forma:

o Se tiver apenas licença full sem addon:

• Insira a licença full seguida de espaço e
• a subscription da licença full, válida

Ex: lic_12345 sub_123

o Se tiver licença full e addons:

• Insira a licença full seguida de espaço,
• a subscription da licença full válida,
• espaço,
• a licença addon,
• espaço e, por fim,
• a subscription da licença addon (se tiver mais de um addon insira todos com suas respectivas subscriptions). Dando espaço entre eles?

Ex: lic_12345 sub_123

Após finalizar a migração, acesse a interface do produto e verifique se as configurações estão ok.

Faça uma análise de teste.

III. Desativação de chave que atingiu o limite de 2 ativações simultâneas Versões WRC 6.x, WebTrends 7.x

A licença full do WebTrends pode ter 2 instalações ativas simultâneas:
Para teste
Em produção (por exemplo)

Quando se tenta instalar a mesma chave de ativação em um terceiro servidor, a seguinte mensagem é retornada: Error: This activation would exceed the number of concurrent uses for the authorization key.

A chave de ativação full deve ser informada ao suporte da CLM pelo sistema de abertura de chamados que pode ser acessado em http://www.clm.com.br/suporte/chamadowt.asp assim como o IP para o qual a chave deve ser desativada. As informações das ativações encontram-se em:

Versão 6.x: Administration > Product License & Updates > Limits ou
Versão 7.x e 8.x: Administration > Licensing > Current Activations.

Após receber uma notificação de que a chave foi desativada para o respectivo IP, siga os seguintes procedimentos:

Versão 6.x: Administration > Product License & Updates > Updates > Check Now.
Versão 7.x e 8.x: Administration > Licensing > License/Product Activates > Check Now.

IV. Queda do serviço Scheduler Versão 7.x

O serviço de indexação do Windows, anti-vírus e agente de backup podem impactar as análises do WebTrends e, inclusive, ocasionar erros na base de dados e paralisar o serviço Scheduler.

Portanto, recomendamos:

Desabilitar o serviço de indexação
Retirar o diretório de instalação do WebTrends do scan do anti-vírus (\Program Files\WebTrends ou, ao menos, o arquivo Analyzeprofile.vbs, que se encontra em \Program Files\WebTrends\modules\analysis)
Evitar que o horário de backup coincida com o horário de análise.

Se o serviço Scheduler é executado por um usuário que não é o Local System Account (um usuário de domínio, por exemplo), verifique em Local Security Police se os direitos necessários estão corretamente aplicados: Atuar como parte do sistema operacional, Fazer log on localmente, Fazer log on como serviço.

V. Problema com o serviço Scheduler que não processa perfil existente na fila

O serviço Scheduler está iniciado, mas não processa perfis existentes na fila.

• Primeiro verifique se o arquivo "agent.conf" está em branco.
• Acesse \WebTrends\modules\agent
• Abra o arquivo "agent.conf" em um notepad e veja se está em branco. Caso esteja, instale novamente o produto por cima desta instalação escolhendo a opção "modify". Se não estiver em branco, siga as instruções abaixo:

• Pare todos os serviços do WebTrends exceto o WebTrends MySQL.
• Por linha de comando, acesse o diretório: \WebTrends\common\database\mysql\bin
• execute os comandos:
mysqlcheck.exe -r --databases wt_sched -u usernametodatabase -p

mysqlcheck.exe -r --databases wtmaster -u usernametodatabase –p

Depois de executar estes comandos reinicie o serviço WebTrends MySQL e os outros serviços do WebTrends na seguinte ordem:

1- MySQL
2- Scheduler agent
3- User interface
4- Demais serviços

O “usernametodatabase” é o nome de usuário que foi cadastrado para o MySQL durante a instalação do produto.

Se não lembrar o username, encontre-o no diretório de instalação do WebTrends em um arquivo chamado “installsummary.txt”. Dentro dele, há uma sessão chamada SYSTEM DATABASE PARAMETERS e nela está o usuário MySQL.

Se você não sabe qual é a senha por favor envie-nos um arquivo chamado wtliveglue.ini que fica em: C:\Program Files\WebTrends\common\lib.

Ele contém a senha criptografada que nós podemos decifrar, se for necessário.

VI. Ativação Manual da Chave Versão 7.x

Na instalação do WebTrends, a chave full deve ser ativada em um servidor localizado nos EUA. Desta forma, o aplicativo acessa uma URL via https porém, se o acesso se dá via proxy ou firewall, a ativação automática não poderá ser feita, apenas a manual, que será requerida.

Uma tela com os procedimentos aparecerá. Mantenha esta tela aberta, NÃO a feche e prossiga:

Clique com o botão direito do mouse no link “activation file” e selecione Save Target As (ou Salvar Destino como). Salve o arquivo activation.htm em um local desejado;
Acesse este arquivo a partir de um computador com acesso à Internet.
Uma tela de download se abrirá em seguida, automaticamente, basta esperar alguns segundos, portanto, NÃO clique no botão para fazer download manualmente;
Salve o arquivo licensechange.txt no diretório de instalação do WebTrends (\Program Files\WebTrends);
Volte à tela que se encontra aberta com os procedimentos e clique no botão “Activate”.
O produto será ativado, retornando uma mensagem de sucesso.
Faça login para certificar-se de que o produto está funcionando.

VII. Problema de licenciamento Versão 6.x

Quando a tela de registro, informando que a ativação do produto deve ser realizada, aparece ao se fazer o login do usuário, é porque algum arquivo de licenciamento foi corrompido, por isso ele retorna esta tela para ativação da chave.

Siga os procedimentos para resolução:

- Navegue até a interface do WebTrends e acesse Administration > License Products & Updates > General e copie a chave de ativação existente nessa tela;
- Vá até os serviços do sistema, localize e pare os 2 serviços: WebTrends Reporting Center e WebTrends Reporting UI;
- Acesse o diretório de instalação do WebTrends, geralmente em .\Program Files\WebTrends Reporting Center, e localize os arquivos LICDTA, Licensechange.txt, LICDTA.CPY, e todos os arquivos .html existentes.
- TRANSFIRA todos os arquivos desta pasta e não os deixe neste local (cortando-os e colando-os em um outro diretório, por exemplo);
- Verifique se existe o arquivo wtcfg.bin. Caso exista, transfira-o também;
- Reinicie os 2 serviços;
- Acesse o WebTrends e a tela solicitando a chave será mostrada;
- Insira a chave de ativação no campo disponível e clique em submit;
- A ativação do produto será automática se o servidor tiver acesso direto à Internet;
- A ativação manual será necessária caso tenha acesso à Internet por um proxy, por exemplo.

VIII. Reparação de base Versão 7.x

A ocorrência de erros na análise pode ser decorrente de algum arquivo que foi corrompido.

Mensagens como essas podem aparecer no status da análise:

Analysis: WARNING: ASU returned with an error
Analysis: WARNING: WTRS returned with an error

A base de dados deve ser verificada pelos seguintes procedimentos:

- Navegue até o diretório de instalação do WebTrends: .\WebTrends\commom\database\mysql\bin

- Execute os comandos entrando com a senha do MySQL em cada:

mysqlcheck.exe –r –-databases wt_sched –u usernameofdatabase –p
mysqlcheck.exe –r –-databases wtmaster –u usernameofdatabase -p
A reparação da base pode ser realizada com o seguinte comando:
mysqlcheck.exe -B wt_sched wtMaster -u smithj –p

Lembre-se que o usuário e senha usados são os mesmos que na instalação. O usuário e senha são case sensitive, ou seja, atenção ao uso de letras maiúsculas ou minúsculas.

IX. Restauração de backup Versão 7.x

Para a restauração de backup é necessário:

1 - Possuir backup dos seguintes diretórios na máquina onde está o WebTrends:

- /webtrends/commom/database/mysql/data
- /webtrends/storage

2 – Parar os serviços WebTrends e copiar o diretório storage do backup, SUBSTITUINDO os arquivos do diretório de instalação.

3 - Copiar os seguintes arquivos do backup, sempre substituindo os arquivos:

(Dentro do diretório) “\webtrends\commom\database\mysql\data\wt_sched”

Copiar todas as tabelas que se iniciam com:

wt_event
wt_scheduler

(Dentro do diretório) "\webtrends\commom\data\mysql\data\wtmaster"

Copiar todas as tabelas que se iniciam com:

wt_datasource
wt_profile
wt_scheduledevent
wt_user
wt_backup

4 - Reiniciar os serviços e verificar se as configurações estão OK.

X. Estimativa de Page Views para licenciamento

O licenciamento da versão 7 do WebTrends passou a ser por número de Page Views processados por ano. Caso não tenha esta informação, a WebTrends disponibilizou um programa para “estimar” este número.
Para efeito de LICENCIAMENTO todas as extensões de arquivos são contadas como page view, exceto: .gif, .jpg, .bmp, .png, .wbmp, .jpeg, .css .js

Para estimar o número anual de page views de um site é necessário utilizar alguns arquivos de log que representem, o mais próximo possível, a atividade do site. Estes arquivos devem ser selecionados pelo cliente.

É preciso saber, também, o volume anual de log do Servidor Web em MegaByte.

Se tiver mais de um Servidor Web selecione uma amostra de logs e verifique o volume anual de log para cada servidor. A estimativa deve ser feita para todos os servidores e somada ao final.

Tendo estes arquivos de log em mãos, pegue um por vez e arraste sobre o estimador de PV (countpv.exe).

Link para download do estimador:
www.clm.com.br/temp/EstimadorPageView.zip

O Contador retornará um número de "Page Views/Mb". Este número deve ser multiplicado pelo volume anual de log de seu servidor Web em "Megabyte".

Faça isso para todos os logs selecionados, um servidor de cada vez e depois faça uma média do resultado.

A soma do resultado de todos os Servidores Web é a estimativa de Page Views/Ano do site.

Este procedimento tem a finalidade de estimar o número de Page Views / Ano de um site para o licenciamento do WebTrends. Ele será diferente do número de Page Views do relatório WebTrends, pois as extensões consideradas são diferentes.

XI. Requisitos mínimos para instalação versão 8.x

Os requisitos mínimos recomendados para instalação da versão 8 encontram-se no link: http://product.webtrends.com/WRC/8.0/Documents/ WebTrends%20v8_0%20Release%20Notes.htm#sysreq

XII. Dimensionamento de ambiente para instalação do WebTrends Versão 8.x

Para dimensionamento do ambiente ideal, as seguintes informações são necessárias:

1. Page views/dia
2. Quantidade média de perfis/relatórios
3. Tamanho médio de log/dia
4. Quantidade de servidores/logs a serem analisados
5. Se SDC será utilizado
6. Se Geotrends será utilizada

XIII. Solicitação de nova chave

Para solicitação de nova chave é necessário enviar para o suporte da CLM a chave atual e a chave de manutenção (subscription) válidas. Elas estão localizadas em:

Versão 6.x: Administration > Product License & Updates > aba General e aba Addon ou
Versão 7.x e 8.x: Administration > Licensing > aba General e aba License Keys.

XIV. Diferenças entre versões

Faça a solicitação das versões que deseja colher mais informações pelo sistema de abertura de chamados que pode ser acessado em http://www.clm.com.br/suporte/chamadowt.asp.

XV. Material sobre SDC (SmartSource Data Collector)

Manual de instalação SDC:
http://product.webtrends.com/WRC/7.5/ Documents/InstallConfig.pdf

Manual de Configuração SDC:
http://product.webtrends.com/WRC/7.5/Documents/ AdvancedConfigurationGuide.pdf

WebTrends Query Parameters:
http://product.webtrends.com/WRC/8/ResourceCenter/rc /library/8/pdf/acg/WebTrends_Query_Parameters.pdf

Como mensurar o sucesso de campanhas?
http://product.webtrends.com/WRC/8/ResourceCenter/rc/library/8 /pdf/hdig/How_Do_I_Use_WebTrends_Campaign_Reporting.pdf

XVI. Exportação de Relatórios

Os relatórios do WebTrends podem ser exportados para os seguintes formatos: Word, Excel, PDF, CSV e MDB.

Requisitos para exportação de relatório:

- Windows 2000 (Service Pack 3 ou superior), Windows XP (Service Pack 1 ou superior), ou Windows 2003
- Microsoft Office 2000, XP, ou 2003 – para exportação nos formatos Microsoft Word ou Excel
- Adobe Acrobat Reader 4.0 ou superior – para exportar relatórios em PDF
- Java 2 Platform, Standard Edition, 1.4.2_05 ou superior
- WebTrends Report Exporter - aplicativo do WebTrends que é instalado automaticamente ao iniciar a primeira exportação, para fazer esta instalação o usuário logado na máquina deve ser administrador da mesma.

O nível de macro no Word e Excel deverá estar baixo (Ferramentas > Macro > Segurança ou Tools > Macro > Security) e durante a exportação não poderá haver nenhum outro documento do mesmo formato aberto (ex: se exportar um relatório para Excel feche todos os outros documentos Excel durante a exportação).

XVII. Limite de Page Views alcançado

A partir da versão 7.x o licenciamento do WebTrends passou a ser por número de Page Views processado por ano, este limite varia de acordo com cada licença.

Quando 80% e 100% deste limite são alcançados, o usuário administrador recebe um alerta ao fazer login na ferramenta e, a 120% do limite, o WebTrends mantém os relatórios disponíveis para consulta mas não faz novas análises de logs. O administrador também receberá um alerta, neste caso e, no “Profile Status” dos Profiles que entrarem na fila de análise aparecerá a seguinte mensagem (Web Analysis > Reports & Profiles > Analysis Status):

“Please contact technical support.
Analysis can no longer continue, the licensed page view limit has been reached”.

Quando isto ocorre, é necessário esperar um ano da data de compra da licença (Administration > Licensing > General > Anniversary Date), ou adquirir uma chave Addon que acrescentará Page Views em seu licenciamento. Para informações sobre licenças Addons contate a revenda responsável.

XVIII. Sobre a GeoTrends

A GeoTrends é uma base do WebTrends com mais de 11 milhões de IPs cadastrados com seus respectivos domínios, países, estados, cidades, organizações. Ela é utilizada para traduzir os IPs dos visitantes de seu site e gerar relatórios geográficos.

Para otimização dos relatórios geográficos é necessário, além de utilizar a GeoTrends, usar também a resolução de DNS do WebTrends. Esta duas opções são selecionadas de duas maneiras.

Globalmente (vale para todos os Profiles):

Web Analysis > Options > Analysis > aba Internet Resolution
Marque as opções “Domain Name/IP Resolution” para habilitar a resolução de DNS e “Company Location Resolution” para habilitar a GeoTrends

Localmente (para cada Profile):

Web Analysis > Reports & Profiles > Edite o Profile > aba Internet Resolution marque as opções “Domain Name/IP Resolution” para habilitar resolução de DNS e “Company Location Resolution” para habilitar a GeoTrends
Quando utilizamos a GeoTrends e a resolução de DNS, a análise dos logs é um pouco mais lenta, em média 20%.

Para instalar, utilize a mídia de instalação do WebTrends e selecione a opção “GeoTrends”, mantendo os outros módulos que já foram instalados. Após selecionar esta opção, será solicitado um arquivo .dat que é a base da GeoTrends. Faça download do mesmo em: http://product.webtrends.com/GeoTrends/Datafile/datafile.aspx ?prodtype=rcent&productcode=rcent&version=8.0a

XIX. Criação de Profile para Demo

Para criar um Profile de demonstração é necessário enviar uma amostra dos logs de seu(s) servidor(es) Web, em média 10 de arquivos de log.

Se tiver mais de um servidor Web, envie os mesmos dias de cada um. Estes logs devem ser copiados em um CD e entregues para CLM conforme combinado.

Utilizando esses arquivos de log, faremos um relatório piloto com informações do site do cliente. Portanto, será necessário, também, enviar algumas informações sobre o site como:

página(s)-alvo para saber caminhos feitos pelo site;
área do site para montarmos um cenário (pode ser um cadastro, pagamento de conta ou algum processo com determinado número de páginas);
informações que queiram excluir do relatório;
endereço do site para análise dos nossos consultores.
Após concluir o piloto, será agendada uma apresentação dos relatórios e o cliente receberá um usuário e senha para o acesso do mesmo.

XX. Instalação Piloto

A instalação piloto pode ser realizada em uma pré-venda do produto.

Para que ela seja realizada, o cliente deverá disponibilizar o seu ambiente para essa instalação que contempla, geralmente, 2 máquinas dedicadas. Uma máquina para SDC e uma máquina para o WebTrends. A configuração dessas máquinas pode variar de acordo com o ambiente do cliente e é baseada nas seguintes informações:

- Page views/dia
- Quantidade média de perfis/relatórios que serão utilizados
- Tamanho médio de log/dia
- Quantidade de servidores/logs a serem analisados
- Se terá utilização de Geotrends
- Se terá utilização de SDC
- Se terá utilização de Visitor History
- Se terá utilização de Custom Report

Após dimensionamento, as seguintes atividades devem ser realizadas:

Atividade 1 - Responsabilidade: Cliente > Dependência: n/a

Seleção de um site e de algumas respectivas páginas que serão avaliadas no piloto

Atividade 2 - Responsabilidade: Cliente > Dependência: n/a

Informação do nome do cookie que identifica os usuários (se este for utilizado), lista das URLs das páginas selecionadas e o respectivo site, algumas linhas (três, por exemplo) do log de atividade do web server deste site.

Atividade 3 - Responsabilidade: CLM > Dependência: Atividade 1 e 2

Instalação do WebTrends e do SDC nos servidores disponibilizados pelo cliente.

Atividade 4 - Responsabilidade: CLM > Dependência: Atividade 3

Geração dos scripts para serem inseridos nas páginas selecionadas.

Atividade 5 - Responsabilidade: Cliente > Dependência: Atividade 4

Inserção dos scripts nas páginas selecionadas. O script é um conjunto de códigos que deve ser inserido no código fonte da página.

Atividade 6 - Responsabilidade: CLM > Dependência: Atividades 2, 3 e 5
Configuração básica dos relatórios no WebTrends

Atividade 7 - Responsabilidade: Cliente > Dependência: Atividade 5 e 6
Análise dos resultados dos relatórios

Seguem os requisitos para instalação do WebTrends e SDC:

Para WebTrends

- Sistema Operacional instalado com todos os fixes e patches aplicados Win2003 ou XP)
- Criação de um usuário de domínio: será utilizado para instalação do WebTrends se os logs forem acessados via rede. Este mesmo usuário deverá executar um dos serviços do WebTrends que será instalado (WebTrends Scheduler)
- Para a execução deste serviço para a busca dos logs em outro servidor, o usuário deve ter os seguintes direitos concedidos: Atuar como parte do Sistema Operacional; Fazer logon localmente e Fazer logon como serviço, além disso, deve ter permissão full control no diretório compartilhado onde se encontram os logs e fazer parte do grupo de administradores em todos os servidores, ou seja, de WebTrends e o de storage/SDC
- Caso os logs não sejam acessados via rede, podemos instalar com um usuário local e este será o primeiro administrador do WebTrends
- O servidor onde será instalado deverá ter acesso à internet para que a chave seja ativada
- Disponibilizar alguns dias de log do site para teste de funcionamento. Este log pode estar em alguma máquina na rede, no mesmo domínio que o servidor WebTrends

Para SDC

- Sistema Operacional instalado com todos os fixes e patches aplicados (Win2003)
- IIS instalado
- Criação de um domínio ou utilização de um IP externo válido para que seja utilizado nos scripts que serão gerados posteriormente e utilizados para fazer os tags nas páginas

XXI. Descrição dos campos do log do IIS e suas utilidades

O Servidor Web gera uma das "matérias-primas" do WebTrends; o log.

O log deve estar no formato estendido para gravar mais informações e tornar o relatório do WebTrends mais rico em conteúdo. Lembre-se que o tamanho do arquivo de log também aumenta.

Descrição dos Procedimentos para deixar o log no formato estendido:

- Acessar a interface de administração do IIS
- Selecionar a pasta default web site clicando com o botão direito do mouse, selecionando as propriedades
- Habilitar a opção "Enable logging" caso ela não esteja habilitada
- Na aba "Active log format", selecionar a opção "W3C extended log file format"
- Selecionar as propriedades dessa opção
- Selecionar a aba "Extended Properties"

Os campos que geralmente recomendamos habilitar, no caso do IIS, são:

Essenciais
Básicos

- Date (date) - data da visita
- Time (time) - hora da visita

Extended Properties

- Client IP address (c-ip) - IP do visitante
- Server Ip address (s-ip) - IP do servidor
- Server Port (s-port) - porta utilizada para acesso
- Method (cs-method) - métodos dos tipos GET, POST, PUT
- URI stem (cs-uri-stem) - a página e/ou arquivos acessados
- URI query (cs-uri-query) - é a parametrização. Grava o parâmetro e seu valor
- Protocol Status (sc-status) - código de retorno. Se houve erro (404, 403, etc) ou sucesso (200, etc)
- Win 32 Status (sc-win32-status) – é o status da ação do Windows 2000
- User Agent (cs(User-Agent)) - mostrará Sistema Operacional e Browser utilizados pelo visitante
- Cookie (cs(Cookie)) - rastreamento por cookie
- Referrer (cs(Referrer)) - mostrará a referência do visitante, ou seja, o site onde ele estava antes de entrar no seu. Mostra também os sites de busca utilizados, assim como as palavras e frases buscadas.

Opcionais
Básicos

- User name (cs-user) - opcional, esse campo registra informação de usuário autenticado no IIS e não na aplicação.

Extended Properties

- (s-sitename) - instâncias do site embaixo do servidor web
- (s-computername) - nome do servidor
- Bytes sent (sc-bytes) - mostrará transferência de bytes
- Bytes recieved (cs-bytes) - mostrará transferência de bytes
- Time taken (time-taken) - mostrará o tempo gasto para mostrar a página solicitada ao visitante
- cs-version - (Versão do protocolo)
- Host (cs-host) - campo que o IIS 4.0 não possui - registra o domínio

• Clicar em apply e ok consecutivamente, duas vezes.
• Verificar se a configuração foi aplicada em todos os sites, embaixo do default website. Para fazer essa verificacão, clique com o botão direito do mouse sobre cada website, pedindo suas propriedades e depois nas propriedades de "Enable logging", verificando na aba “Extended Properties" os campos que estão acima.

XXII. Alteração da porta da interface do WebTrends e as demais portas utilizadas Versão 7.x e 8.x

Por padrão, o WebTrends utiliza a porta 7099 para acesso à sua interface. Essa porta pode ser alterada acessando na interface principal: Administration > System management > Global Roles > Clique na role 3. UI Server> Altere a porta para a desejada e clique em Save.

Caso haja alguma alteração nas roles do WebTrends, será requisitado o restart dos serviços do Apache e Tomcat. Você deve reiniciar estes serviços para que as alterações tenham efeito.

Portas utilizadas:

• 7199 – Geotrends
• 3306 – MySQL

XXIII. Queda do serviço de interface WebTrends UI Versão 6.x

A queda repentina do serviço WebTends Reporting Center UI pode ser causada por três motivos:

- a configuração do arquivo wtm_wtx.ini está corrompida;
- um ou mais perfis estão com a base corrompida;
- há um problema de licenciamento com a instalação;

Para saber a causa, devemos tentar o seguinte:

- Quando o serviço UI parar novamente e não estiver mais iniciando, pare os dois serviços do WT.???? Quais dois?
- Acesse a pasta do WebTrends (./wtm_wtx/datfiles/profiles)
- Crie uma pasta de backup temporária e mova todos os arquivos para ela.
- Inicie os dois serviços e faça o login no WT.

Se o serviço UI estiver ok, é necessário verficar um ou mais perfis para identificar problemas.

Neste caso, pare os dois serviços e mova um perfil de cada vez da pasta de backup (que foi criada anteriormente) para o diretório ./wtm_wtx/datfiles/profiles. Inicie os serviços e veja se o UI começou. Faça isso com todos os perfis até descobrir qual (ou quais) está com problema.

Quando descobrir qual perfil está danificando, você deve, primeiramente, renomear o wlp (./wtm_wtx/datfiles/profiles) com os dois serviços parados, assim ele não estará mais associado ao seu database.

Inicie os serviços e veja como o UI se comporta. Se ele estiver ok, então o problema está com o database do perfil e o mesmo deverá ser renomeado.

Encontre os seguintes arquivos referentes ao perfil e RENOMEIE-OS:

./wtm_wtx/datfiles/reports/<profile>.wlp &
./wtm_wtx/datfiles/databases/<profile>

Inicie os serviços e veja como o UI se comporta.

2- Se o problema não estiver nos perfis então o arquivo wtm_wtx.ini que se encontra na pasta wtm_wtx deve estar corrompido.

Neste caso segue solicite um arquivo wtm_wtx.ini de uma nova instalação (limpo) pelo sistema de abertura de chamados que pode ser acessado em http://www.clm.com.br/suporte/chamadowt.asp.
Pare o serviços, renomeie o arquivo wtm_wtx.ini (.\wtm_wtx\wtm_wtx.ini) e copie na mesma pasta o arquivo wtm_wtx.ini novo.

Inicie os serviços e tente logar no WT.

Verifique se o serviço UI está ok.

XXIV. Estrutura contendo ISA Server como Proxy reverso

Quando o acesso às páginas do Web Server ocorre por meio do ISA server como proxy reverso, os IPs dos visitantes não são gravados no arquivo de log e sim, o IP do ISA server. Sendo assim, para contabilidade dos visitantes é necessária utilização de cookies para identificação dos visitantes.

Porém , informações geográficas que são baseadas em IP serão afetadas numa estrutura como essa.

A implementação do SDC não suporta a utilização do ISA server como proxy reverso.

XXV. Plugin de Cookie WebTrends

Link para download do plugin: http://www.webtrends.com/Support/WT/Plugins.aspx

Este cookie deve ser instalado no(s) servidor(es) Web onde seu site está hospedado.
Após a instalação, seus visitantes receberão um número de cookie quando acessarem o site, este número será utlizado para identificar os visitantes únicos de seu site.

Para que funcione certifique-se de que o campo cookie está habilitado no arquivo de log e altere o “Session Tracking” do WebTrends para identificar os visitantes por cookie.

XXVI. Backup da instalação full e parcial - Versões 7.x e 8.x

O backup da instalação full do WebTrends deve ser realizado com freqüência e os serviços devem estar parados e serem reiniciados após o backup. Este backup contempla o diretório inteiro de instalação do WebTrends (Program Files\WebTrends).

Antes da paralização dos serviços, deve-se certificar se nenhum evento ou job esteja sendo executado. Verifique em Scheduler > Event Queue/Job Queue.

O backup pode ser agendado desde que não se inicie concomitantemente às análises do WebTrends.

Os seguintes diretórios devem ser incluídos em um backup mais frequentemente que o full:

/webtrends/commom/database/mysql/data
/webtrends/storage

XXVII. Espaço em disco insuficiente – Versões 7.x e 8.x

Se o problema é espaço em disco no servidor WebTrends, o Storage Locations do produto pode ser alterado.
Para isso, acesse Administration > System Management > Storage Locations e altere o C: para D:, criando as estruturas necessárias de diretórios, por exemplo.

Após a primeira análise, depois dessa alteração, é que o Webtrends faz a cópia dos arquivos para o drive D:.

Verifique se todos os arquivos foram copiados para o D: e exclua os arquivos em C: para liberar espaço. Clique em ok (apenas os arquivos que seguem a estrutura definida em Storage Locations).
Antes de fazer estas alterações, faça um backup de todo o diretório de instalação.

Porém, se a utilização do espaço em disco se dá, por arquivos compactados serem analisados e o WebTrends os descompactar e não fazer a manutenção, siga os seguintes procedimentos:

A alteração do local de descompactação dos logs deve ser feita e todos os arquivos para cada perfil terão seus locais alterados também.

- acesse o arquivo wtm_wtx.ini que se encontra em WebTrends\storage\config\wtm_wtx\wtm_wtx.ini;
- edite-o e localize a linha [compressioncache].
- altere o "useglobalcache" de 0 para 1
- altere o "compressiondir" para um diretório no D: (nesse diretório serão descompactados os logs).
- Salve o arquivo.
- Reinicie todos os serviços WebTrends.
- Três serviços têm ordem para parar e reiniciar:

• 1º System Management
• 2º Scheduler
• 3º System Monitor
• Os outros não precisam de ordem.

XXVIII. Documentação sobre os produtos WebTrends – manuais, guias de admin, usuário e configuração

Uma vasta documentação pode ser encontrada para quem já possui o produto, acessando, na interface principal, o link Customer Center ou Resource Center.

Para a versão 8, o link http://product.webtrends.com/WRC/8.0/Documents/documentation.aspx ?prodtype=rcent&productcode=rcent&version=8.0 possui todo material necessário para implementação e/ou dúvidas.

XXIX. Sobre licenciamento a partir da versão 7.x

O licenciamento da versão 7 do WebTrends passou a ser por número de Page Views processados por ano. Caso não tenha esta informação, a WebTrends disponibilizou um programa para “estimar” este número.

Para efeito de LICENCIAMENTO todas as extensões de arquivos são contadas como page view, exceto: .gif, .jpg, .bmp, .png, .wbmp, .jpeg, .css .js

Todas as outras extensões de arquivos são contadas como Page Views. Contacte nosso departamento comercial para mais informações sobre as versões ou abra um chamado técnico através de nosso sistema em http://www.clm.com.br/suporte/chamadowt.asp.

XXX. Registro de chave nos servidores da WebTrends

Se não possui a chave de ativação do produto, se não está mais instalado e não há meios de se saber qual a chave correspondente à sua aquisição; seu registro pode ser consultado diretamente na WebTrends.

Para tanto, os dados da empresa, contato, localidade (endereço completo) e versão do produto devem ser informados por nosso sistema de abertura de chamados técnicos em http://www.clm.com.br/suporte/chamadowt.asp.

XXXI. Data Sources

Acesse a interface do WebTrends em Administration > Data Sources clique em “New Data Sources”

Na primeira aba, defina o tipo do Data Source:

Web: Log File -> para analisar arquivos de log de servidor Web

Web: WebTrends Warehouse -> para analisar uma base dentro do WebTrends Warehouse

Web: SmartSource Data Files -> para analisar arquivos de log gerados por um servidor SDC

Streaming Media Server: Log File -> arquivos de log de servidor Streaming

Na segunda, defina o nome do Data Source e o caminho onde o WebTrends buscará os logs.
O WebTrends busca os logs de três maneiras:

Localmente (C:\Diretório dos logs\arquivo.log)
Pela rede (\\servidorWeb\diretório dos logs\ arquivo.log) utilize o caminho UNC.
Por FTP, especifique no Data Source o endereço do FTP, usuário e senha de acesso.

Para automatizar a busca dos logs vc pode utilizar:

* - para substituir vários caracteres
? – substituir um caracter

Exemplos:

E:\Logs Files\access_log.*.gz (pega todos os arquivos do diretório Log Files que comecem com access_log. e tenham a extensão .gz)
E:\Logs Files\*.log (pega todos os arquivos do diretório Log Files com a extensão .log)
E:\Logs Files\*.zip (pega todos os arquivos do diretório Log Files com a extensão .zip)
E:\Logs Files\ex200607*.log (todos os logs do mês de julho de 2006)

Quando utilizar o * para pegar todos os dados, atente-se aos tamanhos dos arquivos de número de arquivos do diretório dos logs, pois mesmo os arquivos que o WebTrends já processou serão abertos e lidos.

Após criação do Data Source associe ele a um Profile. Vários Profiles podem utilizar o mesmo Data Source.

XXXII. Criando novos usuários

Quando o WebTrends é instalado, o usuário logado na máquin, durante a instalação, passa a ser um usuário administrador da ferramenta. Para criar outros usários:

Acesse a interface do WebTrends em Administration > Users clique em “New User”
Os usuários podem ter uma senha do WebTrends ou utilizar a autenticação do S.O.
Na primeira aba defina o login, o mode de autenticação e a senha (caso use autenticação da ferramenta).
Na segunda aba defina as permissões do usuário, podem ser atribuidas permissões de Create, View, Edit e Delete.
Na terceira aba defina o “Time Zone” do usuário, isto irá afetar os eventos de execução e mensagens de status e defina o “Timeout” do usuário.
Depois salve a configuração.

Os usuários administradores têm direito de visualizar todos os templates e relatórios, mas usuários comuns não. Portanto é necessário atribuir permissão para esses usuários dentro de um template e do Profile que ele irá vizualizar.

No Template:

Acesse Web Analysis > Report Designer > Templates
Edite o template escolhido
Em “Template Access” dê permissão de “View” para o usuário.

No Profile:

Edite o Profile e em Administration dê permissão de “View Report” ao usuário.
Certifique-se de que o Template e o Profile são do mesmo tipo (Web ou Streaming)

Para criar um usuário apenas com visualização de um profile não atribua nenhuma permissão a ele, atribua apenas permissão de “view” no template e “View Report” no profile.

XXXIII. Templates

Na instalação do WebTrends já existem alguns templates prontos, incluindo o Complete View que tem mais de 500 relatórios e gráficos.

Para criar um novo template acesse: Web Analysis > Report Designer > Templates.

Temos duas opções:

Fazer uma cópia de um template já existente – Escolha o template que será copiado e na linha dele, no canto direito clique no botão “Copy”. Altere o nome do template e na aba “Content” exclua ou inclua pastas, relatórios, dashboards e links externos.

Criar um novo template – Clique em “New Template” entre com um nome e o tipo do template. Na próxima aba, crie pastas para agrupar os relatórios e dashboards, se necessário e adicione os mesmos no template. Use os botões de “Move Up” e “Move Down” para organizar os relatórios. Na terceira aba, defina se irá utilizar o Express Viewer somente para quem usa SDC (SmartSource Data Collector) e defina a linguagem e estilo do template. Na quarta e última aba, aponte quais usuários terão permissões neste template (view, edit e delete). Salve o Template.

XXXIV. Filters

Os filtros incluem ou excluem determinada informação do relatório. Existem dois tipos, os Visit Filters e os Hit Filters.

Visit Filters: filtram a sessão do visitante
Hit Filters: filtram todos os hits (cada linha) do arquivo de log.

Para criar um Hit Filter

Acesse: Web Analysis > Options > Hit Filters, exitem 13 campos:

• URL: Filtre uma URL ou URLs. Pode-se utilizar URLs dinâmicas, com parâmetros e valores.
• Browser
• Day of Week: Filtra determinado dia da semana.
• Return Code: Filtra o código de retorno do servidor Web e trás uma lista pré-definida que pode ser usada.
• Address: Filtra endereço do visitantes e pode utilizar a lista pré-definida.
• Directory: Filtra acesso de um ou mais diretórios do site.
• Cookie: Fitra acessos de determinado parâmetro do cookie.
• Hour of Day: Filtra acesso de determinada hora do dia.
• Onsite Adverstising: Inclui ou exclui do relatório acessos a um Banner especifico que deve ser previamente cadastrado em: Web Analysis > Report Configuration > Onsite Advertising.
• File: Filtra acesso de determinad arquivo ou tipo de arquivo.
• Multi Homed Domain: Usado para logs que gravam acesso de mais de um domínio no mesmo arquivo.
• Authenticated Username: Quando existe autenticação no Servidor Web e isto é gravado no log.
• HTTP Method: Filtra os métodos HTTP (Post, Get, Put, Head e Unknown)

Para criar um Visit Filter

Acesse: Web Analysis > Options > Visit Filters. Existem 3 campos:

• Entry Page: Filtro por página de entrada, para saber o comportamento dos visitantes que entraram por determinada página no seu site.
• Referrer: campo do log que grava de onde veio o visitante de seu site. Podemos filtrar apenas visitantes que vieram para o nosso site pelo Google, por exemplo.
• Campaigns: Filtra apenas atividade de determinada campanha que deve ser pré-definida em: Web Analysis > Report Configuration > Campaigns.

Defina os filtros antes de definir o perfil. Eles são configurações globais, ou seja, vários Profiles podem utilizar o mesmo filtro.

Para associar um filtro a um Profile, durante a criação do mesmo, clique em: Additional Settings > Advanced > Content Group antes de salvar o Profile, ou edite-o dentro de Advanced > Hit Filters ou Visit Filters (selecione o filtro).

Caso o perfil já esteja criado e um filtro seja adicionado, as informações filtradas serão refletidas apenas após a próxima análise.

XXXV. Content Groups

Content Groups são usados para agrupar informações que estão separadas no site ou para apontar quais as áreas mais acessadas do site, por exemplo.

É uma configuração global que pode ser usada por mais de um perfil e deve ser definido antes de sua definição.

Para criar um novo content group:

• Acesse: Web Analysis > Report Configuration > Content Groups
• Clique em “New Content Group”.
• Entre com um nome
• Na próxima aba digite a página, a palavra e o diretório. Pode usar parâmetros e valores para página dinâmica.
• Salve o Content Group editando o perfil em: Advanced > Content Groups
• Selecione o mesmo ou durante a criação do Profile em: Additional Settings > Advanced > Content Groups.
• O relatório de Content Group será mostrado após a próxima análise e fica em: “Site Design > Pages and Files > Content Groups”.

XXXVI. URL Parameters

A estrutura de uma página dinâmica é formada pela página, seu(s) parâmetro(s) e respectivo(s) valor(es). Por exemplo:

/pagina.asp?parametro=valor; onde o “?” é utilizado para separar a query string (parâmetros) da página e o “=” é utilizado para a identificação do parâmetro (o que está antes do =) e de seu valor (o que está após o =).

Se a página possui múltiplos parâmetros, então sua estrutura é a seguinte:

/pagina.asp?parametro1=valor1&parametro2=valor2&parametro3=valor3, onde o & separa os múltiplos parâmetros existentes.

Para analisar páginas desse tipo, utilize o recurso de URL Parameters. Os parâmetros fazem parte de uma configuração global que pode ser usada por mais de um perfil e deve ser definido antes da definição do perfil.
Para criar um novo parâmetro:

• Acesse: Web Analysis > Report Configuration > URL Parameters.
• Clique em “New URL Parameter Aanalysis”.
• Entre com um nome em Description
• Em Page Name, defina a página a ser analisada.
• Não utilize os caracteres de ? ou = ou &.
• Defina apenas a página. Utilizando o exemplo acima, defina /pagina.asp apenas.

Em Primary Parameter, defina o primeiro parâmetro a ser analisado e em Name to display em reports, defina um nome objetivo ao parâmetro. Por exemplo, na estrutura de sua página há um parâmetro id e ele significa um produto acessado. Em Primary Parameter você define id e, em Name to display, você define Produto. Não utilize os caracteres de ? ou = ou &.

Se o valor de seu parâmetro é um código, ele pode ser traduzido para melhor apresentação dos dados no relatório. Sendo assim, nesse arquivo de tradução devem conter os valores dos parâmetros e seus significados separados por vírgula e sem espaço salvos em um arquivo de texto (notepad, por exemplo).

1,Produto 1
2,Produto 2
3,Produto 3

A localização desse arquivo deve ser apontada em: Location of translation file e o check box Translate deve ser habilitado.

O WebTrends analisa até 2 parâmetros simultaneamente. Sendo assim, em Secondary parameter você pode definir as informações para o segundo parâmetro a ser analisado.

Depois de salvar o Parameter Analysis, editando o perfil em: Advanced > URL Parameters, selecione o mesmo ou durante a criação do Profile em Additional Settings > Advanced > URL Parameters.

O relatório de URL Parameter Analysis será mostrado após a próxima análise e fica em: “Site Design > Pages and Files > URL Parameters”.

XXXVII. SmartView

O WebTrends SmartView torna a análise fácil de visualizar mostrando os clicks na própria página. Com o SmartView, além de ver os clicks no site, é possível vizualizar métricas do período selecionado.

Requisitos de Sistema

- Microsoft IE v5.5 ou superior
- Acesso ao servidor do WT7. O usuário deve ter permissão de Smart View e de Reports.

Extensões Third-party

- Microsoft Internet Explorer v6.0
- Precisa ser configurado para permitir extensões third-party. Sem esta configuração o SmartView mostra “labels” somente na primeira página visualizada.
- Para permitir extensões third-party acesse o menu do IE em: Tools>Internet Options...
- Selecione a aba Advanced.
- Na sessão de Browser encontre “Enable third-party browser extensions (requires restart)” e marque esta opção.

Toolbar Configuration

- Primeiro instale o SmartView
- Abra uma nova janela do IE
- O ícone do SmartView será adicionado ao browser.
- Se o ícone não aparecer o toolbar pode estar bloqueado para mudanças. Para adiconar o ícone do SmartView clique em View > Toolbars > Customize > Add.

Se vc encontrar problemas com o SmartView, tente limpar o browser cache. Nós também recomendamos fechar e abrir o SmartView se algumas mudanças estão sendo feitas para o perfil que vc está visualizando.

Visualizando Relatórios em vários Browsers.

O SmartView não deve ser usado em várias janelas ao mesmo tempo.

Para que a utilização do SmartView esteja rodando corretamente, existem algumas condições para a criação do perfil:

- ter o Visitor History habilitado (recurso para segmentação do caminho e que está em uma aba na edição do perfil em General);
- ter habilitado o check box Smart View nessa aba no item General da edição do perfil e definido(s) o(s) domínio(s) que utilizarão o SmartView;
- ter utilização de cookie no site (qualquer tipo) e a definição de Session Tracking por cookie habilitada no WebTrends (na aba Session Tracking do item Advanced na edição do perfil);
- ter os parâmetros do WebTrends excluídos do perfil através do recurso URL Rebuilding na aba de mesmo nome do item Advanced na edição do perfil. Assim como outros parâmetros que não são identificadores da página (parâmetro que identifica a sessão, por exemplo);
- ter as extensões de tipos de arquivos de páginas (Page File Types - no item General) definidas para mostrar a query string no relatório;
- habilitar na aba Reports > Reports apenas relatórios diários e mensais.

XXXVIII. Scenario Analysis

Na análise de cenário, você poderá definir quantas etapas para conversão em forma de páginas quiser, ou seja, mostrará o funil de visitação/conversão em forma de um diagrama. Dessa forma, você poderá saber a quantidade de visitas com a intenção de realizar uma ação, por exemplo um cadastro ou uma compra, e quantas visitas efetivamente finalizaram a ação.

Por exemplo, você poderá definir 4 páginas que constituem um cadastro. O WebTrends poderá lhe indicar se você tem perda de visitantes em uma determinada página e você poderá averiguar o motivo. Uma informação mais complexa que faz com que o visitante deixe de fazer o cadastro ou efetuar uma compra ou ler uma notícia, por exemplo, dependendo de seu objetivo.

Para criar um novo cenário:

- Acesse Web Analysis > Report Configuration > Scenario analysis
- Clique em “New Scenario Analysis”
- Entre com um nome em Name, por exemplo, Cadastro Newsletter
- Em report Title, defina um nome que será apresentado no relatório que pode ser o mesmo definido em Name, se desejar
- Os itens SmartSource Identification String, Short Description e Help Card Description são opcionais
- Em Ordered list, ponha os Steps
- Clique em Add e em Name defina Passo1, por exemplo
- Em Report Name defina o nome do primeiro passo, por exemplo Home e clique em Next
- Em Page Expression defina a página que se refere ao 1º passo que é a Home (/defaul.asp, por exemplo) e clique em Save
- Clique em Add novamente para definição do segundo passo
- Em Name defina Passo2 e em Report Name defina o nome do segundo passo, por exemplo Página Inicial do Cadastro e clique em Next
- Em Page Expression defina a página que se refere ao 2º passo que é a Página Inicial do Cadastro (/cadastroinicial.asp, por exemplo) e clique em Save
- Siga o procedimento para os demais passos.

Depois de salvar o Scenario Analysis editando o perfil em: Advanced > Scenario Analysis selecione o mesmo ou durante a criação do Profile em Additional Settings > Advanced > Scenario analysis.
O relatório de Scenario Analysis será mostrado após a próxima análise e fica Scenario Analysis.

XXXIX. Dados Geográficos

As informações geográficas apresentadas nos relatórios WebTrends baseiam-se em IPs e em uma base de dados gerada e alimentada por uma equipe americana na WebTrends e não é customizável. Essa base é a Geotrends e as informações ali contidas referem-se a IPs do mundo todo, com suas respectivas organizações e cidades.

Os dados ali existentes são 100% corretos porém, não são 100% condizentes com a realidade da origem de acesso do visitante.O que não é garantido é que realmente a pessoa estava em dada cidade quando ocorreu o acesso. Por exemplo, um usuário da AOL que acessa do Brasil e navega por um IP dos EUA. Ou ainda, um funcionário de uma multinacional que navega por um IP de uma unidade fora do Brasil, etc.

Se pesquisarmos um IP da CLM, por exemplo, 200.162.40.2 no site brasileiro www.registro.br obtemos a informação correta de registro do domínio para o IP. Porém, acessando um site no exterior (quem cadastra os IPs na Geotrends é uma equipe americana e as consultas dos respectivos domínios dos IPs não é feita pelo site brasileiro) obtemos a informação de que o IP consultado está sob registro da LACNIC (Registro Regional de IPs da América Latina), que fica em Montevidéu, Uruguai.

Índice