Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
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:
       o      Control of users traffic usage;
       o      Help  for	security engineers to control internet access security
	      policies and investigate security	incidents;
       o      Evaluate server efficiency to detect  troubles  with  configura-
	      tion;
       o      Be crossplatform and generate W3C	compliant reports.

   Supported log formats:
       o      Squid 2.x	native log format;
       o      CERN/NCSA	Common Log Format (CLF);
       o      CERN/NCSA	Combined Log Format (in	similar	to CLF way);
       o      Postfix 2.x over syslog log format (EXPERIMENTAL);
       o      Qmail over syslog	log format (EXPERIMENTAL);
       o      NetCache via Squid 2.x native log	format (EXPERIMENTAL);
       o      Blue Coat	via Squid 2.x native log format	(EXPERIMENTAL);
       o      Communigate pro 5.x native log format (VERY EXPERIMENTAL).

OPTIONS
       free-sa accepts the following options (you should not use more than one
       action option at	the same time, silent default action  is  to  generate
       reports):

       -d STARTDATE-ENDDATE | PERIODWORD
	      Set  period by dates range in free-sa runtime locale for reports
	      generation 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  PERIOD-
	      WORD:  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  AD-
	      DRESS 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 pre-
	      sense. This option also implies rotate action. Useful after  re-
	      moving reports directories with 3rd party	tools like rm(1) (this
	      changes action).

       -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 configu-
       ration 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
       special 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://www.freebsd.org/cgi/man.cgi?query=free-sa&sektion=1&manpath=FreeBSD+12.1-RELEASE+and+Ports>

home | help