http://www.zago.eti.br/squid/sarg-2.0.txt Tutorial pra instalar e configurar o Sarg versão 2.0.2, FAQ das mensagens na Linux-br com respostas sobre o gerador de relatorios no Squid. Veja também o FAQ sobre SARG, dicas e instalação, tutorial pro CL9, outras dicas sobre relatórios e indicações de sites relacionados: http://www.zago.eti.br/squid/sarg.txt Pra instalar e configurar o Squid pra gerar os logs a serem utilizados pelo Sarg que é um utilitario gerador de relatórios sobre os arquivos de log do Squid, veja tutoriais e FAQ em: http://www.zago.eti.br/squid/A-menu-squid.html Pra visualizar os relatorios requer o servidor web rodando, veja tutoriais dicas e FAQ sobre o apache em: http://www.zago.eti.br/apache.txt Use CTRL+F para refinar a pesquisa. ************************************************* ************************************************* http://sarg.sourceforge.net/ SARG - gerador de relatorios sobre o log do Squid. Download, documentação e screenshot. Saiu a versão 2.0, agora com graficos, o desenvolvedor disponibilizou um relatório na web, conheça melhor, navegue em: http://sarg.sourceforge.net/squid-reports/index.html No CL10 já está disponivel, tanto pra atualização como também pode baixar os rpm, tem pra CL10 normal e snapshot Evite snapshot em ambiente de produção, veja mais sobre snapshot da Conectiva: http://www.zago.eti.br/apt-conectiva.txt Veja abaixo tutorial pra instalar Sarg 2.0 no CL10 ************************************************* Algumas dicas e comandos. sarg -help Pode utilizar outra instalação pra gerar os relatorios, basta fazer copia do arquivo de log /var/log/squid/access.log. Utilize ambiente de testes, utilize outra maquina ou uma estação com dual boot, nesta maquina faça a instlação do squid, apache e sarg, faça copia dos logs de outra maquina e fique à vontade pra fazer seus testes sem correr riscos, aplique em servidores de produção somente depois de dominar o processo e aprovar os resultados. ************************************************* Pra instalar no CL9 tem alguns problemas, acompanhe no Bugzilla: http://bugzilla.conectiva.com.br/show_bug.cgi?id=12821 ************************************************* CL10 -Sarg - Download via apt e instalação via rpm. Pra instalar o Sarg, requer também a instalação do servidor web (apache) e do Squid (proxy) pra gerar os relatorios que servirão de base para os relatorios do Sarg, aliás, o serviço do Sarg é gerar relatorios de utilização da internet que passou pelo proxy, estes relatórios são em formato de páginas em HTML. O Sarg não vem na versão de lançamento do CL10, antes de instalar em servidores de produção faça o download e testes outra maquina, faça copia dos logs e pra rodar o Sarg pra gerar os relatorios em outra maquina de testes pra depois instalar em servidores, a principio precisa baixar e instalar os pacotes: libgd2_.... sarg.... Pode procurar por eles nos mirrors da Conectiva, baixar e instalar via rpm, acho muito mais rápido e prático, incluir alguns mirros no sources.list usar o apt pra somente baixar o pacote, remover a alteração no sources.list e depois fazer a instalação manual via rpm, a seguir instruções detalhadas. Abiente de testes: CL10 instalado com CD da caixinha (lançamento) uname -a Linux cl10.zago.eti.br 2.6.5-63077clsmp Nesta condição o comando "apt-get install sarg" não encontra o pacote, atualize o /etc/apt/sources.list, na minha instalação acrescentei as linhas abaixo: rpm ftp://ftp.unicamp.br/pub/Conectiva 10/i386 001 002 003 extras rpm-src ftp://ftp.unicamp.br/pub/Conectiva 10/i386 001 002 003 extras rpm ftp://ftp.unicamp.br/pub/Conectiva/atualizacoes 10/i386 updates rpm-src ftp://ftp.unicamp.br/pub/Conectiva/atualizacoes 10/i386 updates Pra atualizar a lista de pacotes com os endereços acima, execute: apt-get update Prontinho, a lista de pacotes está atualizada, agora pode optar por baixar os pacotes pra instalar posteriormente ou instalar direto. Pra instalar o sarg, execute: apt-get install sarg Pra fazer somente o download execute: apt-get install --download-only sarg OBS. Pra quem alterou o sources.list somente pra baixar o Sarg e não pretente atualizar outros pacotes, pode remover as entradas que fez pra isto, caso faça a remoção precisa executar novamente "apt-get update" pra corrigir a lista de pacotes. Com a opção "--download-only" faz somente o download dos pacotes necessários, não faz a instalação, salva os arquivos em: /var/cache/apt/archives pra instalar via rpm, entre no diretório /var/cache/apt/archives e procure pelo nome do pacote que deseja instalar, execute: rpm -ivh nome do pacote ou rpm -Ivh nome do pacote Em 10 de Abril de 2005 este comando acima baixou os pacotes: libgd2_1%3a2.0.17-43827cl_i386.rpm sarg_2.0.2-58184U10%5f4cl_i386.rpm Pra poupar trabalho, pode fazer a copia do arquivo de configuração, sarg.conf, em minhas instalações não faço alterações no arquivo de configuração, simplesmente faço copia do arquivo previamente configurado, o meu sarg.conf pode não atender suas necessidades, voce pode utilizar pra testes ou comparação, faça uma copia do arquivo de configuração antes de substituir, as linhas de comando abaixo estão prontas pra copiar e colar: #Opcional pra substituir o sarg.conf da instalação por um pré-configurado cd /etc/sarg mv sarg.conf ori-sarg.conf wget http://www.zago.eti.br/modelos/sarg20.conf cp sarg20.conf sarg.conf #pra gerar os relatorios execute: sarg -f /etc/sarg/sarg.conf Prontinho, relatorios gerados, pra acessar a partir do navegador da propria maquina ou qualquer estação estação da rede, coloque na URL o IP//squid-reports/, por exemplo: http://192.168.1.3/squid-reports/ Onde o IP 192.168.1.3 é o IP da maquina onde gerou os relatorios. Precisa do servidor web (apache) rodando. Considere o uso de senhas pra acessar estes relatorios, procure neste diretório pelo FAQ senhas.txt ************************************************* CL10 - Opção via atualização. O Sarg não vem na versão de lançamento do CL10, pra instalar siga uma das opções abaixo. Baixe o CD de updates, faça o boot de instalação por ele, com CL10 instalado com perfil desktop corporativo, boot de instalação pelo CD updates-final. Atualize o /etc/apt/sources.list, na minha instalação acrescentei as linhas abaixo: rpm ftp://ftp.unicamp.br/pub/Conectiva 10/i386 001 002 003 extras rpm-src ftp://ftp.unicamp.br/pub/Conectiva 10/i386 001 002 003 extras rpm ftp://ftp.unicamp.br/pub/Conectiva/atualizacoes 10/i386 updates rpm-src ftp://ftp.unicamp.br/pub/Conectiva/atualizacoes 10/i386 updates Pra atualizar a lista de pacotes com os endereços acima, execute: apt-get update Pra instalar o sarg, execute: apt-get install sarg Em 4 de Aril de 2005 este comando instalou: sarg 2.0.2-58184U10_4cl Pra poupar trabalho, pode fazer a copia do arquivo de configuração, sarg.conf, em minhas instalações não faço alterações no arquivo de configuração, simplesmente faço copia do arquivo previamente configurado, o meu sarg.conf pode não atender suas necessidades, voce pode utilizar pra testes ou comparação, faça uma copia do arquivo de configuração antes de substituir, as linhas de comando abaixo estão prontas pra copiar e colar: #Opcional pra substituir o sarg.conf da instalação por um pré-configurado cd /etc/sarg mv sarg.conf ori-sarg.conf wget http://www.zago.eti.br/modelos/sarg20.conf cp sarg20.conf sarg.conf #pra gerar os relatorios execute: sarg -f /etc/sarg/sarg.conf Prontinho, relatorios gerados, pra acessar a partir do navegador da propria maquina ou qualquer estação estação da rede, coloque na URL o IP//squid-reports/, por exemplo: http://192.168.1.3/squid-reports/ Onde o IP 192.168.1.3 é o IP da maquina onde gerou os relatorios. Precisa do servidor web (apache) rodando. Considere o uso de senhas pra acessar estes relatorios, procure neste diretório pelo FAQ senhas.txt ************************************************* Opção via snapshot - requer atualização da instalação do CL10. Veja mais sobre o uso do snapshot em: http://www.zago.eti.br/apt-conectiva-snapshot.txt Nesta instalação do CL10 utilizei o perfil desktop corporativo. Cuidado com esta opção, vai atualizar o CL10 pra versão do snapshot e não tem volta, em instalações de teste tudo bem, em servidores de produção não recomendo. Caso queira prosseguir, altere o apt-get para o snapshot, altere o sources.list pra ficar somente com esta linha: rpm http://fr2.rpmfind.net/linux/conectiva/snapshot/ i386 all Execute: apt-get update && apt-get upgrade && apt-get dist-upgrade Vai demorar um pouco, depois da atualização instale os pacotes: apt-get install apache apt-get install libgd.so.2 apt-get install sarg Pra agilizar o teste, fiz copia do access.log de outra instalação do CL10 e também a copia do sarg.conf de outra instalação do CL10: http://www.zago.eti.br/modelos/sarg20.conf executei o sarg com esta linha de comando: sarg -f /etc/sarg/sarg.conf Prontinho, relatorios gerados em: /srv/www/default/html/squid-reports/09Oct2004-09Oct2004 Pra acessar os relatórios a partir do navegador das estações, coloque na URL o IP//squid-reports/, por exemplo: http://192.168.1.3/squid-reports/ ************************************************* ************************************************* Opção via download dos pacotes pra instalação local, _não_ precisa atualizar o CL10, basta o download e instalação dos pacotes. CL10 instalado com perfil Desktop corporativo, esta maquina não precisa estar de cara pra net mas precisa ter acesso à internet, Pode baixar os pacotes via wget ou navegador pra instalar depois ou instalar diretamente com rpm -ivh por exemplo, vá pro diretório onde salvou os arquvos e execute: rpm -ivh sarg-2.0.2-71568cl.i386.rpm Ou se preferir, pode aplicar o comando rpm -ivh (mais o endereço do pacote na net), o rpm faz o download e instala, veja exemplos abaixo. Neste tutorial utilizei a versão 2.0.2 do Sarg em 26/11/2004. (veririque antes, acesse o site indicado abaixo pra ver se alguma atualização não alterou o nome do pacote, caso afirmativo, faça a correção na linha de comando abaixo) rpm -ivh http://fr2.rpmfind.net/linux/conectiva/snapshot/conectiva/RPMS.extra/libgd2-2.0.17-43827cl.i386.rpm rpm -ivh http://fr2.rpmfind.net/linux/conectiva/snapshot/conectiva/RPMS.extra/sarg-2.0.2-73532cl.i386.rpm Pra quem já tem Sarg instalado, pra atualizar use rpm -Uvh, ex.: rpm -Uvh http://fr2.rpmfind.net/linux/conectiva/snapshot/conectiva/RPMS.extra/sarg-2.0.2-73532cl.i386.rpm #Opcional pra substituir o sarg.conf da instalação por um pré-configurado cd /etc/sarg mv sarg.conf sargoriginal.conf wget http://www.zago.eti.br/modelos/sarg20.conf cp sarg20.conf sarg.conf Cuidado com a quebra de linha. Caso não queira insatalar diretamente, exceto o apache os demais pacotes pode fazer download via wget ou acessar a URL indicada pra baixar o pacote pra depois instalar localmente. Caso não tenha arquivos de log do squid gerados no CL10 pode utilizar o do CL9, testei e funciona, em resumo, pode pegar os access.log de outra maquina e rodar com esta configuração pra gerar os logs, caso não tenha squid nesta maquina, faça copia do access.log de outra, pra facilitar crie e use o mesmo diretório /etc/squid/access.log O arquivo de configuração do Sarg fica em: /etc/sarg/sarg.conf, vem com praticamente tudo desabilitado, ele é altamente configuravel e bem comentado. Voce precisa editar este arquivo pra configuar a seu modo, pra habilitar alguma opção basta retirar a linha de comentário, caso tenha dificuldade, pode substituir o sarg.conf da instalação por outro previamente configurado desde que seja pra versão 2.0, também pode utilizar o meu sarg.conf como referencia, comparativo ou pra iniciar as alterações a partir dele, alguns detalhes não modifiquei, nem habilitei todas as opções, mas gera relatorios e o grafico de utilização, mande pro FAQ a tua configuração, basta enviar o arquivo sarg.conf pra zagolinux@uol.com.br, que disponibilizo no diretório http://www.zago.eti.br/modelos/ pra executar o Sarg: sarg -f /etc/sarg/sarg.conf Gerar Relatorio pra um dia especifico: /usr/sbin/sarg -f /etc/sarg/sarg.conf -p -d 9/10/2004-9/10/2004 Prontinho, relatorios gerados em: /srv/www/default/html/squid-reports/09Oct2004-09Oct2004 Pra acessar os relatórios a partir do navegador das estações, coloque na URL o IP//squid-reports/, por exemplo: http://192.168.1.3/squid-reports/ ************************************************* Algumas dicas, soluções e pendencias. Data nos relatorios. # TAG: date_format # Date format in reports: e (European=dd/mm/yy), u (American=mm/dd/yy), w (Weekly=yy.ww) date_format u Usando a diretiva "e" em lugar de "u" como acima, nos relatorios o grafico de download inverte o dia com mes, todos os relatorios do mes de outubro vão para o dia 10, pra acertar precisa usar a diretiva "u". Com a diretiva "u" gera o gráfico correto, mas altera o formato da data, com a diretiva "e" sai como neste exemplo: 27Oct2004-27Oct2004, com a diretiva "u" sai como neste exemplo: 2004Oct27-2004Oct27 quem achar a solução envie pro FAQ zagolinux@uol.com.br ************************************************* ************************************************* ************************************************* CL 10 Senha pra acessar relatorios do SARG. No /etc/sarg.conf tem esta tag. # TAG user_authentication yes|no # Allow user authentication in User Reports using .htaccess # Parameters: # AuthUserFile - where the user password file is # AuthName - authentication realm. Eg "Members Only" # AuthType - authenticaion type - basic # Require - authorized users to see the report. # %u - user report # # user_authentication no # AuthUserFile /usr/local/sarg/passwd # AuthName "SARG, Restricted Access" # AuthType Basic # Require user admin %u Também pode dixa-la comentada e configurar no no Apache, criar um direretório protegido por senha para os relatorios, como no exemplo a seguir. Requer servidor apache rodando, instalado o pacote: apt-get install apache-htpasswd # comando pra importar pro "vi" (veja cp.txt) # :r !lynx -dump http://www.zago.eti.br/modelos/dir-apache-sarg20 #Pra alterar o nome do diretório, altere: login="squid" #comandos pra copiar e colar login="squid-reports" senha="minhasenha" echo "#DIRETORIO A PROTEGER $login" >> /etc/apache/conf/httpd.conf echo "" >> /etc/apache/conf/httpd.conf echo "require user $login" >> /etc/apache/conf/httpd.conf echo "AuthType Basic" >> /etc/apache/conf/httpd.conf echo "AuthName "$login "" >> /etc/apache/conf/httpd.conf echo "AuthUserFile /etc/.htaccess" >> /etc/apache/conf/httpd.conf echo "" >> /etc/apache/conf/httpd.conf mkdir /srv/www/default/html/$login touch /srv/www/default/html/$login/.htaccess echo "AuthUserFile /srv/www/default/html/$login/.htpasswd" >> /srv/www/default/html/$login/.htaccess echo "AuthGroupFile /dev/null " >> /srv/www/default/html/$login/.htaccess echo "AuthName \"Area Restrita\" " >> /srv/www/default/html/$login/.htaccess echo "AuthType Basic " >> /srv/www/default/html/$login/.htaccess echo " " >> /srv/www/default/html/$login/.htaccess echo "# require valid-user " >> /srv/www/default/html/$login/.htaccess echo "require user $login " >> /srv/www/default/html/$login/.htaccess echo " " >> /srv/www/default/html/$login/.htaccess #Pra criar arquivos de senha e definir a senha, digite, ou copie e cole: htpasswd -c /etc/.htpasswd squid-reports # fim dos comandos pra copiar e colar. Pra recriar o arquivo com nova senha: htpasswd -c /etc/.htpasswd squid-reports Pra testar, reinicie o servidor apache: service apache restart no browser, coloque o ip do servidor/squid-reports/ ou o nome do diretório que voce definiu, vai pedir a senha pra listar os arquivos do diretório, ex:. http://192.168.1.3/squid-reports/ ************************************************* De: Pedro Lineu Orso Responder A: squid-br@yahoogrupos.com.br Para: squid-br@yahoogrupos.com.br Assunto: Re: [squid-br] Senha no SARG Data: Tue, 08 Mar 2005 19:46:35 -0300 Use a seguinte tag no sarg.conf para ter autenticacao: # TAG user_authentication yes|no # Allow user authentication in User Reports using .htaccess # Parameters: # AuthUserFile - where the user password file is # AuthName - authentication realm. Eg "Members Only" # AuthType - authenticaion type - basic # Require - authorized users to see the report. # %u - user report # # user_authentication no # AuthUserFile /usr/local/sarg/passwd # AuthName "SARG, Restricted Access" # AuthType Basic # Require user admin %u Pedro Orso On Tue, 2005-03-08 at 16:04 -0300, SandroMelo-CSO wrote: > Tiago Durante wrote: > > > como eu fa?o pra pedir senha qdo for entrar no sarg? > > valeu! > > User o htaccess!!! ou seja fa?a autentica??o via Apache!!! > > grato > > Sandro Melo ************************************************* De: sergio.ps Para: linux-br@bazar2.conectiva.com.br Assunto: (linux-br)Sarg Nao funciona no CL10 Data: Wed, 1 Jun 2005 15:32:32 -0300 Olá First Storm, blz ? Você não citou se dá algum erro... Verifique a diretiva access_log no seu sarg.conf e indique o local correto do access.log do Squid. O meu está em: /usr/local/squid/var/logs/access.log E verifique também o local do seu sarg.conf do Sarg. O meu está em: /usr/local/sarg/sarg.conf O ideal é usar um script para disparar o Sarg pelo Cron como abaixo: #!/bin/bash # clear HOJE=$(date --date "0 day ago" +%d/%m/%Y) /usr/bin/sarg -f /usr/local/sarg/sarg.conf -d $HOJE-$HOJE # Para o Cron: # # Editar o /etc/crontab e inserir a seguinte linha: # # 00 18 * * * root /diretório_do_script/nome_do_script # # Isso irá gerar um relatório diário às 18:00 h. Eu costumo baixar os fontes dos programas que uso, compilar e instalar. Assim eu tenho maior controle sobre o software e de quebra aprendo um pouco mais. Abraços, Sérgio. ============================================================== Caros Amigos, Eu instalei o Sarg via apt ele esta na versão: sarg version: 2.0.2 Nov-22-2004 Acontece que eu segui a risca este tutorial: http://www.devin.com.br/eitch/sarg/ e o sarg simplesmente lê o access.log e diz que não há registros. revi todas as configuraçoes e não tem nada de errado, algume sabe de algum bug ?? ************************************************* De: Andreas Hasenack Para: linux-br@bazar2.conectiva.com.br Assunto: Re: (linux-br)Sarg Nao funciona no CL10 Data: Wed, 1 Jun 2005 21:19:58 -0300 Em Quarta 01 Junho 2005 12:50, Marcelo Vivan Borro escreveu: > Em Qua 01 Jun 2005 11:17, First Storm escreveu: > > > revi todas as configuraçoes e não tem nada de errado, algume sabe de algum > bug ?? > > Aqui funciona perfeitamente. > sarg-2.0.2-58184U10_4cl Que pode ser obtido aqui: http://distro2.conectiva.com.br/atualizacoes/index.php?id=a&anuncio=000911 ************************************************* *************************************************