Instalando e configurando o Awstats 6.5 pelos fontes

Colaboração: André Jaccon

Data de Publicação: 01 de Março de 2006

Lembramos desde já que apesar de ser muito mais simples instalar o AWstats pelo APT no Debian Gnu/Linux, estarei exemplificando a instalação através dos binários para que este conceito possa ser utilizado por outras distros.

Requisitos de sistema:

• Perl 4.x ou superior
• Servidor Apache 1.3.x ou superior
• Compativel com os S.O's: Gnu/Linux, BSD's, Solaris, Irix, OS X, Windows entre outros
• URL para download do aplicativo: http://awstats.sourceforge.net/
• SO Utilizado: Debian Gnu/Linux Sarge 3.1 / Kernel 2.6.15

O Awstats é um software de análise de logs de acesso que pode ser utilizado para analisar logs de servidor Web e FTP. Em nosso caso iremos configurar para analisar o acesso de um servidor web Apache.

Preparando o terreno:

O Awstats faz a análise dos logs do servidor Apache em formato combinado ou seja digamos que você possue um host virtual no Apache como exemplo jaccon.org então os logs combinados deveriam ser configurados da seguinte forma:

Exemplo de NameVirtualHost

  NameVirtualHost 192.168.0.1
  
  <VirtualHost 192.168.0.1>
  ServerAdmin jaccon@jaccon.org
  ServerName jaccon.org
  DocumentRoot "/var/www/blog_jaccon.org/"
  #============================
  CustomLog logs/jaccon.org-access_log common
  ErrorLog logs/jaccon.org-error_log
  #============================
  </VirtualHost>

1º) Passo

A primeira tarefa depois de fazer download do Awstats é descompactar os scripts. Para isso usaremos o comando TAR conforme o exemplo abaixo:

  tar -zxvf awstats-6.5.tar.gz

Será criada uma pasta chamada awstats-6.5 na raiz do diretório onde você se encontra.

2º) Passo

Execute o script de configuração dentro do diretório ./awstats=6.5/tools/awstats_configure.pl ex:

  /awstats-6.5/tools/awstats_configure.pl

Siga as instruções do script. Pode ser que o script tenha algumas dificuldades de copiar os arquivos para as pastas certas e também adicionar os parametros dentro do arquivo de configuração do Apache. Para isso mostraremos como resolver este problema manualmente.

  cp /awstats-6.5/awstats.pl /usr/local/apache2/cgi-bin/
  cp -Rvf /awstats-6.5/wwwroot /usr/local/apache2/cgi-bin/

Acerte as permissões destes arquivos e diretórios

  chmod 744 /usr/local/apache2/cgi-bin/awstats.pl
  chmod 744 /usr/local/apache2/cgi-bin/wwwroot

3º) Passo

Para atualizar os relatórios do AWStats você deve executar o script awstats.pl utilizando as flags de comando -config e também -update assim como o exemplo abaixo:

  cd /usr/local/apache2/cgi-bin
  ./wwwroot/cgi-bin/awstats.pl -config /etc/awstats/awstats.debianmagazine.org.conf -update

Obs: o arquivo awstats.debianmagazine.org.conf deve ser gerado automáticamente com a execução do script awstats_configure.pl, caso ele não seja criado você poderá utilizado o modelo que está localizado em:

  /usr/local/apache2/cgi-bin/wwwroot/awstats.modelo.conf

Copie este arquivo para awstats.jaccon.org.conf e edite as seguintes linhas:

  LogFile="/usr/local/apache2/logs/jaccon.org-access_log"
  LogFormat=1
  DirData= /var/lib/awstats
  DirCgi="/cgi-bin"
  DirIcons="/icons"
  SiteDomain="jaccon.org"
  HostAliases="jaccon.org localhost 127.0.0.1"

Crie o diretório de caches do AWStats:

  mkdir /var/lib/awstats ; chmod 775 /var/lib/awstats

4º) Passo

Agora se tudo ocorreu como deveria o AWStats já deve estar pronto para utilização. Para verificar entre na URL: http://192.168.0.1/cgi-bin/awstats

*Obs: Lembre-se o AWStats não gera os relatórios automáticamente, é necessário que você agente uma tarefa com o daemon Cron para que seja executado o script de atualização conforme mencionado acima. Caso você esteja utilizando o AWStats em um servidor em produção o ideal é que ele seja executado em horários de menos problemáticos pois o script consome uma porcentagem considerada de CPU quando os logs do Apache são extensos e complexos.

Com isso você terá sua solução de Log Analyzer com o AWStats.