| Sun ONE Web Server 6.1 管理員指南 |
第 10 章
使用日誌檔您可以使用幾種不同的方法來監視伺服器的活動。本章論述了透過記錄和檢視日誌檔監視伺服器的方式。如需關於使用建立效能監視服務、服務品質功能或 SNMP 的資訊，請參閱監視伺服器。
本章包含下列章節：
關於日誌檔伺服器日誌檔可記錄伺服器的活動。可以使用這些日誌來監視伺服器以及幫助您進行疑難排解。錯誤日誌檔位於伺服器根目錄下的 https-server_name/logs/errors 中，列示了伺服器遇到的所有錯誤。存取日誌位於伺服器根目錄下的 https-server_name/logs/access 中，記錄了關於對伺服器的請求及伺服器回應的資訊。您可以配置 Sun ONE Web Server access 日誌檔中記錄的資訊。請使用日誌分析器來產生伺服器統計資料。您可以透過歸檔伺服器的錯誤日誌檔和存取日誌檔，對其進行備份。
在 UNIX 和 Windows 平台上記錄本節論述日誌檔的建立方法。另外，本節還包括下列主題︰
預設錯誤記錄
在 UNIX 和 Windows 平台上，管理伺服器的日誌收集在管理伺服器的 https-admserve/logs/ 目錄中。伺服器實例的日誌收集在 https-server_name/logs/ 目錄中。
可以設定整個伺服器的預設日誌層級。您可以將 stdout 和 stderr 重新導向至伺服器的事件日誌，並將日誌輸出導向至作業系統的系統日誌。此外，您也可將 stdout 和 stderr 內容導向至伺服器的事件日誌。依預設，日誌訊息除傳送至指定的伺服器日誌檔以外，也傳送至 stderr。
另一個可用功能是在日誌訊息中記錄虛擬伺服器 ID。在使用多個虛擬伺服器將訊息記錄至同一個日誌檔時，此功能非常有用。您可以選擇將日誌訊息寫入系統日誌。若這樣做，在錯誤日誌檔上將不執行記錄。相反，UNIX 上的 syslog 記錄服務、或 Windows 平台上的系統記錄服務將用於產生和管理日誌。
您也可以使用 server.xml 屬性控制該檔案的內容。如需有關 server.xml 檔案的詳細資訊，請參閱「Sun ONE Web Server 6.1 Administrator’s Configuration File Reference」。
使用 syslog 進行記錄
對於需要集中記錄的穩定作業環境而言，syslog 是適用的。對於經常需要輸出日誌以便診斷和除錯的環境而言，個別伺服器實例或虛擬伺服器日誌可能更容易管理。
使用 syslog 日誌檔，並結合 syslogd 以及系統日誌常駐程式，您可以將 syslog.conf 檔案配置為︰
由於記錄至 syslog 意味著 Sun ONE Web Server 和其他常駐應用程式的日誌都被收集在同一個檔案中，所以，藉由下列資訊增強記錄的訊息，以識別特定伺服器或虛擬伺服器實例的 Sun ONE Web Server 特有訊息︰
在 server.xml 檔案中可以配置管理伺服器與伺服器實例的 LOG 元素。
如需關於 UNIX 作業環境中使用的 syslog 記錄機制的更多資訊，請於終端提示處使用下列線上援助指令︰
man syslog
man syslogd
man syslog.conf
使用 Windows 事件日誌記錄
如需關於 Windows 作業環境使用的事件日誌機制的更多資訊，請參閱 Windows 說明系統索引，查找關鍵字「事件記錄」。
日誌層級下表按照嚴重性從低到高的次序，定義了 Sun ONE Web Server 的日誌層級和訊息。
關於虛擬伺服器和記錄Sun ONE Web Server 可以有虛擬伺服器實例。Sun ONE Web Server 實例內的每個虛擬伺服器都有自己的識別身份，還可能有自己的日誌檔。使用每個虛擬伺服器的個別日誌檔，可以幫助追蹤針對特定異動和資源的伺服器活動。
您也可以將記錄的訊息從多重虛擬伺服器導入到一個伺服器日誌檔中。若這樣做，您可能想在 server.xml 檔案的 LOG 元素內啟用 logvsid。這可幫助使用者識別來自不同虛擬伺服器的日誌訊息。
<SERVER>
...
<LOG file="/export//https-iws-files2.red.iplanet.com/logs/errors" loglevel="finest" logtoconsole="true" usesyslog="false" createconsole="false" logstderr="true" logstdout="true" logvsid="true"/>
</SERVER>
在此範例中，<LOG logvsid="true"> 用於在每條日誌訊息中含括虛擬伺服器 ID。這可讓您鑑別來自不同虛擬伺服器的訊息。在 VS 元素內缺失屬性 errorlog，會導致所有虛擬伺服器將訊息記錄至單一檔案。
重新導向應用程式與伺服器日誌輸出對於開發人員而言，在 Web 應用程式元件與 J2EE 應用程式的單元測試期間，應用程式記錄和伺服器日誌必須隨時可用。在 Windows 平台上，開發人員更希望看到日誌訊息顯示在桌面的指令視窗中。在 UNIX 平台上，許多開發人員樂意讓日誌訊息簡單地流向可啟動伺服器實例的終端機視窗中的 stderr，或者，使用指令 tail -f 查看日誌檔內寫入的日誌訊息。
server.xml 檔案包含可為 stdout 與 stderr 設定的屬性，以便將記錄的訊息導向至日誌檔或終端機視窗等。請參閱「Sun ONE Web Server 6.1 Administrator’s Configuration File Reference」，以取得關於使用 stdout 和 stderr 的更多資訊。
歸檔日誌檔您可以將存取日誌檔和錯誤日誌檔設定為自動歸檔。在某一時間，或者在指定間隔後，您的日誌將重新開始記錄。Sun ONE Web Server 可儲存舊日誌檔，並以含有儲存日期及時間的名稱標示已儲存的檔案。
例如，您可以將存取日誌檔設定為每隔一小時就重新開始記錄，然後 Sun ONE Web Server 儲存並命名檔案「access.200307152400」，其中將日誌檔名稱、年、月、日、以及 24 小時制時間連在一起，組成一個單一字元字串。依據您設定的日誌循環類型的不同，日誌歸檔檔案的確切格式也會不同。
Sun ONE Web Server 提供兩種用於歸檔檔案的日誌循環類型︰內部常駐程式日誌循環與基於 Cron 的日誌循環。
內部常駐程式日誌循環
這種日誌循環類型發生在 HTTP 常駐程式內，且只能在啟動時配置。內部常駐程式日誌循環可讓伺服器在無需重新啟動的情況下，於內部重新開始記錄日誌。使用此方法重新記錄的日誌將以下列格式儲存︰
access.<YYYY><MM><DD><HHMM>
error. <YYYY><MM><DD><HHMM>
您可以指定開啟新日誌檔，重新開始記錄日誌的基準時間。例如，如果循環開始時間是 12:00 a.m.，循環間隔為 1440 分鐘 (一日)，則在您儲存並套用變更後將立即建立新的日誌檔，而不考量目前時間。日誌檔每天都會在 12:00 a.m. 重新開始，存取日誌在 12:00 a.m. 標示，並另存為 access.200307152400。同樣，如果您將間隔設定為 240 分鐘 (4 個小時)，4 個小時的間隔開始於 12:00 a.m.，這樣存取日誌檔將包含從 12:00 a.m. 到 4:00 a.m.、從 4:00 a.m. 到 8:00 a.m. 收集的資訊，以此類推。
如果啟用了日誌循環，日誌檔循環將於伺服器啟動之時開始。要循環的第一個日誌檔將從目前時間到下一個循環時間收集資訊。使用上述範例，如果您將開始時間設定在 12:00 a.m.，將循環間隔設定為 240 分鐘，目前時間為 6:00 a.m.，則要循環的第一個日誌檔將包含從 6:00 a.m. 到 8:00 a.m. 收集的資訊，下一個日誌檔將包含從 8:00 a.m. 到 12:00 p.m. (午時) 的資訊，以此類推。
基於排程程式的日誌循環
此類日誌循環基於 server_root/https-admserv/config/ 目錄中 scheduler.conf 檔案內儲存的時間。這種方法可讓您立即歸檔日誌檔或在特定日期的特定時間使用伺服器來歸檔日誌檔。伺服器的排程程式配置選項儲存在 server_root/https-admserv/config/ 目錄下的 schedulerd.conf 中。使用基於排程程式方法循環的日誌將以下列格式儲存︰
<原始檔名>.<YYYY><MM><DD><HHMM>
例如，若在 4:30 p.m. 循環 access，其可能成為 access.200307151630。
伺服器啟動時，將初始化日誌循環。如果開啟旋轉功能，Sun ONE Web Server 會建立有時間戳記的存取日誌檔，並且旋轉將在伺服器啟動之時開始。
開始循環後，若發生需要記錄到存取日誌檔或錯誤日誌檔的請求或錯誤，並且它們發生在預先排程的「下一個旋轉時間」之後，則 Sun ONE Web Server 會建立新的時間戳記日誌檔。
若要歸檔日誌檔並指定使用內部常駐程式方法還是使用基於排程程式的方法，請使用 [Server Manager] 中的 [Archive Log Files] 頁面。
設定存取日誌喜好設定在安裝期間，將為伺服器建立名為 access 的存取日誌檔。您可以透過指定是否記錄存取、使用什麼格式記錄、以及當用戶端存取資源時伺服器是否應花時間查找用戶端領域名稱，來自訂對任何資源的存取記錄。
將 %vsid% 增加到日誌檔格式字串中︰
變更現有日誌檔的格式時，您應首先刪除/重新命名現有日誌檔或使用其他檔名。
伺服器存取日誌可以使用共用日誌檔格式、靈活日誌格式或您的可自訂格式。共用日誌檔格式為通常受支援的格式，可提供固定數量的伺服器資訊。靈活日誌格式可讓您選擇 (從 Sun ONE Web Server 中) 要記錄的內容。可自訂格式使用您指定的參數區段來控制記錄的內容。如需可自訂格式參數的清單，請參閱「NSAPI Programmer's Guide」。
一旦建立了資源的存取日誌，您便無法變更其格式，除非將其歸檔或為該資源建立新的存取日誌檔。
您可以使用 Server Manager 中的 [Access Log Preferences] 頁面來指定記錄喜好設定，或手動配置 obj.conf 檔案中的下列指令。在 magnus.conf 中，伺服器將呼叫函式 flex-init 來初始化靈活的記錄系統，並呼叫函式 flex-log 以便使用靈活日誌格式記錄請求特有的資料。若要使用共用日誌檔格式記錄請求，伺服器將呼叫 init-clf 來初始化 obj.conf 中使用的 Common Log 子系統，並呼叫 common-log 以便使用共用日誌格式 (為大多數 HTTP 伺服器使用) 記錄請求特有的資料。
如需關於 NSAPI 記錄函式的更多資訊 (包括有效指令和參數)，請參閱「NSAPI Programmer's Guide」。
簡便的 Cookie 記錄
Sun ONE Web Server 提供了使用 flexlog 功能記錄特定 cookie 的簡便方式。將「Req->headers.cookie.cookie_name」增加至配置檔案 obj.conf 中初始化 flex-log 子系統的行內。如果請求標頭中提供了 cookie 變數 cookie_name，這樣將記錄此 cookie 變數的值；如果未提供，將記錄「-」。
設定錯誤記錄選項Sun ONE Web Server 6.1 可讓您配置要記錄在伺服器錯誤日誌中的資訊。
對於 Administration Server 實例
對於伺服器實例
配置 LOG 元素下表描述了您可在 server.xml 檔案中配置的 LOG 元素的屬性︰
檢視存取日誌檔您可以檢視伺服器的作用中存取日誌檔和已歸檔存取日誌檔。
若要從 [Administration Server] 檢視它的存取日誌，請選擇 [Preferences] 標籤，然後選擇 [View Access Log] 頁面。
若要從 [Server Manager] 檢視伺服器實例的存取日誌，請選擇 [Logs] 標籤，然後選擇 [View Access Log] 頁面
若要從 [Class Manager] 中檢視個別虛擬伺服器的存取日誌，請從亮顯的 [Manage Virtual Servers] 頁面中選取要管理的虛擬伺服器，然後按一下 [Virtual Server Manager] 頁面上標題 [Access Log] 下的連結。您可以指定要檢視的項目數或帶有您選擇的條件限定符號的項目數。
以下是使用共用日誌檔格式 (您可在 [Log Preferences] 視窗中指定此格式﹔請參閱設定存取日誌喜好設定，以取得更多資訊) 的存取日誌範例：
表 10-3 描述此存取日誌範例的最後一行。
表 10-3 此存取日誌檔範例最後一行中的欄位
存取日誌欄位
範例
用戶端的主機名稱或 IP 位址
arrow.a.com。(在此情況下，將顯示主機名稱，因為啟用了 Web 伺服器的 DNS 查找設定；如果停用了 DNS 查找，將顯示用戶端的 IP 位址。)
RFC 931 資訊
- (未執行 RFC 931 識別)
使用者名稱
john (用戶端輸入的用於認證的使用者名稱)
請求的日期/時間
29/Mar/1999:4:36:53 -0800
請求
GET /help
協定
HTTP/1.0
狀態碼
401
傳輸的位元組
571
以下是使用靈活記錄格式 (您可在 [Log Preferences] 頁面中指定此格式；請參閱設定存取日誌喜好設定，以取得更多資訊) 的存取日誌範例︰
wiley.a.com - - [25/Mar/2001:12:55:26 -0800] "GET /index.htm HTTP/1.0" "GET" "/?-" "HTTP/ 1.0" 304 0 - Mozilla/2.0 (WinNT; I)
wiley.a.com - - [25/Mar/2001:12:55:26 -0800] "GET / HTTP/1.0" "GET" "/?-" "HTTP/1.0" 304 0 - Mozilla/2.0 (WinNT; I)
wiley.a.com - - [25/Mar/2001:12:55:26 -0800] "GET / HTTP/1.0" "GET" "/?-" "HTTP/1.0" 304 0 - Mozilla/2.0 (X11; I; IRIX 5.3 IP22)
檢視錯誤日誌檔錯誤日誌檔包含自建立日誌檔以來伺服器遇到的錯誤；也包含關於伺服器的資訊訊息，如啟動伺服器的時間。錯誤日誌中還記錄未成功的使用者認證。請使用錯誤日誌尋找中斷的 URL 路徑或遺漏的檔案。
若要從 [Administration Server] 中檢視它的錯誤日誌檔，請選擇 [Preferences] 標籤，然後選擇 [View Error Log] 頁面。
若要從 [Server Manager] 中檢視伺服器實例的錯誤日誌檔，請選擇 [Logs] 標籤，然後選擇 [View Error Log] 頁面。
若要從 [Class Manager] 中檢視個別虛擬伺服器的錯誤日誌，請從亮顯的 [Manage Virtual Servers] 頁面中選取要管理的虛擬伺服器，然後按一下 [Virtual Server Manager] 頁面上標題 [Error Log] 下的連結。您可以指定要檢視的項目數或帶有您選擇的條件限定符號的項目數。
以下是錯誤日誌項目的兩個範例：第一個範例顯示了指出伺服器啟動成功的資訊訊息，第二個範例指出用戶端 wiley.a.com 請求檔案 report.html，但該檔案不在伺服器的主文件目錄中。
[[22/Jan/2001:14:31:41] info (39700):successful server startup [22/Jan/2001:14:31:41] info (39700):SunONE-WebServer/6.1 BB1-01/22/2001 01:45
[22/Jan/2001:14:31:42] warning (13751):for host wiley.a.com trying to GET /report.html, send-file reports:can't find /usr1/irenem/ES60-0424/docs/report.html (File not found)
執行日誌分析器server-root/extras/log_anly 目錄包含透過 [Server Manager] 使用者介面執行的日誌分析工具。此日誌分析器僅分析使用共用日誌格式的檔案。log_anly 目錄中的 HTML 文件解釋該工具的參數。server-root/extras/flex_anlg 目錄包含分析靈活日誌檔格式的指令行日誌分析器。但是，無論您選取了共用日誌檔格式還是靈活日誌檔格式，Server Manager 都預設使用靈活日誌檔報告工具。
使用日誌分析器可以產生關於預設伺服器的統計資料，例如活動摘要、最常存取的 URL、一日內反復存取伺服器的次數，等等。您可以從 Sun ONE Web Server 或指令行執行日誌分析器。日誌分析器能產生預設伺服器的統計資料，但無法產生虛擬伺服器的統計資料。不過，如檢視存取日誌檔所述，可以檢視每個虛擬伺服器的統計資料。
您必須先設定程式庫路徑，然後才可以嘗試執行 flexanlg 指令行公用程式。各種平台的設定如下︰
Solaris 和 Linux︰
LD_LIBRARY_PATH=server_root/bin/https/lib:$LD_LIBRARY_PATH
AIX︰
LIBPATH=server_root/bin/https/lib:$LIBPATH
HP-UX︰
SHLIB_PATH=server_root/bin/https/lib:$SHLIB_PATH
Windows:
path=server_root\bin\https\bin;%path%
備註 執行日誌分析器之前，應歸檔伺服器日誌。如需關於歸檔伺服器日誌的更多資訊，請參閱歸檔日誌檔。
若要從 [Server Manager] 執行日誌分析器，請執行以下步驟︰
如需更多資訊，請參閱線上說明中的 [Generate Report] 頁面。
若要透過指令行分析存取日誌檔，請執行工具 flexanlg (位於目錄 server-install/extras/flex_anlg 中)。
若要執行 flexanlg，請於指令提示處鍵入下列指令與選項︰
flexanlg [ -P ] [-n name] [-x] [-r] [-p order] [-i file]* [ -m metafile ]* [ o file][ c opts] [-t opts] [-l opts]
以下是語法的描述。
flexanlg -h.):
-P：代理日誌格式 預設為︰no
-n servername：伺服器名稱
-x：以 HTML 輸出 預設為︰no
-r：將 IP 位址解析為主機名稱 預設為︰no
-p [c,t,l]：輸出次序 (計數、時間統計資料、清單) 預設為︰ctl
-i filename：輸入日誌檔 預設為︰none
-o filename：輸出日誌檔 預設為︰stdout
-m filename：中繼檔案 預設為︰none
-c [h,n,r,f,e,u,o,k,c,z]：對這些項目計數 - 預設為︰hnreuokc
h：命中總計
n：304 [未修改] 狀態碼 (使用本機複本)
r：302 [找到] 狀態碼 (重新導向)
f：404 [未找到] 狀態碼 (未找到文件)
e：500 [伺服器錯誤] 狀態碼 (配置不當)
u：全部的唯一 URL
o：全部的唯一主機
k：傳輸的總千位元組數
c：快取記憶體儲存的總千位元組數
z：不對任何項目計數。
-t [sx,mx,hx, xx,z]：尋找一般統計資料 - 預設為︰s5m5h24x10
s(數目)：尋找日誌的最高 (數目) 秒數
m(數目)：尋找日誌的最高 (數目) 分鐘數
h(數目)：尋找日誌的最高 (數目) 小時數
u(數目)：尋找日誌的最高 (數目) 使用者人數
a(數目)：尋找日誌的最高 (數目) 使用者代理程式數
r(數目)：尋找日誌的最高 (數目) 參考者數
x(數目)：尋找雜項關鍵字的最高 (數目)
z：不尋找任何一般統計資料。
-l [cx,hx]：製作清單 - 預設為︰c+3h5
c(x,+x)：最常存取的 URL
(x：僅列示 x 個項目)
(+x：如果存取次數多於 x 次，則僅列示)
h(x,+x)：最經常存取您的伺服器的主機 (或 IP 位址)
(x：僅列示 x 個項目)
(+x：如果存取次數多於 x 次，則僅列示)
z：不製作任何清單
檢視事件 (Windows)除了將錯誤記錄到伺服器錯誤日誌中 (請參閱檢視錯誤日誌檔)，Sun ONE Web Server 還會把嚴重的系統錯誤記錄到事件檢視器內。事件檢視器可讓您監視系統上的事件。使用事件檢視器，可查看開啟錯誤日誌之前可能發生的基礎配置問題所導致的錯誤。
若要使用事件檢視器，請執行下列步驟︰
