FreeBSD

Relatório de Uso do Squid

Sarg (Squid Analysis Report Generator)


O Sarg - Squid Analysis Report Generator - como o próprio nome diz serve para gerar relatórios de utilização do Squid. É desenvolvido por um brasileiro, e seu site é http://web.onda.com.br/orso/sarg.html. O Sarg gera relatórios em HTML.

Faça o download da última versão do Sarg a partir de seu site. A versão atual é 1.4.1 e se encontra em http://web.onda.com.br/orso/sarg-1.4.1.tar.gz. Extraia o arquivo no diretório /tmp, será criado o diretório sarg-1.4.1, acesse-o. Execute os comandos abaixo:

# ./configure --enable-bindir=/usr/local/bin --enable-sysconfdir=/usr/local/etc
# make
# make install

O executável será instalado em /usr/local/bin/sarg, e o arquivo de configuração será /usr/local/etc/sarg/sarg.conf. Mova este arquivo para sarg.conf.original, para tê-lo como referência, e copie e adapte o exemplo abaixo em seu lugar, ou simplesmente edite o sarg.conf e altere os parâmetros que achar necessários:

-------------------- Arquivo sarg.conf --------------------
# sarg.conf

# Idioma.
language Portuguese

# Local do arquivo de log do Squid.
access_log /var/log/squid/access.log.0

# Titulo do relatorio.
title "Relatorio de Uso do Squid"

# Diretorio onde sera salvo o relatorio.
output_dir /usr/local/apache2/htdocs/sarg

# Converter enderecos IP para nomes DNS ou não.
resolve_ip yes

# Formato da data. e=dd/mm/yy.
date_format e

# Numero de relatorios que devem ser mantidos.
# Insira 0 (zero) para não limitar.
lastlog 12

# Local do arquivo exclude_codes.
exclude_codes /usr/local/etc/sarg/exclude_codes

-------------------- Fim do arquivo sarg.conf --------------------

Crie o diretório /usr/local/apache2/htdocs/sarg para que sejam guardados aí os relatórios. Será acessível através de http://servidor/sarg, este diretório pode ser protegido por senha se você preferir (através do Apache).

Especificamos no arquivo de configuração que será analisado o arquivo access.log.0 para gerar o relatório. Poderá ser especificado o arquivo access.log, mas da forma como fizemos fica mais prático para fazer a rotação do arquivo de log, através do "squid -k rotate". Desta forma, agendamos no Cron a execução da rotação do log e após isso o Sarg, que fará a análise do arquivo recém-rotacionado.

Exemplo de entrada no /etc/crontab:

58 23 * * 6 root /usr/local/sbin/squid -k rotate
10 00 * * 7 root /usr/local/bin/sarg

Com isso, a rotação do log será feita às 23h58min no sábado, e o Sarg irá gerar os relatórios à 0h10min.

 

Atualizado em 03/02/04.

Heini Thomas Geib.
http://infsr.unijui.tche.br/~heini

Voltar