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

AWStats 的配置指令和選項(xiàng)

主設(shè)置(必須設(shè)置)

LogFile

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

比如：

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

還可以使用管道：

LogFile = gzip -d

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

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 日志格式

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

host 客戶端的主機(jī)名或者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的時(shí)間戳)

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

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

method 方法，格式為：GET

url URL，格式為：/index.html

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

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

日志各個(gè)字段間的分隔符 比如：

LogSeparator=" "

DNSLookup

DNS 反查，可取的值如下：

0 不用DNS 反查

1 完全啟用DNS 反查

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

比如：

DNSlookup=2

DirData

統(tǒng)計(jì)結(jié)果存放的目錄。

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

DirData="/var/lib/awstats"

DirCgi

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

這個(gè)參數(shù)只是在命令行下使用-output 選項(xiàng)時(shí)才有用

比如：

DirCgi="/cgi-bin"

DirIcons

awstats 的icon 目錄的相對(duì)或者絕對(duì)URL 路徑。

比如：

DirIcons="/icon"

SiteDomain

主域名。如果日志里含有多個(gè)域名的話，AWStats 將過(guò)濾掉非此域名的訪問(wèn)。(當(dāng)然，你的日志格式里得含有域名的信息)

當(dāng)ShowLinksOnUrl 選項(xiàng)設(shè)為1時(shí)，這個(gè)參數(shù)用來(lái)生成URL 路徑。

如果是分析mail 日志，這里寫(xiě)上mail 服務(wù)器的域名。

比如：

SiteDomain="www.sunnavy.net"

HostAliases

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

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

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

AllowT oUpdateStatsFromBrowser

可選值為0或1。

如果設(shè)為1的話，將在報(bào)告頁(yè)面里增加一個(gè)"update now"的按鈕，這樣可以在線更新統(tǒng)計(jì)結(jié)果。 比如：

AllowToUpdateStatsFromBrowser=0

AllowFullYearView

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

0 不允許

1 只允許在命令行下使用，web 上不可見(jiàn)。

2 只允許在命令行下使用，web 上可見(jiàn)但不可用。

3 允許 比如：

AllowFullYearView=2

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

EnableLockForUpdate

可選值為0或1。

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

可是，當(dāng)使用鎖文件的時(shí)候，你可能會(huì)碰到鎖文件不能自動(dòng)刪除的問(wèn)題，就只能手動(dòng)刪除，所以你需要登陸服務(wù)器的權(quán)限。

比如：

EnableLockForUpdate=0

DNSStaticCacheFile

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

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

比如：

DNSStaticCacheFile="dnscache.txt"

DNSLastUpdateCacheFile

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

注意：如果DNSStaticCacheFile 存在的話，AWStats 將會(huì)在檢查 DNSStaticCacheFile 完后檢查這個(gè)文件。

比如：

DNSLastUpdateCacheFile="dnscachelastupdate.txt"

SkipDNSLookupFor

可以指定某些IP 不被DNS 反查。這個(gè)選項(xiàng)只有在DNSLookup=1時(shí)才起作用。IP 之間用空格隔開(kāi)。 注意：可以使用正則表達(dá)式。

比如：

SkipDNSLookupFor="123.123.123.123 REGEX[^192.168.]"

AllowAccessFromWebToAuthenticatedUsersOnly

可選值為0或1

接下來(lái)的這兩個(gè)選項(xiàng)允許你保護(hù)你的配置文件不被AWStats 訪問(wèn)，如果這個(gè)AWStats 是被未經(jīng)認(rèn)證的web 用戶訪問(wèn)的話。這樣的話，AWStats 必須被httpd 設(shè)為認(rèn)證訪問(wèn)。

AllowAccessFromWebToAuthenticatedUsersOnly=0

AllowAccessFromWebToFollowingAuthenticatedUsers

這個(gè)參數(shù)指定允許訪問(wèn)統(tǒng)計(jì)結(jié)果的用戶名單，只有在AllowAccessFromWebToAuthenticatedUsersOnly =1時(shí)才起作用。

比如：

AllowAccessFromWebToFollowingAuthenticatedUsers="sunnavy sunhj"

AllowAccessFromWebToFollowingIPAddresses

當(dāng)這個(gè)參數(shù)定義后，用戶從瀏覽器訪問(wèn)統(tǒng)計(jì)結(jié)果時(shí)所用的IP 地址將被檢查是否在指定的IP 里。 比如：

AllowAccessFromWebToFollowingIPAddresses="127.0.0.1 123.123.123.1-123.123.123.255"

CreateDirDataIfNotExists

可選值為0和1。

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

比如：

CreateDirDataIfNotEXists=1

BuildHistoryFormat

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

比如： BuildHistoryFormat=text

BuildReportFormat

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

比如：

BuildReportFormat=html

SaveDatabaseFilesWithPermissionsForEveryone

數(shù)據(jù)庫(kù)文件是否對(duì)所有人可寫(xiě)，可選值為0或1。如果我們想在瀏覽器上直接更新，這個(gè)值我們得設(shè)成1。 比如：

SaveDatabaseFilesWithPermissionsForEveryone=0

PurgeLogFile

是否清除已經(jīng)分析過(guò)的日志文件，可選值為0或1。

比如：

PurgeLogFile=0

ArchiveLogRecords

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

如果PurgeLogFile 設(shè)為0，則這個(gè)選項(xiàng)將不起作用。

ArchiveLogRecords=0

KeepBackupOfHistoricFiles

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

AWStats 更新時(shí)，將覆蓋舊文件，如果這期間機(jī)器出了故障的話(比如硬盤(pán)滿了) ，我們的歷史文件就會(huì)丟了。可以將這個(gè)選項(xiàng)設(shè)為1來(lái)備份舊文件(備份文件以.bak 結(jié)尾)

比如：

KeepBackupOfHistoricFiles=0

DefaultFile 默認(rèn)的index 頁(yè)面的文件名。

比如：

DefaultFile="index.html"

SkipHosts

分析時(shí)跳過(guò)的主機(jī)，主機(jī)之間用空格隔開(kāi)。

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

SkipHosts="127.0.0.1 192.168.0.1"

SkipUserAgents

分析時(shí)跳過(guò)的UserAgent ，即瀏覽器的型號(hào)，不區(qū)分大小寫(xiě)，型號(hào)之間用空格隔開(kāi)，可以使用正則表達(dá)式。 如果你想跳過(guò)某個(gè)機(jī)器人訪問(wèn)，應(yīng)該更新robots.pm 文件而不這個(gè)選項(xiàng)。

比如： SkipUserAgents="wget curl"

SkipFiles

分析時(shí)跳過(guò)的URL ，URL 之間用空格隔開(kāi)，可以使用正則表達(dá)式。

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

比如：

SkipFiles="test.html"

OnlyHosts

SkipHost 的反義詞。

比如：

OnlyHosts=""

OnlyUserAgents

SkipUserAgents 的反義詞。

比如：

OnlyUserAgents=""

OnlyFiles

OnlyFiles 的反義詞。

比如：

OnlyFiles=""

NotPageList

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

比如：

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

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

比如：

ValidHTTPCodes="200 304"

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

ValidSMTPCodes

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

比如：

ValidSMTPCodes="1 250"

AuthenticatedUsersNotCaseSensitive

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

比如：

AuthenticatedUsersNotCaseSensitive=0

URLNotCaseSensitive

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

比如：

URLNotCaseSensitive=0

URLWithAnchor

是否保留URL 中的錨。

比如：

URLWithAnchor=0

URLQuerySeparators

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

比如：

URLQuerySeparators="?;"

URLWithQuery

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

如果保留，則"mypage.html?id=x"和"mypage.html?id=y"將被當(dāng)作兩個(gè)不同的 URL 。

比如：

URLWithQuery=0

URLWithQueryWithOnlyFollowingParameters

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

只有當(dāng)URLWithQuery=1時(shí)才起作用，并且不能和 URLWithQueryWithoutFollowingParameters 共同使用。

比如： URLWithQueryWithOnlyFollowingParameters="param"

URLWithQueryWithoutFollowingParameters

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

只有當(dāng)U RLWithQuery=1時(shí)才起作用，并且不能和 URLWithQueryWithOnlyFollowingParameters 共同使用。

比如：

URLWithQueryWithoutFollowingParameters=""

URLRefererWithQuery

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

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

URLReferrerWithQuery=0

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

WarningMessages=1

ErrorMessages

當(dāng)有錯(cuò)誤發(fā)生時(shí)，AWStats 根據(jù)所發(fā)生的錯(cuò)誤輸出信息。也可以自定義輸出的信息。

比如：

ErrorMessages=""

DebugMessages

是否打開(kāi)Debug 功能。如果打開(kāi)的話，當(dāng)參數(shù)含debug=x時(shí)，AWStats 將輸出很多相關(guān)信息來(lái)幫助我們解決問(wèn)題。

比如：

DebugMessages=0

NbOfLinesForCorruptedLog

檢查日志格式是否正確時(shí)查看前文件的多少行。如果這些行的日志都是不符和格式的， AWSTats 就認(rèn)為這個(gè)日志文件的格式是不對(duì)的。

比如：

NbOfLinesForCorruptedLog=50

WrapperScript CGI 下訪問(wèn)的腳本名。

比如：

WrapperScript="awstats.pl"

DecodeUA

如果web 服務(wù)器為Roxen ，則設(shè)為1，否則，設(shè)為0

比如：

DecodeUA=

MiscTrackerUrl

比如：

AWStats 可以用一個(gè)js 腳本檢測(cè)很多瀏覽器相關(guān)的選項(xiàng)，包括：

Screen size

Screen color depth

Java enabled

Macromedia Director plugin

Macromedia Shockwave plugin

Realplayer G2 plugin

QuickTime plugin

Mediaplayer plugin

Acrobat PDF plugin

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