AWStats 的配置指令和選項主設置(必須設置)LogFile"LogFile" 包含要分析的日志文件，可以使用絕對路徑或者相對路徑(對 awstats.pl 而言) 。 比如： LogFile

AWStats 的配置指令和選項

主設置(必須設置)

LogFile

"LogFile" 包含要分析的日志文件，可以使用絕對路徑或者相對路徑(對 awstats.pl 而言) 。 比如： LogFile = /var/log/apache2/access_log

如果需要設定動態(tài)的文件名(比如日志文件名中含有該日志生成的日期) ，可以使用標簽(tags)： tags 含義

YYYY-n n小時前的年(四位，比如2006)

YY-n n小時前的年(兩位，比如06)

MM-n n小時前的月(比如01)

MO-n n小時前的月(比如Jan)

?-n n小時前的天(比如03)

HH-n n小時前的小時(比如03)

NS-n n小時前的秒(自1970年0:00以來，只精確到天，比如1136332800，是格林威治時間2006年1月4日的零點)

WM-n n小時前的周(week in month，值為01-05)(注意，文檔與實際并不一致，文檔中值為1-5，可能是個bug)

Wm-n n小時前的周(week in month，值為0-4)

WY-n n小時前的周(week in year，值為01-52)

Wy-n n小時前的周(week in year，值為00-51)

DW-n n小時前的天(day in week，值為1-7，1=sunday，如果需要使得1=monday，減去24小時就可以了。)

Dw-n n小時前的天(day in week，值為0-6，0=sunday，如果需要使得0=monday，減去24小時就可以了。)

比如：

LogFile = /var/log/apache2/access_log.YYYY-24-MM-24-?-24.txt

還可以使用管道：

LogFile = gzip -d

如果有多個日志文件需要分析(比如做了負載均衡) ，可以這樣：

LogFile = "/pathtotools/logresolvemerge.pl *.log |"

LogType

日志的類型：

W web日志

M mail日志

F ftp日志

比如：

LogT ype=W

LogFormat

日志的格式：

1 Apache 或者 Lotus Notes/Domino 的combined 日志格式

2 老的IIS 的日志格式

3 Webstar的native 日志格式

4 Apache 或者 Squid 的common 日志格式

我們還可以自己指定日志格式，下表是日志格式的各個字段

host 客戶端的主機名或者IP 地址

lognamequot Authenticated login/user with format: "alex"

logname Authenticated login/user with format: alex

time1 日期，格式為 [dd/mon/yyyy:hh:mm:ss 0000] 或 [dd/mon/yyyy:hh:mm:ss]

time2 日期，格式為 yyyy-mm-dd hh-mm-ss

time3 日期，格式為 Mon dd hh:mm:ss 或 Mon dd hh:mm:ss yyyy

time4 日期，格式為 dddddddddd(unix的時間戳)

methodurl 方法和url ，格式為："GET /index.html HTTP/x.x"

methodurlnoprot 方法和url ，格式為："GET /index.html"

method 方法，格式為：GET

url URL，格式為：/index.html

query 查詢的字符串(Query string ) ( URLWithQuery 選項要用)

code 返回的狀態(tài)碼Return code status (with format for web log: 999)

bytesd 文檔的大小(字節(jié))

refererquot Referer page，格式為："http://from.com/from.htm"

referer Referer page，格式為：http://from.com/from.htm

uaquot User agent，格式為："Mozilla/4.0 (compatible, ...)"

ua User agent，格式為：Mozilla/4.0_(compatible...)

gzipin mod_gzip comdivssion input bytes: In :XXX

gzipout mod_gzip comdivssion output bytes & ratio: Out:YYY:ZZpct.

gzipratio mod_gzip comdivssion ratio: ZZpct.

?flateratio mod_deflate comdivssion ratio with format: (ZZ)

email EMail sender (for mail log)

email_r EMail receiver (for mail log)

virtualname Web sever virtual hostname. Use this tag when same log contains data of several virtual web servers. AWStats will discard records not in SiteDomain nor HostAliases

cluster If log file is provided from several computers (merged by logresolvemerge.pl), this tag define field of cluster id.

other 如果日志文件有一些字段不被上面的列表包括，使用other

比如：

LogFormat= 1

LogFormat=

" host other logname time1 methodurl code bytesd refererquot uaquot"

LogSeparator

日志各個字段間的分隔符 比如：

LogSeparator=" "

DNSLookup

DNS 反查，可取的值如下：

0 不用DNS 反查

1 完全啟用DNS 反查

2 DNS反查只從靜態(tài)的DNS 的緩存中取得

比如：

DNSlookup=2

DirData

統(tǒng)計結果存放的目錄。

注意：如果需要直接在瀏覽器上更新統(tǒng)計結果的話，這個目錄要設為apache 用戶 (比如nobody) 可寫。 比如：

DirData="/var/lib/awstats"

DirCgi

awstats 的cgi-bin 目錄的相對或者絕對URL 路徑。

這個參數只是在命令行下使用-output 選項時才有用

比如：

DirCgi="/cgi-bin"

DirIcons

awstats 的icon 目錄的相對或者絕對URL 路徑。

比如：

DirIcons="/icon"

SiteDomain

主域名。如果日志里含有多個域名的話，AWStats 將過濾掉非此域名的訪問。(當然，你的日志格式里得含有域名的信息)

當ShowLinksOnUrl 選項設為1時，這個參數用來生成URL 路徑。

如果是分析mail 日志，這里寫上mail 服務器的域名。

比如：

SiteDomain="www.sunnavy.net"

HostAliases

可以在這里寫上其他所有可以訪問這個站點的域名，IP 等等。這些值之間用空格隔開。為了獲得最好的性能，這個參數的值越少越好。這個參數還用來分析日志里的referer 字段，以區(qū)分一個referer URL是本地的還是別的站點的。

還可以使用正則表達式(REGEX[value])，比如：

HostAliases = "localhost 127.0.0.1 REGEX[^.*.myserver.com$]"

AllowT oUpdateStatsFromBrowser

可選值為0或1。

如果設為1的話，將在報告頁面里增加一個"update now"的按鈕，這樣可以在線更新統(tǒng)計結果。 比如：

AllowToUpdateStatsFromBrowser=0

AllowFullYearView

AWStats 是按月來存放數據庫的。這使得可以很快地生成統(tǒng)計結果。如果你在命令行下選擇-month=all或者在web 上選擇-year-，AWStats 將把一年的數據全部加載以生成統(tǒng)計結果，這將耗費大量的資源。 可選值為：

0 不允許

1 只允許在命令行下使用，web 上不可見。

2 只允許在命令行下使用，web 上可見但不可用。

3 允許 比如：

AllowFullYearView=2

可選的設置(不是必需但可以增加AWStats 的功能)

EnableLockForUpdate

可選值為0或1。

如果設為1的話，當更新統(tǒng)計結果的時候，AWStats 可以在TEMP 或者TMP 目錄設置一個鎖文件，這樣可以避免同時有多個進程更新，避免可能的沖突以及DoS 攻擊。

可是，當使用鎖文件的時候，你可能會碰到鎖文件不能自動刪除的問題，就只能手動刪除，所以你需要登陸服務器的權限。

比如：

EnableLockForUpdate=0

DNSStaticCacheFile

AWStats 可以通過一個靜態(tài)(static)的DNS 緩存(cache)文件進行DNS 反查。這個文件默認的路徑為DirData ，這個文件不能改變(This file is never changed)。

DNS 文件的格式為'minsince1970 ipaddress resolved_hostname'或者只是 'ipaddress resolved_hostname'

比如：

DNSStaticCacheFile="dnscache.txt"

DNSLastUpdateCacheFile

AWStats 可以通過一個靜態(tài)(static)的DNS 緩存(cache)文件進行DNS 反查。在每次統(tǒng)計結果更新完后，這個文件會自動消除和重新生成，所以不需要手動創(chuàng)建或改變。這個文件將被放在DirData 目錄。 只有當DNSLookup=1時，這個選項才有作用。

注意：如果DNSStaticCacheFile 存在的話，AWStats 將會在檢查 DNSStaticCacheFile 完后檢查這個文件。

比如：

DNSLastUpdateCacheFile="dnscachelastupdate.txt"

SkipDNSLookupFor

可以指定某些IP 不被DNS 反查。這個選項只有在DNSLookup=1時才起作用。IP 之間用空格隔開。 注意：可以使用正則表達式。

比如：

SkipDNSLookupFor="123.123.123.123 REGEX[^192.168.]"

AllowAccessFromWebToAuthenticatedUsersOnly

可選值為0或1

接下來的這兩個選項允許你保護你的配置文件不被AWStats 訪問，如果這個AWStats 是被未經認證的web 用戶訪問的話。這樣的話，AWStats 必須被httpd 設為認證訪問。

AllowAccessFromWebToAuthenticatedUsersOnly=0

AllowAccessFromWebToFollowingAuthenticatedUsers

這個參數指定允許訪問統(tǒng)計結果的用戶名單，只有在AllowAccessFromWebToAuthenticatedUsersOnly =1時才起作用。

比如：

AllowAccessFromWebToFollowingAuthenticatedUsers="sunnavy sunhj"

AllowAccessFromWebToFollowingIPAddresses

當這個參數定義后，用戶從瀏覽器訪問統(tǒng)計結果時所用的IP 地址將被檢查是否在指定的IP 里。 比如：

AllowAccessFromWebToFollowingIPAddresses="127.0.0.1 123.123.123.1-123.123.123.255"

CreateDirDataIfNotExists

可選值為0和1。

如果DirData 目錄不存在的話，AWStats 將返回一個錯誤。我們可以讓AWStats 自行創(chuàng)建這個目錄，如果這個值設為1的話。

比如：

CreateDirDataIfNotEXists=1

BuildHistoryFormat

我們可以選擇AWStats 歷史數據庫的保存格式，"xml" 或者"text" 。

比如： BuildHistoryFormat=text

BuildReportFormat

生成的統(tǒng)計結果格式，"html" 或者"xhtml" 。

比如：

BuildReportFormat=html

SaveDatabaseFilesWithPermissionsForEveryone

數據庫文件是否對所有人可寫，可選值為0或1。如果我們想在瀏覽器上直接更新，這個值我們得設成1。 比如：

SaveDatabaseFilesWithPermissionsForEveryone=0

PurgeLogFile

是否清除已經分析過的日志文件，可選值為0或1。

比如：

PurgeLogFile=0

ArchiveLogRecords

是否將日志文件歸檔，可選值為0或1。歸檔文件放在DirData 里。

如果PurgeLogFile 設為0，則這個選項將不起作用。

ArchiveLogRecords=0

KeepBackupOfHistoricFiles

是否將歷史文件備份，可選值為0或1。

AWStats 更新時，將覆蓋舊文件，如果這期間機器出了故障的話(比如硬盤滿了) ，我們的歷史文件就會丟了?？梢詫⑦@個選項設為1來備份舊文件(備份文件以.bak 結尾)

比如：

KeepBackupOfHistoricFiles=0

DefaultFile 默認的index 頁面的文件名。

比如：

DefaultFile="index.html"

SkipHosts

分析時跳過的主機，主機之間用空格隔開。

如果日志已經做了DNS 反查，這里必須寫主機名，否則得寫IP 地址?？梢允褂谜齽t表達式。 比如：

SkipHosts="127.0.0.1 192.168.0.1"

SkipUserAgents

分析時跳過的UserAgent ，即瀏覽器的型號，不區(qū)分大小寫，型號之間用空格隔開，可以使用正則表達式。 如果你想跳過某個機器人訪問，應該更新robots.pm 文件而不這個選項。

比如： SkipUserAgents="wget curl"

SkipFiles

分析時跳過的URL ，URL 之間用空格隔開，可以使用正則表達式。

是否區(qū)分大小寫，由URLNotCaseSensitive 決定。

比如：

SkipFiles="test.html"

OnlyHosts

SkipHost 的反義詞。

比如：

OnlyHosts=""

OnlyUserAgents

SkipUserAgents 的反義詞。

比如：

OnlyUserAgents=""

OnlyFiles

OnlyFiles 的反義詞。

比如：

OnlyFiles=""

NotPageList

這個列表保存一些URL(文件擴展名) ，帶這些擴展名的URL 將被看做 "Hit Only" 而不是"Hit" 和"Page/Download"，因此將不被包括在"TOP Pages/URL report"里。

比如：

NotPageList="css js class gif jpg jpeg png bmp"

ValidHTTPCodes 有效的HTTP 返回狀態(tài)碼，在該列表之外的均列在錯誤報告的表中。

比如：

ValidHTTPCodes="200 304"

HTTP 的返回狀態(tài)碼見這里

ValidSMTPCodes

有效的SMTP 狀態(tài)碼。

比如：

ValidSMTPCodes="1 250"

AuthenticatedUsersNotCaseSensitive

認證的用戶名不區(qū)分大小寫，可選值為0或1。

比如：

AuthenticatedUsersNotCaseSensitive=0

URLNotCaseSensitive

URL 不區(qū)分大小寫，可選值為0或1。

比如：

URLNotCaseSensitive=0

URLWithAnchor

是否保留URL 中的錨。

比如：

URLWithAnchor=0

URLQuerySeparators

URL 中的查詢分隔符(QuerySeparators)。

比如：

URLQuerySeparators="?;"

URLWithQuery

是否在統(tǒng)計結果中保留查詢字符串，可選值為0或1。

如果保留，則"mypage.html?id=x"和"mypage.html?id=y"將被當作兩個不同的 URL 。

比如：

URLWithQuery=0

URLWithQueryWithOnlyFollowingParameters

僅保留本列表里的查詢字符串的參數。

只有當URLWithQuery=1時才起作用，并且不能和 URLWithQueryWithoutFollowingParameters 共同使用。

比如： URLWithQueryWithOnlyFollowingParameters="param"

URLWithQueryWithoutFollowingParameters

去掉在本列表里的查詢字符串的參數。

只有當U RLWithQuery=1時才起作用，并且不能和 URLWithQueryWithOnlyFollowingParameters 共同使用。

比如：

URLWithQueryWithoutFollowingParameters=""

URLRefererWithQuery

是否在統(tǒng)計結果中的Referer 頁面中保留查詢字符串，可選值為0或1。

如果保留，則"mypage.html?id=x"和"mypage.html?id=y"將被當作兩個不同的 Referer 頁面。 比如：

URLReferrerWithQuery=0

WarningMessages 是否打開AWStats 的提醒消息，這些消息可以幫你找出設置的問題或者幫你更好地使用AWStats ，所以打開比較好。 比如：

WarningMessages=1

ErrorMessages

當有錯誤發(fā)生時，AWStats 根據所發(fā)生的錯誤輸出信息。也可以自定義輸出的信息。

比如：

ErrorMessages=""

DebugMessages

是否打開Debug 功能。如果打開的話，當參數含debug=x時，AWStats 將輸出很多相關信息來幫助我們解決問題。

比如：

DebugMessages=0

NbOfLinesForCorruptedLog

檢查日志格式是否正確時查看前文件的多少行。如果這些行的日志都是不符和格式的， AWSTats 就認為這個日志文件的格式是不對的。

比如：

NbOfLinesForCorruptedLog=50

WrapperScript CGI 下訪問的腳本名。

比如：

WrapperScript="awstats.pl"

DecodeUA

如果web 服務器為Roxen ，則設為1，否則，設為0

比如：

DecodeUA=

MiscTrackerUrl

比如：

AWStats 可以用一個js 腳本檢測很多瀏覽器相關的選項，包括：

Screen size

Screen color depth

Java enabled

Macromedia Director plugin

Macromedia Shockwave plugin

Realplayer G2 plugin

QuickTime plugin

Mediaplayer plugin

Acrobat PDF plugin

如果要支持這個，需要把awstats_misc_tracker.js文件拷貝到web 服務器的一個目錄(比如/js/)，并在主頁的最后(之前) 加上這個：