設定伺服器的記錄

管理伺服器記錄檔記錄關於伺服器的資料，包括遇到的錯誤類型以及關於伺服器存取的資訊。檢視這些記錄可讓您監視伺服器作業，並透過提供資料 (如遇到的錯誤類型以及存取某些檔案的時間) 來排解問題。

您可以使用管理主控台中的 [記錄喜好設定] 頁面，指定記錄在管理伺服器記錄中的資料類型及格式。例如，您可以選擇記錄存取管理伺服器的每個用戶端的相關資料，也可以略過一些用戶端，不予記錄。此外，您還可以選擇常用記錄格式 (可提供固定數量的伺服器資訊)，或建立自訂記錄檔格式，以更好地滿足需求。

記錄類型

記錄類型大體可分為：

1. 存取記錄 — 存取記錄可記錄有關向伺服器發出之請求以及伺服器之回應的資訊。

2. 伺服器記錄 — 伺服器記錄可列出自建立記錄檔後，伺服器所遇到的所有錯誤。它也包含有關伺服器的資訊訊息，如啟動伺服器的時間與嘗試登入伺服器不成功的使用者。

檢視存取記錄及伺服器記錄

• 檢視伺服器記錄。

  wadm> get-log --user=admin --password-file=admin.passwd --host=localhost --port=8989 --start-date=01/01/2006:09:00:00 --end-date=04/01/2006:10:00:00 --config=test cat.test.com

  上述指令將顯示 01/Jan/2006: 09:00:00 與 04/Jan/2006: 10:00:00 日期範圍內指定配置的伺服器記錄。

• 檢視存取記錄。

  wadm> get-access-log --user=admin --password-file=admin.passwd --host=localhost --port=8989 --status-code=300 --config=test cat.test.com

  上述指令僅會顯示狀態碼為 300 的指定配置存取記錄項目。

上述指令中的開始日期選項和結束日期選項應採用格式 — dd/MM/yyyy:HH:mm:ss。您也可以自訂日期格式。您可以在 rcfile 中使用變數 wadm_log_date_format 指定自己的日期格式，而非使用預設日期格式。

在 Sun Java System Web Server 中，您可透過執行下列指令來啟用存取記錄：

enable-access-log --user=admin --host=serverhost --password-file=../admin.passwd --port=8989 --ssl=true --no-prompt --rcfile=null --config=config1 --vs=vs --uri-pattern="*.html" --file=../logs/access.new --log-ip=true--format="%Req->reqpb. protocol% %Req->headers.authorization% %vsid% %Ses->client.dns%"

配置記錄參數

若要啟用與編輯配置的記錄設定，請執行以下作業：

1. 按一下 [配置] 標籤

2. 選取您需要為其啟用/編輯記錄設定的配置。

3. 按一下 [一般設定] 標籤 > [記錄設定] 標籤

編輯存取記錄喜好設定

下表說明了 [存取記錄喜好設定] 區段中的欄位：

表 13–5 欄位說明 > 編輯存取記錄喜好設定

欄位	說明
存取記錄	已啟用/已停用。依預設，存取記錄已啟用。選取此選項可以停用存取記錄。請注意，啟用存取記錄將使伺服器效能有較小幅度的下降。
檔案位置	儲存存取記錄檔的伺服器路徑。預設值為 ../logs/access
記錄格式	使用常用記錄格式 — 此選項為記錄檔的預設格式類型。伺服器將記錄從請求標頭中擷取的最相關資訊。 常用記錄格式為 IP address — user [date] “request” status content-length。 僅記錄以下詳細資訊 — 使用此選項即可只記錄請求標頭中的特定值。下列值可供核取： 用戶端主機名稱 系統日期 HTTP 狀態 HTTP 標頭 HTTP 方法 查詢字串 虛擬伺服器名稱 認證的使用者名稱 完整的 HTTP 請求 內容長度 請求 URI 協定

編輯伺服器記錄喜好設定

下表說明 [伺服器記錄喜好設定] 區段中的欄位：

表 13–6 欄位說明 > 編輯伺服器記錄喜好設定

欄位	說明
伺服器記錄位置	儲存伺服器記錄檔的伺服器路徑。預設值為 ../logs/errors
記錄詳細度層級	此選項為您提供設定記錄詳細度的簡單方法。若要測試 Web 應用程式並對其進行除錯，建議使用 finest 層級。 對於生產環境，建議的記錄級別為 failure 或 security。catastrophe 記錄層級將記錄非常少的詳細資訊。
記錄虛擬伺服器名稱	如果選取此選項，則在記錄錯誤的同時，還會記錄處理請求的虛擬伺服器名稱。
記錄至系統記錄檔	將所有訊息記錄至系統記錄檔。
記錄至主控台	如果選取此選項，則會記錄由已部署 Web 應用程式引起的異常 (如果寫入 主控台 中)。 依預設，此選項為啟用狀態。
日期格式	用來將時間戳記附加至錯誤訊息的時間格式。預設值為 [%d/%b/%Y:%H:%M:%S]。

歸檔記錄檔

您可以將記錄檔設定為自動歸檔。在某一時間，或在指定間隔後，伺服器將自動重建存取記錄。伺服器會儲存舊記錄檔，並使用包含其儲存日期和時間的名稱標示已儲存的檔案。

例如您可以將檔案設定為每小時自動重建一次，並且伺服器儲存檔案並將其命名為「access.199907.0152400」，其中，「名稱|年|月|日|24 小時制時間」會鏈結為單一字元串。依據您設定之記錄自動重建類型的不同，存取記錄歸檔檔案的確切格式也會不同。

存取記錄自動重建在伺服器啟動時初始化。如果開啟自動重建，則伺服器將建立具有時間戳記的存取記錄檔，而且伺服器啟動時就會開始自動重建。

開始自動重建後，當產生需要記錄到存取記錄檔的請求，而且產生時間在先前排定的「下一個自動重建時間」之後時，伺服器會建立具有新時間戳記的存取記錄檔。

設定記錄自動重建

您可以使用記錄自動重建選項排定已配置實例的錯誤/存取記錄自動重建。若要設定記錄自動重建，請執行以下步驟：

1. 按一下 [配置] 標籤

2. 選取您需要為其啟用/編輯記錄設定的配置。

3. 按一下 [一般設定] 標籤 > [記錄設定] 標籤

4. 按一下 [記錄歸檔] 區段下的 [新增] 按鈕

以下小節中說明了新增記錄自動重建頁面中的欄位：

表 13–7 欄位說明 > 設定記錄自動重建

欄位	說明
事件	存取記錄自動重建/伺服器記錄自動重建。選取這兩個選項之一或同時選取二者，以為該記錄類型配置自動重建。
時間	配置的事件啟動時間。從下拉式方塊中選取小時和分鐘值。  每一天 — 每天在指定的時間啟動指定的事件。 特定日期 — 在特定日期啟動指定的事件。 1. 星期幾 — 指定星期日到星期六之間的任一天。 2. 日期 — 以逗號分隔的項目指定每月 1 日到 31 日之間的任何一天。例如 4,23,9。 特定月份 — 在特定時間和月份啟動指定的事件。指定從 1 月至 12 月之間的月份。
間隔	在此時間段之後啟動指定的事件。  1. 間隔小時數 — 從下拉式方塊中選取小時數。 2. 間隔秒數 — 從下拉式方塊中選取秒數。

如需刪除排定的記錄自動重建，請按一下 [記錄歸檔] 區段中的 [刪除] 按鈕。

歸檔指令

您可以在伺服器自動重建記錄檔後，指定指令的絕對路徑。記錄檔自動重建後的檔案名稱會做為歸檔指令的引數傳送。歸檔指令也會壓縮已自動重建的記錄檔。