Sarg

From SME Server
Jump to navigationJump to search







sarg
NeedImage.svg
sarg logo
MaintainerStephdl
Urlhttp://sarg.sourceforge.net/
Source: smeserver-sarg
LicenceGNU General Public License version 2.0 (GPLv2)
Category

Administration

Tags MonitoringDungog



Sarg for SME Server

Maintainer

Stéphane de Labrusse AKA Stephdl

smeserver-sarg was was originally developed by Michel Van hees aka MasterSleepy, http://www.vanhees.cc Thanks Michel

Dungog (Software)

Description

Sarg - Squid Analysis Report Generator is a tool that allow you to view "where" your users are going to on the Internet. Sarg generate HTML reports, with informations about users, IP Addresses, bytes, sites and times.

Sarg provides comprehensive reporting on the Squid web proxy usage.

Version

smecontribs-testing 11:
smeserver-sarg
The latest version of smeserver-sarg is available in the SME repository, click on the version number(s) for more information.


smecontribs 11:
smedev 10:
sarg
The latest version of sarg is available in the SME repository, click on the version number(s) for more information.


stephdl

Installation

for sme8

This contrib can be found in the smecontribs repository.

yum --enablerepo=smecontribs install smeserver-sarg

No need to reboot.

Open yourserver/server-manager in a web browser

Administration > SARG reports

for sme9

You need to activate Stephdl

db yum_repositories set stephdl repository \
    BaseURL http://mirror.de-labrusse.fr/smeserver/\$releasever \
    EnableGroups no \
    GPGCheck yes \
    Name "Mirror de Labrusse" \
    GPGKey http://mirror.de-labrusse.fr/RPM-GPG-KEY \
    Visible yes \
    status disabled

and

signal-event yum-modify

then

yum --enablerepo=stephdl install smeserver-sarg
signal-event sarg-update
config set UnsavedChanges no

No need to reboot.

Open yourserver/server-manager in a web browser

Administration > SARG reports

Uninstall

rpm -e  sarg smeserver-sarg

Additional information

http://sarg.sourceforge.net/sarg.php

User Identification

Enable Squid authentication for users to be correctly logged, see http://wiki.contribs.org/Dansguardian#Configuring_Proxy_to_use_Auth_login

Dansguardian

set sarg to use dansguardian logs

/usr/bin/sarglog dansguardian

also set dansguardian to save logs in squid format
edit /etc/dansguardian/dansguardian.conf and change following value:

logfileformat = 3

logs in dansguardian format are ignored, (you may need to force a rotation)

Sarg Options

optional settings for sarg, first option is default

config setprop sarg language [English|Dutch|French|German|Spanish|Italian|...]
config setprop sarg values [bytes|abbreviation]
config setprop sarg logfile [squid|dansguardian]
config setprop sarg lastlog [0|365|num.of.days.to.keep.logs]

expand-templates with

/usr/bin/sarglog

Troubleshooting

The first time you try to run reports from the Sarg server manager panel, you may receive errors, saying their is no data available.

Run the following commands to update sarg from the log files.

/usr/bin/sarg
/etc/cron.daily/sarg
/etc/cron.weekly/sarg
/etc/cron.monthly/sarg

Bugs

Please raise bugs under the SME-Contribs section in bugzilla and select the smeserver-sarg component or use this link


IDProductVersionStatusSummary (9 tasks)
12022SME Contribs10.0CONFIRMEDadd contrib to backup list [smeserver-sarg]
9816SME Contribs8.2UNCONFIRMEDSarg Segmentation fault
9735SME Contribs9.1UNCONFIRMEDsquid report generator
8999SME Contribs8.1CONFIRMEDsarg 2.2.3.1 x64 segmentation error
8910SME Contribs9.0CONFIRMEDSARG uses only the last access.log: rotated files are named unexpectedly
8736SME Contribs9.0UNCONFIRMEDSarg report missing day.
8734SME Contribs8.2CONFIRMEDAdding french translation to sarg contribs
5853SME Contribs7.4CONFIRMEDhowto refresh sarg info
2931SME Contribs7.1CONFIRMEDPromted for username and password after loggin into server-manager

Changelog

Only versions released in smecontrib are listed here.



Tested software versions

  • Host: SME Server v7.2, v7.5.1
  • Installed: smeserver-sarg 2.2.1-6.el4.sme
  • Dependency Installed: sarg 2.2.3.1-1.el4.rf
  • Dependency Installed: gd 2.0.28-5.4E.el4_8.1