awstats.pl file must be saved in a web protected realm to force a visitor to enter its username/password to access AWStats
CGI program.
Example of directives you can add into Apache to have awstats.pl in a web protected realm:
<Files "awstats.pl">
AuthUserFile /path/to/.passwd
AuthGroupFile /path/to/.group
AuthName "Restricted Area For Customers"
AuthType Basic
require valid-user
</Files>
If you add such directives into a .htaccess file, you must also check that the AllowOverride directive is set to All in Apache
config file to allow the use of .htaccess files.
To known how to create a protected realm for servers other than Apache, see your web server manual.
Then edit each config/domain file you want to be protected to set AllowAccessFromWebToAuthenticatedUsersOnly to 1.
You can also edit list of authorized users in the AllowAccessFromWebToFollowingAuthenticatedUsers parameter.
You can also specify a range of allowed browsers IP Addresses with the AllowAccessFromWebToFollowingIPAddresses
parameter.
You can also set SaveDatabaseFilesWithPermissionsForEveryone parameter to 0 in all config/domain files, except if you
want to allow update from web with option AllowToUpdateStatsFromBrowser=1. But this is not recommanded as you need to
give read/write permission for Web server user on all history files (Except if you setuid AWStats script for each authorized
user, but this make setup much harder).
The following parameters ErrorMessages and DebugMessages are also parameters related to security.
Other tip: If the AWSTATS_FORCE_CONFIG environment variable is defined, AWStats will always use the config file
awstats.VALUE_OF_AWSTATS_FORCE_CONFIG.conf as the config/domain file. So if you add this environment variable
into your web server environment, for example by adding the line
SetEnv AWSTATS_FORCE_CONFIG configvalueforthisdomain
in your Apache <VirtualHost> directive group in httpd.conf (with other directives), AWStats will use the config file called
awstats.configvalueforthisdomain.conf to choose which statistics used, even if a visitor try to force the config/domain file with
the URL 'http://mydomain/cgi-bin/awstats.pl?config=otherdomain'. This might be usefull for thoose who edit their
config/domain file with AllowAccessFromWebToFollowingAuthenticatedUsers="__REMOTE_USER__" instead of
maintaining the list of authorized users into each AWStats config file.
3) NO SECURITY POLICY
Policy:
You have only one hosts or several hosts or users but you don't need to manage particular permissions for your different
config/domain statistics.
Advantage:
Setup is very easy (No need of particular setup). Statistics are dynamic.
Disadvantage:
No way to prevent stats for config/domain to be seen by a user that known the config/domain name and the url syntax to see
stats of a particular config/domain.
How:
No particular things to do (You can however easily use AllowAccessFromWebToFollowingIPAddresses parameter to have a
minimum of security).
There is a lot of possible use for AWStats combining all its options/parameters with all web servers options/parameters and
operating systems security features. Just use the one you need...
Article written by Laurent Destailleur.
Little Tips about Security
61/103
14/07/2015
Convert pdf file to text document - Convert PDF to txt files in C#.net, ASP.NET MVC, WinForms, WPF application
C# PDF to Text (TXT) Converting Library to Convert PDF to Text
convert pdf image to text; convert pdf scanned image to text
Convert pdf file to text document - VB.NET PDF Convert to Text SDK: Convert PDF to txt files in vb.net, ASP.NET MVC, WinForms, WPF application
VB.NET Guide and Sample Codes to Convert PDF to Text in .NET Project
convert pdf to word for editing text; convert pdf image to text online
Follow @awstats_project
Little Tips about Security
62/103
14/07/2015
C# PDF Text Extract Library: extract text content from PDF file in
XDoc.PDF for .NET offers advanced & mature APIs for developers to extract text content from PDF document file in C#.NET class application.
convert pdf to text on; best pdf to text converter for
VB.NET PDF Text Extract Library: extract text content from PDF
this advanced PDF Add-On, developers are able to extract target text content from source PDF document and save extracted text to other file formats through VB
batch pdf to text; convert pdf to txt online
AWStats logfile analyzer 7.4 Documentation
Frequently Asked Questions + Troubleshooting
ABOUT QUESTIONS:
FAQ-ABO100 Which server log files or operating systems are supported ?
FAQ-ABO150 Which log format can AWStats analyze ?
FAQ-ABO200 Which languages are available ? How to add my own language ?
FAQ-ABO250 Can AWStats be integrated with PHP Nuke ?
FAQ-ABO300 About AWStats history
COMMON SETUP/USAGE QUESTIONS:
Here, you can find the most common questions and answers about AWStats setup/usage process.
FAQ-COM025 How to use AWStats with no server log
FAQ-COM050 What is the log size limit AWStats can analyze ?
FAQ-COM090 Setup for FTP server log files (proftpd, vsftpd, ...).
FAQ-COM100 Setup for MAIL log files (Postfix, Sendmail, QMail, MDaemon, Exchange).
FAQ-COM110 Setup for MEDIA SERVER log files (Realmedia, Windows media, Darwin streaming server).
FAQ-COM115 Setup/Examples for LogFormat parameter.
FAQ-COM120 How to rotate my logs without losing data.
FAQ-COM130 How to run AWStats frequently ?
FAQ-COM140 How to exclude my IP address (or whole subnet mask) from stats ?
FAQ-COM142 How to get the screen size and browser capabilities report working ?
FAQ-COM145 How to use the Extra Sections features ?
FAQ-COM150 Benchmark question.
FAQ-COM200 How reverse DNS Lookup works, unresolved IP Addresses ?
FAQ-COM250 Different results than other log analyzers (Analog, Webalizer, WUsage, wwwStats...).
FAQ-COM300 Difference between local hour and AWStats reported hour.
FAQ-COM320 What does mean "eu (European country)" in GeoIP country reports.
FAQ-COM350 How can I process old log file ?
FAQ-COM360 How can I process several log files in one run ?
FAQ-COM400 How can I update my statistics when I use a load balancing system that splits my logs ?
FAQ-COM500 How can I reset all my statistics ?
FAQ-COM600 How can I compile and build statistics on a daily basis only ?
FAQ-COM700 Can I safely remove a line in AWStats history files (awstatsMMYYYY*.txt) ?
ERRORS/TROUBLESHOOTING QUESTIONS:
Here, you can find the most common questions and answers about errors or problems using AWStats.
FAQ-SET050 Error "Missing $ on loop variable ..."
FAQ-SET100 I see Perl script's source instead of its execution in my browser.
FAQ-SET150 Error "...couldn't create/spawn child process..." with Apache for windows.
FAQ-SET200 "Internal Error" or "Error 500" in a browser connecting to Apache.
FAQ-SET210 "Internal Error" after a long time in my browser (See FAQ-COM100 "AWStats speed/timeout problems").
FAQ-SET220 Crash while running awstats.pl or page content only partialy loaded
FAQ-SET270 Only corrupted/dropped records
FAQ-SET280 Error "Not same number of records of...".
FAQ-SET300 Error "Couldn't open file ..."
FAQ-SET320 Error "Malformed UTF-8 character (unexpected..."
FAQ-SET350 Empty or null statistics reported.
FAQ-SET360 Statistics reported except for os, browsers, robots and keywords/keyphrases.
FAQ-SET400 Pipe redirection to a file give me an empty file.
FAQ-SET450 No pictures/graphics shown.
FAQ-SET700 My visits are doubled for old month I migrated from 3.2 to 5.x
FAQ-SET750 AWStats run out of memory during update process with cygwin Perl.
FAQ-SET800 AWStats speed/timeout problems.
Frequently Asked Questions + Troubleshooting
63/103
14/07/2015
VB.NET PDF File Compress Library: Compress reduce PDF size in vb.
All object data. File attachment. Hidden layer content. Convert smooth lines to curves. VB.NET Demo Code to Optimize An Exist PDF File in Visual C#.NET Project.
converting pdf to editable text for; converting pdf to text
C# PDF File Split Library: Split, seperate PDF into multiple files
Visual C# .NET PDF document splitter control toolkit SDK can not only offer C# developers a professional .NET solution to split PDF document file but also
convert pdf to text; convert pdf to txt
SECURITY QUESTIONS:
Here, you can find the common questions about security problems when setting or using AWStats.
FAQ-SEC100 Can AWStats be used to make Cross Site Scripting Attacks ?
FAQ-SEC150 How can I prevent some users to see statistics of other users ?
FAQ-SEC200 How to manage log files (and statistics) corrupted by worms attacks like 'Code Red Virus like'.
FAQ-ABO100 : WHICH SERVER LOG FILES OR OS ARE SUPPORTED ?
AWStats can works with :
All web server able to write log file with a combined log format (XLF/ELF) like Apache, a common log format (CLF) like
Apache or Squid, a W3C log format like IIS 5.0 or higher, or any other log format that contains all information AWStats
expect to find.
• 
Most of all others Web/Wap/Proxy/Streaming servers.
• 
Some FTP, Syslog or Mail log files.
Because AWStats is in Perl, it can works on all Operating Systems.
Examples of used platforms (bold means 'tested by author', others were reported by AWStats users to work correctly) :
OS:
Windows 2000, Windows NT 4.0, Windows Me, Linux (RedHat, Mandrake, Debian, Suse...), Macintosh, Solaris,
Aix, BeOS, FreeBSD, ...
Web/Wap/Proxy/Streaming servers
Apache 1.3.x and 2.x, IIS 5.0 or higher, ISA, WebStar, WebLogic, WebSite, Windows Media Server, Tomcat,
Squid, Sambar, Roxen, Resin, RealMedia server, Oracle9iAS, Lotus Notes/Domino, Darwin, IPlanet, IceCast,
ZeroBrand, Zeus, Zope, Abyss...
FTP servers
ProFTPd, vsFTPd...
Mails servers
Postfix, Sendmail, QMail, Mdaemon, www4mail, ...
Perl interpreters (all Perl >= 5.005):
ActivePerl 5.6, ActivePerl 5.8, Perl 5.8, Perl 5.6, Perl 5.005, mod_perl and mod_perl2 for Apache, ...
FAQ-ABO150 : WHICH LOG FORMATS CAN AWSTATS ANALYZE ?
AWStats setup knows predefined log formats you can use to make AWStats config easier. However, you can define your
own log format, that's the reason why AWStats can analyze nearly all web, wap and proxy server log files. Some FTP
servers log files, Syslog or mail logs can also be analyzed.
The only requirement is "Your log file must contain required information".
This is very short examples of possible log format:
Apache common log format (see Note*),
Apache combined log format (known as NCSA combined log format or XLF or ELF format),
Any other personalized Apache log format,
Any IIS log format (known as W3C format),
Webstar native log format,
Realmedia server, Windows Media Server, Darwin streaming server,
ProFTPd server, vsFTPd server,
Postfix, Sendmail, QMail, Mdaemon
A lot of web/wap/proxy/streaming servers log format
*Note: Apache common log format (AWStats can now analyze such log files but such log files does not contain all
information AWStats is looking for. The problem is in the content, not in the format). I think analyzing common log files is
not interesting because there is a lot of missing information: no way to filter robots, find search engines, keywords, os,
browser. But a lot of users asked me for it, so AWStats support it. However, a lot of interesting advanced features can't
work: browsers, os's, keywords, robot detection...).
See also F.A.Q.: LOG FORMAT SETUP OR ERRORS .
FAQ-ABO200 : WHICH LANGUAGES ARE AVAILABLE ?
AWStats can make reports in 43 languages. This is a list of all of them, for last version, in alphabetical order (The code
you can use for Lang and ShowFlagLinks parameter are the ISO-639-1 language codes):
• 
Frequently Asked Questions + Troubleshooting
64/103
14/07/2015
C# PDF File Compress Library: Compress reduce PDF size in C#.net
All object data. File attachment. Hidden layer content. Convert smooth lines to curves. Flatten visible layers. C#.NET DLLs: Compress PDF Document.
convert pdf to txt file; convert pdf to txt format online
VB.NET PDF File Merge Library: Merge, append PDF files in vb.net
VB.NET Demo code to Append PDF Document. In addition, VB.NET users can append a PDF file to the end of a current PDF document and combine to a single PDF file.
convert pdf to .txt file; converting pdf to searchable text format
Albanian=al, Bosnian=ba, Brezhoneg=bzg, Bulgarian=bg, Catalan=ca, Chinese (Taiwan)=tw, Chinese
(Simpliefied)=cn, Croatian=hr, Czech=cz, Danish=dk, Dutch=nl, English=en, Estonian=et, Euskara=eu, Finnish=fi,
French=fr, Galician=gl, German=de, Greek=gr, Hebrew=he, Hungarian=hu, Icelandic=is, Indonesian=id, Italian=it,
Japanese=jp, Korean=ko, Latvian=lv, Norwegian (Nynorsk)=nn, Norwegian (Bokmal)=nb, Polish=pl, Portuguese=pt,
Portuguese (Brazilian)=br, Romanian=ro, Russian=ru, Serbian=sr, Slovak=sk, Solvenian=si, Spanish=es,
Swedish=se, Thai=th, Turkish=tr, Ukrainian=ua, Welsh=cy.
However, AWStats documentation is only provided in English.
But, you may find small documentation for other languages made by contributors on Documentation Contrib page.
If your language is not in this list, you can translate it yourself. For this, find what is your 2 letter language code: here.
Once, you get it, for example "gl" for Galician, copy the file awstats-en.txt into awstats-gl.txt, in langs directory and
translate every sentence inside. You can do same for files inside tooltips_f, tooltips_m and tooltips_w sub-directories. Then
send your translated file(s) to eldy@users.sourceforge.net.
FAQ-ABO250 : CAN AWSTATS BE INTEGRATED WITH PHP NUKE ?
The only plugin I know to integrate AWStats inside PHPNuke is here: PhpNuke addon for AWStats
FAQ-ABO300 : ABOUT AWSTATS HISTORY
AWStats was initialy designed for my own use to track visitors on my personal web sites or other projects i worked on
(www.chiensderace.comwww.chatsderace.com, www.lesbonnesannonces.com, www.pourmaplanete.com,
www.dolibarr.orgwww.nltechno.com, and www.destailleur.fr)
Then I decided to put it on sourceforge in year 2000. Then a lot of new versions were developed to add enhancements
until today. See changelog for full history of changes.
FAQ-COM025 : HOW TO USE AWSTATS WITH NO SERVER LOG FILE
PROBLEM:
I want to have AWStats statistics but i have no access to my server log file.
SOLUTION:
Because AWStats is a log analyzer, if you don't have any way to read your server log file, you have nothing to analyze and
you should not be able to use AWStats. However, this is a trick that you can use to have a log file be built. You must add a
tag to call a CGI script like pslogger into each of your web pages. This will allow you to have an artificial log file that can be
analyzed by AWStats.
You can find a Perl version of CGI pslogger enhanced by AWStats author here or a php version of CGI pslogger made by
Florent CHANTRET here.
FAQ-COM050 : WHAT IS THE LOG SIZE LIMIT AWSTATS CAN ANALYZE
PROBLEM:
I know I must run AWStats update process frequently on new log files, this means thoose files have a regular size, but for
my first update, I want/need to run update process on old log files that are very large. Is there a limit on log file size
AWStats can analyze ?
SOLUTION:
No. There is no limit in AWStats. This means you can use it on large log files (test were made on 10GB log files).
However your system (Operating System or Perl version) might have a limit. For example, you can experience size limit
errors on files larger than 2 or 4 GB. If limit is Perl only, try to use a Perl version compiled with "large file" option.
If you can't find it nor build it, you can try to use a LogFile parameter that looks like this
LogFile="cat /yourlogfilepath/yourlogfile |"
instead of
LogFile="/yourlogfilepath/yourlogfile"
FAQ-COM090 : SETUP FOR FTP SERVER LOG FILES (proftpd, vsftpd, ...)
PROBLEM:
What do I have to do to use AWStats to analyze some FTP server log files ?
SOLUTION:
AWStats can be used with some FTP server log files.
With ProFTPd:
1- Setup your server log file format:
Frequently Asked Questions + Troubleshooting
65/103
14/07/2015
VB.NET PDF File Split Library: Split, seperate PDF into multiple
Separate source PDF document file by defined page range in VB.NET class application. Divide PDF file into multiple files by outputting PDF file size.
convert pdf into text file; convert scanned pdf to word text
C# PDF File Merge Library: Merge, append PDF files in C#.net, ASP.
document file, and choose to create a new PDF file in .NET deleting, PDF document splitting, PDF page reordering and PDF page image and text extraction.
converting pdf to plain text; convert pdf to word to edit text
Modify the proftpd.conf file to add the following two lines :
LogFormat awstats "%t %h %u %m %f %s %b"     # WARNING: You must use a tab char between % tags and not a
space !
ExtendedLog /var/log/xferlog read,write awstats     # WARNING: ExtendedLog directive might need to be placed
inside a virtual host context if you use them.
Then turn off old format Transfer log:
TransferLog none     # WARNING: TransferLog directive might need to be placed inside a virtual host context if you
use them.
To have the change effective, stop your server, remove old log file /var/log/xferlog and restart the server.
Download a file by FTP and check that your new log file looks like this:
[01/Jan/2001:21:49:57 +0200] ftp.server.com user RETR /home/fileiget.txt 226 1499
2- Then setup AWStats to analyze the FTP log file:
Copy config file "awstats.model.conf" to "awstats.ftp.conf".
Modify this new config file:
LogFile="/var/log/xferlog"
LogType=F
LogFormat="%time1 %host %logname %method %url %code %bytesd"
LogSeparator="\t"
NotPageList=""
LevelForBrowsersDetection=0
LevelForOSDetection=0
LevelForRefererAnalyze=0
LevelForRobotsDetection=0
LevelForWormsDetection=0
LevelForSearchEnginesDetection=0
ShowLinksOnUrl=0
ShowMenu=1
ShowSummary=UVHB
ShowMonthStats=UVHB
ShowDaysOfMonthStats=HB
ShowDaysOfWeekStats=HB
ShowHoursStats=HB
ShowDomainsStats=HB
ShowHostsStats=HBL
ShowAuthenticatedUsers=HBL
ShowRobotsStats=0
ShowEMailSenders=0
ShowEMailReceivers=0
ShowSessionsStats=1
ShowPagesStats=PBEX
ShowFileTypesStats=HB
ShowFileSizesStats=0
ShowBrowsersStats=0
ShowOSStats=0
ShowOriginStats=0
ShowKeyphrasesStats=0
ShowKeywordsStats=0
ShowMiscStats=0
ShowHTTPErrorsStats=0
ShowSMTPErrorsStats=0
Now you can use AWStats as usual (run the update process and read statistics).
With vsFTPd, or any FTP server that log with xferlog format:
1- Check your server log file format:
Take a look at your FTP server log file. You must have a format that match the following example to use this FAQ :
Wed Jan 01 19:29:35 2001 1 192.168.1.1 102 /home/file1.txt b _ o r username ftp 0 * c
Frequently Asked Questions + Troubleshooting
66/103
14/07/2015
2- Then setup AWStats to analyze the FTP log file:
If your FTP log file format looks good, copy config file "awstats.model.conf" to "awstats.ftp.conf".
Modify this new config file:
LogFile="/var/log/xferlog"
LogType=F
LogFormat="%time3 %other %host %bytesd %url %other %other %method %other %logname %other %code
%other %other"
LogSeparator="\s"
NotPageList=""
LevelForBrowsersDetection=0
LevelForOSDetection=0
LevelForRefererAnalyze=0
LevelForRobotsDetection=0
LevelForWormsDetection=0
LevelForSearchEnginesDetection=0
ShowLinksOnUrl=0
ShowMenu=1
ShowSummary=UVHB
ShowMonthStats=UVHB
ShowDaysOfMonthStats=HB
ShowDaysOfWeekStats=HB
ShowHoursStats=HB
ShowDomainsStats=HB
ShowHostsStats=HBL
ShowAuthenticatedUsers=HBL
ShowRobotsStats=0
ShowEMailSenders=0
ShowEMailReceivers=0
ShowSessionsStats=1
ShowPagesStats=PBEX
ShowFileTypesStats=HB
ShowFileSizesStats=0
ShowBrowsersStats=0
ShowOSStats=0
ShowOriginStats=0
ShowKeyphrasesStats=0
ShowKeywordsStats=0
ShowMiscStats=0
ShowHTTPErrorsStats=0
ShowSMTPErrorsStats=0
Now you can use AWStats as usual (run the update process and read statistics).
FAQ-COM100 : SETUP FOR MAIL LOG FILES (Postfix, Sendmail, Qmail, MDaemon, Exchange...)
PROBLEM:
What do I have to do to use AWStats to analyze my mail log files ?
SOLUTION:
This tip works with AWStats 5.5 or higher.
For Postfix, Sendmail, QMail or MDaemon log files
You must setup AWStats to use a mail log file preprocessor (maillogconvert.pl is provided into AWStats tools directory, but
you can use the one of your choice):
For this, copy config "awstats.model.conf" file to "awstats.mail.conf".
Modify this new config file: For standard Postfix, Sendmail, MDaemon and standard QMail logfiles, set
LogFile="perl /path/to/maillogconvert.pl standard < /pathtomaillog/maillog |"
If the logfiles are compressed, they can be processed this way
LogFile="gzip -cd /var/log/maillog.0.gz | /path/to/maillogconvert.pl standard |"
And for VAdmin QMail logfiles (multi-host/virtualhost mail servers running vadmin software), set
LogFile="perl /path/to/maillogconvert.pl vadmin < /pathtomaillog/maillog |"
Frequently Asked Questions + Troubleshooting
67/103
14/07/2015
Then, whatever is you mail server, you must also change:
LogType=M
LogFormat="%time2 %email %email_r %host %host_r %method %url %code %bytesd"
LevelForBrowsersDetection=0
LevelForOSDetection=0
LevelForRefererAnalyze=0
LevelForRobotsDetection=0
LevelForWormsDetection=0
LevelForSearchEnginesDetection=0
LevelForFileTypesDetection=0
ShowMenu=1
ShowSummary=HB
ShowMonthStats=HB
ShowDaysOfMonthStats=HB
ShowDaysOfWeekStats=HB
ShowHoursStats=HB
ShowDomainsStats=0
ShowHostsStats=HBL
ShowAuthenticatedUsers=0
ShowRobotsStats=0
ShowEMailSenders=HBML
ShowEMailReceivers=HBML
ShowSessionsStats=0
ShowPagesStats=0
ShowFileTypesStats=0
ShowFileSizesStats=0
ShowBrowsersStats=0
ShowOSStats=0
ShowOriginStats=0
ShowKeyphrasesStats=0
ShowKeywordsStats=0
ShowMiscStats=0
ShowHTTPErrorsStats=0
ShowSMTPErrorsStats=1
Warning: For MDaemon mail server, you must use the new MDaemon log file that ends with "-Statistics.log".
Now you can use AWStats as usual (run the update process and read statistics).
For Exchange log files
Despite the high number of possible log format provided with Exchange, none of them is built enough seriously to offer an
interseting analyze (missing informations, messy data, no id to join multiple records for same mail, etc...). For this reason,
an "exact" log analysis is a joke with Exchange log files. However a little support is provided. In order to analyze Exchange
traffic, you have to enable "Message Tracking" (see article
http://support.microsoft.com/default.aspx?scid=kb;EN-US;246856).
Then copy config awstats.model.conf file to "awstats.mail.conf".
Modify this new config file:
LogType=M
LogFormat="%time2 %email %email_r %host %host_r %method %url %code %bytesd"
LevelForBrowsersDetection=0
LevelForOSDetection=0
LevelForRefererAnalyze=0
LevelForRobotsDetection=0
LevelForWormsDetection=0
LevelForSearchEnginesDetection=0
LevelForFileTypesDetection=0
ShowMenu=1
ShowSummary=HB
ShowMonthStats=HB
ShowDaysOfMonthStats=HB
ShowDaysOfWeekStats=HB
ShowHoursStats=HB
ShowDomainsStats=0
ShowHostsStats=HBL
Frequently Asked Questions + Troubleshooting
68/103
14/07/2015
ShowAuthenticatedUsers=0
ShowRobotsStats=0
ShowEMailSenders=HBML
ShowEMailReceivers=HBML
ShowSessionsStats=0
ShowPagesStats=0
ShowFileTypesStats=0
ShowFileSizesStats=0
ShowBrowsersStats=0
ShowOSStats=0
ShowOriginStats=0
ShowKeyphrasesStats=0
ShowKeywordsStats=0
ShowMiscStats=0
ShowHTTPErrorsStats=0
ShowSMTPErrorsStats=1
Also don't forget that with Exchange, informations in a log analyses can't be exact. Do not send any questions or requests
for using AWStats with Exchange, this is not a problem in AWStats and we have no time to support non opened products.
If you want to have complete and accurate information with Exchange, forget using AWStats or use a more serious mail
serveur (Postfix, Sendmail, QMail...)
FAQ-COM110 : SETUP FOR A MEDIA SERVER (REALMEDIA, WINDOWS MEDIA SERVER, DARWIN STREAMING
SERVER)
PROBLEM:
What do I have to do to use AWStats to analyze my Media Server log files.
SOLUTION:
For Realmedia
Your log file will probably looks like this:
216.125.146.50 - - [16/Sep/2002:14:57:21 -0500] "GET cme/rhythmcity/rcitycaddy.rm?cloakport=8080,554,7070
RTSP/1.0" 200 6672 [Win95_4.0_6.0.9.374_play32_NS80_en-US_586] [80d280e1-c9ae-11d6-fa53-d52aaed98681]
[UNKNOWN] 281712 141 3 0 0 494
Copy config awstats.model.conf file to "awstats.mediaserver.conf". Modify this new config file:
LogFile="/pathtomediaserverlog/mediaserverlog"
LogType=S
LogFormat="%host %other %logname %time1 %methodurl %code %bytesd %uabracket %other %other %other
%other %other %other %other %other"
LogSeparator="\s+"
ShowMenu=1
ShowSummary=UHB
ShowMonthStats=UHB
ShowDaysOfMonthStats=HB
ShowDaysOfWeekStats=HB
ShowHoursStats=HB
ShowDomainsStats=HB
ShowHostsStats=HBL
ShowAuthenticatedUsers=0
ShowRobotsStats=0
ShowEMailSenders=0
ShowEMailReceivers=0
ShowSessionsStats=0
ShowPagesStats=PB
ShowFileTypesStats=HB
ShowFileSizesStats=0
ShowBrowsersStats=1
ShowOSStats=1
ShowOriginStats=H
ShowKeyphrasesStats=0
ShowKeywordsStats=0
ShowMiscStats=0
ShowHTTPErrorsStats=1
Frequently Asked Questions + Troubleshooting
69/103
14/07/2015
ShowSMTPErrorsStats=0
Now you can use AWStats as usual (run the update process and read statistics).
For Windows Media Server / Darwin Streaming Server
1- If your Windows Media / Darwin streaming Server version allows it, setup your log format to write the following fields:
c-ip
date
time
cs-uri-stem
c-starttime
x-duration
c-rate
c-status
c-playerid
c-playerversion
c-playerlanguage
cs(User-Agent)
cs(Referer)
c-hostexe
c-hostexever
c-os
c-osversion
c-cpu
filelength
filesize
avgbandwidth
protocol
transport
audiocodec
videocodec
channelURL
sc-bytes
To make the change effective, stop your server, remove old log files and restart the server.
Listen to streaming files and check that your new log file looks like this:
80.223.91.37 2002-10-08 14:18:58 mmst://mydomain.com/mystream 0 106 1 200
{F4A826EE-FA46-480F-A49B-76786320FC6B} 8.0.0.4477 fi-FI - - wmplayer.exe 8.0.0.4477 Windows_2000
5.1.0.2600 Pentium 0 0 20702 mms TCP Windows_Media_Audio_9 - - 277721
If your Windows Media/Darwin Streaming Server version does not allow to define your log format:
Just follow instructions in step 2 directly but use the log format string found in first lines of your log files (Just after the
"#Fields:" string) as value for AWStats LogFormat parameter. For example, you could have a LogFormat defined like this:
LogFormat="c-ip date time c-dns cs-uri-stem c-starttime x-duration c-rate c-status c-playerid c-playerversion
c-playerlanguage cs(User-Agent) cs(Referer) c-hostexe c-hostexever c-os c-osversion c-cpu filelength filesize
avgbandwidth protocol transport audiocodec videocodec channelURL sc-bytes c-bytes s-pkts-sent c-pkts-received
c-pkts-lost-client c-pkts-lost-net c-pkts-lost-cont-net c-resendreqs c-pkts-recovered-ECC c-pkts-recovered-resent
c-buffercount c-totalbuffertime c-quality s-ip s-dns s-totalclients s-cpu-util"
This means you don't use the AWStats tags but AWStats can often also understand all the IIS and/or Windows Media
Server tags.
2- Then setup AWStats to analyze your Media Server log:
Copy config awstats.model.conf file to "awstats.mediaserver.conf".
Modify this new config file:
LogFile="/pathtomediaserver/mediaserverlog"
LogType=S
LogFormat="c-ip date time cs-uri-stem c-starttime x-duration c-rate c-status c-playerid c-playerversion
c-playerlanguage cs(User-Agent) cs(Referer) c-hostexe c-hostexever c-os c-osversion c-cpu filelength filesize
avgbandwidth protocol transport audiocodec videocodec channelURL sc-bytes"
DecodeUA=1
ShowMenu=1
Frequently Asked Questions + Troubleshooting
70/103
14/07/2015
Documents you may be interested
Documents you may be interested