Sun Java System Portal Server 7.1 管理指南

第 8 章 管理 Portal Server 記錄

本章說明如何取得 Sun JavaTM System Portal Server 記錄資訊。

本章包含下列章節:

瞭解 Portal Server 記錄

Portal Server 支援在所有元件間進行記錄。所有記錄與記錄配置在入口網站元件之間都是一致的。有七個標準記錄層級,範圍從嚴重到輕微。記錄可被傳送至不同檔案或資料槽,並可由單個或多個檔案所組成,即每個元件有一個檔案。

您可設定每個模組、子模組的記錄層級,同時可針對每個元件內各個模組、子模組將記錄傳送至不同的檔案。

管理 Portal Server 記錄

您可以使用以下元件設定和管理 Portal Server 記錄:

您可以從入口網站管理主控台管理入口網站記錄。

Procedure管理記錄檢視器

  1. 登入 Portal Server 管理主控台

  2. 選取 [入口網站] 標籤。

  3. 在 [入口網站] 中選取入口網站伺服器。

  4. 按一下 [記錄],再按一下子功能表中的 [記錄檢視器]。

  5. 在 [實例名稱] 下拉式功能表中,選取一個入口網站實例。

    顯示記錄檢視器的 [搜尋條件] 和 [搜尋結果] 頁面。

  6. 輸入 [搜尋條件] 的值,再按一下 [搜尋]。

    可用的搜尋選項有:

    記錄檔名稱

    具有記錄內容的檔案名稱。

    記錄層級

    所選層級或較高層級的訊息會在記錄中顯示。可用的層級有 SEVERE、WARNING、INFO、CONFIG、FINE、FINER 和 FINEST。預設層級為 INFO,因此記錄將包含 INFO、WARNING 或 SEVERE 層級的訊息。

    若要確保您要檢視的訊息會出現在記錄中,請先在 [特定記錄器設定] 頁面中設定適當的記錄層級。

    時間戳記

    顯示某段時間的記錄訊息。

    您可以檢視最新的 100 筆記錄項目,或在 [開始日期] 和 [結束日期] 文字方塊中輸入時段。

    如果您選擇 [特定範圍]:

    • [開始日期] 與 [結束日期] 值都是必須輸入的值

    • [開始日期] 不得晚於 [結束日期]

    • [結束日期] 的值不得晚於「今日日期」

    • [開始時間] 與 [結束時間] 值可以選用。如果指定了 [開始時間] 的值,則必須指定 [結束時間] 值。時間值語法的格式必須為 hh:mm:ss.SSS。SSS 代表亳秒。例如,18:20:10.000

相當於 psadmin 指令

psadmin set-logger

Procedure自訂記錄顯示

您可以使用以下步驟自訂 [搜尋結果] 頁面:

  1. 登入 Portal Server 管理主控台

  2. 選取 [入口網站] 標籤。

  3. 在 [入口網站] 中選取入口網站伺服器。

  4. 按一下 [記錄],再從 [實例名稱] 下拉式功能表中選取一個入口網站伺服器。

  5. 在 [記錄檢視器結果] 表中,按一下 [時間戳記] 欄標題以排序訊息。

  6. 按一下詳細資訊連結,會以新視窗檢視已設定格式的記錄訊息。

Procedure管理一般記錄器設定

  1. 登入 Portal Server 管理主控台

  2. 選取 [入口網站] 標籤。

  3. 在 [入口網站] 中選取入口網站伺服器。

  4. 按一下 [記錄],再選取子功能表中的 [一般記錄器設定]。

  5. 在 [實例名稱] 下拉式功能表中,選取一個入口網站實例。

  6. 依需要修改配置屬性。

    可用的選項有:

    一般

    記錄層級 — 選取記錄層級設定,就可以選擇要檢視的記錄檔中的資訊。

    可以選擇的記錄層級包括:

    • Severe - 使用者可以看見的錯誤

    • Warning - 使用者警告

    • Info - 提供給使用者的資訊

    • Config - 提供給開發人員的靜態設定資訊

    • Fine - 基本追蹤資訊

    • Finer - 詳細追蹤資訊

    • Finest - 完整追蹤資訊

    • Off - 可以用來關閉記錄

    • All - 表示應記錄所有訊息

    檔案處理器特性
    • 限制 — 以位元組為單位指定記錄檔大小。如果記錄檔大小超過此值,則會根據檔案計數重建記錄檔。預設值是 5 MB。

    • 檔案計數 — 當記錄到達指定的位元組大小時,便以產生號碼 (檔案式樣中的 %g) 遞增 1 的方式建立新的空白檔案。預設值是 2。若要關閉記錄檔重建,將值設定為 0。

    • 附加 — 指定新訊息是否附加至現有檔案。預設為 true。

    • 篩選器 — 若要篩選傳往如入口網站記錄或由自訂記錄處理器指定之目標的記錄,您可以外掛自訂記錄篩選器。自訂篩選器必須實作介面 java.util.logging.Filter。在欄位中輸入篩選器的絕對類別名稱。此外也將篩選器類別放置在 Application Server 類別路徑中,如此一來在啟動伺服器時便會安裝篩選器。

    其他
    • 自訂處理器 — 若要傳送記錄的目標不是入口網站記錄,您可以外掛自訂記錄處理器。自訂處理器必須延伸類別 java.util.logging.Handler (JSR 047 相容 API)。在欄位中輸入處理器的絕對類別名稱。此外也將處理器類別放置在 Application Server 類別路徑中,如此一來在啟動伺服器時便會安裝處理器。您可指定多個處理器。使用逗號來分隔多個名稱。

    • 使用 Web 容器記錄檔 — 若要停用入口網站記錄管理,並將所有記錄傳送到 Web 容器記錄檔,則選擇 [是],其他狀況則選擇 [否]。預設為 [否]。

  7. 按一下 [套用至選取的實例] 或按一下 [套用至所有實例] 以記錄變更。

相當於 psadmin 指令

psadmin set-logger

Procedure管理特定記錄器設定

  1. 登入 Portal Server 管理主控台

  2. 選取 [入口網站] 標籤。

  3. 在 [入口網站] 中選取入口網站伺服器。

  4. 按一下 [記錄],再選取子功能表中的 [特定記錄器設定]。

  5. 在 [實例名稱] 下拉式功能表中,選取一個入口網站實例。

  6. 依需要修改配置屬性。

    可用的選項有:

    記錄器設定
    • 記錄器名稱 – 按一下記錄器名稱可取得記錄器的配置詳細資訊。

    • 記錄層級 – 您可以藉由選取記錄層級設定來選擇要檢視記錄器記錄檔中的哪些資訊,或者您可以繼承父系記錄器的記錄層級。例如,如果 debug.com.sun.portal 的記錄層級是 INFO,debug.com.sun.portal.desktop 是 [繼承父系記錄器層級],則其值也會是 INFO。

    • 記錄檔合併策略 – 對於記錄器,您可以選擇是否要將訊息記錄在與父系相同的記錄檔中 (記錄至父系記錄檔),或是記錄到個別檔案中 (記錄至個別記錄檔)。

    • 父系處理器 – 對於記錄器,如果 [記錄檔案合併策略] 設定為 [記錄至個別記錄檔],那麼您可以選擇是否要將訊息記錄至個別記錄檔和父系記錄檔 (繼承父系處理器),或只記錄到不同的檔案 (不繼承父系處理器)。

    • 堆疊追蹤 – 對於記錄器,您可以選擇是否要記錄所有層級的堆疊追蹤 (列印所有層級的堆疊追蹤),為僅記錄到 WARNING 層級 (列印堆疊追蹤直到警示層級)。


      備註 –

      如果 [記錄檔案合併策略] 值為 [記錄至父系記錄檔],則會忽略 [父系處理器] 和 [堆疊追蹤] 值。如果 [記錄檔合併策略] 的值為 [記錄至個別記錄檔] ,且 [父系處理器] 的值是 [繼承父系處理器],則 [堆疊追蹤] 的 [列印所有層級的堆疊追蹤] 無效。


  7. 按一下 [套用至選取的實例] 或按一下 [套用至所有實例] 以記錄變更。

相當於 psadmin 指令

psadmin set-logger