FreeBSD Manual Pages
free-sa(1) Statistic Analyzer free-sa(1) NAME free-sa - statistic analyzer SYNOPSIS free-sa [-s|-r|-F|-h|-v|-V] [-d STARTDATE-ENDDATE | PERIODWORD] [-e AD- DRESS] [-f FILE] [-l FILE] [-o DIRECTORY] [-n NAME] DESCRIPTION Free-SA is tool that is used for statistic analysis of daemons log files. Program objectives: * Control of users traffic usage; * Help for security engineers to control internet access security policies and investigate security incidents; * Evaluate server efficiency to detect troubles with configuration; * Be crossplatform and generate W3C compliant reports. Supported log formats: * Squid 2.x native log format; * CERN/NCSA Common Log Format (CLF); * CERN/NCSA Combined Log Format (in similar to CLF way); * Postfix 2.x over syslog log format (EXPERIMENTAL); * Qmail over syslog log format (EXPERIMENTAL); * NetCache via Squid 2.x native log format (EXPERIMENTAL); * Blue Coat via Squid 2.x native log format (EXPERIMENTAL); * Communigate pro 5.x native log format (VERY EXPERIMENTAL). OPTIONS free-sa accepts the following options (you should not use more than one ac- tion option at the same time, silent default action is to generate re- ports): -d STARTDATE-ENDDATE | PERIODWORD Set period by dates range in free-sa runtime locale for reports gen- eration or remove records from log file (check '-r' option). You may omit STARTDATE or ENDDATE, but not both of them. Sign '-' is always required. You may also use next words as PERIODWORD: hour, day, week, month, quarter, year, today, yesterday, thisweek, lastweek, thismonth, lastmonth, thisyear, lastyear. -e ADDRESS Send top users report in text format to e-mail ADDRESS, if ADDRESS is '-' then report is writed to stdout. -f FILE Set file to read configuration from. -F Fix root index.html file according to reports directories presense. This option also implies rotate action. Useful after removing re- ports directories with 3rd party tools like rm(1) (this changes ac- tion). -h Show help message. -l FILE Overwrite 'log' option from free-sa configuration file, check free- sa.conf(5). -n NAME Overwrite 'name' option from free-sa configuration file, check free- sa.conf(5). -o DIRECTORY Overwrite 'targetdir' option from free-sa configuration file, check free-sa.conf(5). -s Show log file information: name, size, start and end dates (this changes action). -r Remove records from log file. You must also set period to remove with '-d' option (this changes action). -v Show version. -V Show advanced information about current free-sa build. EXAMPLES 1. Generate report for full log file period using non-default configura- tion file /usr/local/etc/free-sa/free-sa2.conf: $ free-sa -f /usr/local/etc/free-sa/free-sa2.conf 2. Generate report for full log file period of 30 days (month) ending at current date: $ free-sa -d month 3. Generate report for full log file period ending at 12/21/06 (C or POSIX runtime locale): $ free-sa -d -12/21/06 4. Generate report for full log file period starting at 21.12.2006 (ru_RU or de_DE runtime locale): $ free-sa -d 21.12.2006- 5. Show useful log file information (ru_RU runtime locale): $ free-sa -s Log file information: File name: /var/log/squid/access.log File size: 55.053.777 Start date and time: 20.02.2007 22:00:09 End date and time: 21.02.2007 02:32:01 FILES /usr/local/etc/free-sa/free-sa.conf Default free-sa configuration file. CONFORMING TO I hope that everything conform to popular standards, so you not need spe- cial browser to see reports or specific non-standard system calls (like GNU or BSD) to compile free-sa on your platform. Code ISO 9899 (C99), ANSI C, POSIX*, SVID*, SVr*, SUS* Reports W3C HTML 4.01 Transitional, CSS 2.1, SVG 1.1 SEE ALSO free-sa.conf(5), squid(8), AUTHOR Copyright (C) 1997, 2006-2013 Oleg Sapon <xsov@mail.ru> Free-SA 2.0.0b6p7 13 Nov 2013 free-sa(1)
NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXAMPLES | FILES | CONFORMING TO | SEE ALSO | AUTHOR
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=free-sa&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>