Sun logo      上一個      目錄      下一個     

Sun Java System Application Server Enterprise Edition 8.1 管理指南 2005Q1

第 20 章
配置記錄

本章簡要描述如何使用管理主控台來配置記錄和檢視伺服器記錄。它包含以下小節:


關於記錄

記錄檔的記錄

Application Server 使用在 JSR 047 中指定的 Java 2 平台記錄 API。Application Server 記錄訊息記錄在伺服器記錄中,通常位於 domain_root_dir/domain_dir/logs/server.log 中。

domain_root_dir/domain_dir/logs/ 目錄中除了包含伺服器記錄之外,還包含兩種其他類型的記錄。access 子目錄中包含 HTTP 服務存取記錄,tx 子目錄中包含作業事件服務記錄。如需有關這些記錄的資訊,請參閱配置 HTTP 服務存取記錄配置作業事件

Application Server 的元件產生記錄輸出。應用程式元件也可以產生記錄輸出。

應用程式元件可以使用 Apache Commons Logging Library 來記錄訊息。但是,建議採用平台標準 JSR 047 API 以獲得更好的記錄配置。

記錄檔的記錄遵循以下統一格式:

[#|yyyy-mm-ddThh:mm:ss.SSS-Z|記錄層級|產品名稱版本|記錄程式名稱|關鍵字值對|訊息|#]

例如︰

[#|2004-10-21T13:25:53.852-0400|INFO|sun-appserver-ee8.1|javax.enterprise.system.core|_Thr eadID=13;|CORE5004:Resource Deployed:[cr:jms/DurableConnectionFactory].|#]

在本範例中,

以後的版本中,可能會變更或增強記錄檔的記錄格式。

記錄程式名稱空間階層結構

Application Server 為它的每個模組都提供了記錄程式。下表按照模組名稱和名稱空間在管理主控台的 [記錄層級] 頁面中的顯示方式 (請參閱配置記錄層級),以字母順序列出每個記錄程式的模組名稱和名稱空間。[記錄層級] 頁面中未顯示表中最後三個模組。

表 20-1 Application Server 記錄程式名稱空間 

模組名稱

名稱空間

管理

javax.enterprise.system.tools.admin

Classloader

javax.enterprise.system.core.classloading

CMP

javax.enterprise.system.container.cmp

配置

javax.enterprise.system.core.config

連接器

javax.enterprise.resource.resourceadapter

CORBA

javax.enterprise.resource.corba

部署

javax.enterprise.system.tools.deployment

EJB 容器

javax.enterprise.system.container.ejb

JavaMail

javax.enterprise.resource.javamail

JAXR

javax.enterprise.resource.webservices.registry

JAX-RPC

javax.enterprise.resource.webservices.rpc

JDO

javax.enterprise.resource.jdo

JMS

javax.enterprise.resource.jms

JTA

javax.enterprise.resource.jta

JTS

javax.enterprise.system.core.transaction

MDB 容器

javax.enterprise.system.container.ejb.mdb

命名

javax.enterprise.system.core.naming

節點代理程式 (僅限於 Enterprise Edition)

javax.ee.enterprise.system.nodeagent

javax.enterprise

SAAJ

javax.enterprise.resource.webservices.saaj

安全性

javax.enterprise.system.core.security

伺服器

javax.enterprise.system

同步 (僅限於 Enterprise Edition)

javax.ee.enterprise.system.tools.synchronization

Util

javax.enterprise.system.util

檢驗器

javax.enterprise.system.tools.verifier

Web 容器

javax.enterprise.system.container.web

核心

javax.enterprise.system.core

系統輸出 (System.out.println)

javax.enterprise.system.stream.out

系統錯誤 (System.err.println)

javax.enterprise.system.stream.err


有關記錄的管理主控台作業

配置一般記錄設定

  1. 在樹形元件中,展開 [節點代理程式] 節點或 [配置] 節點。
  2. 選取節點代理程式,或者選取要配置的實例:
    1. 若要配置特定的實例,請選取該實例的配置節點。例如,對於預設實例 server,請選取 server-config 節點。
    2. 若要為將來的實例 (實例使用 default-config 的副本) 配置預設設定,請選取 default-config 節點。
  3. 對於節點代理程式,請選取 [記錄程式設定] 標籤。對於配置,請選取 [記錄程式設定] 節點。
  4. 在 [記錄設定] 頁面中,可以使用以下欄位來自訂記錄:
    • 記錄檔:若要為伺服器記錄檔指定替代名稱或位置,請在文字欄位中鍵入新的路徑名稱。依預設,該位置為 domain_root_dir/domain_dir/logs/server.log
    • 警示:若要經由 JMX 框架路由 SEVEREWARNING 訊息,請選取 [啟用] 核取方塊。
    • 寫入系統記錄:僅在 Solaris 和 Linux 系統中,除了要將記錄輸出傳送給伺服器記錄外,還要將其傳送給 syslog 工具,請選取 [啟用] 核取方塊。
    • 記錄處理程式:若要將記錄傳送到 server.logsyslog 以外的目標,您可以插入自訂記錄處理程式。自訂處理程式必須延伸 java.util.logging.Handler 類別 (JSR 047 相容 API)。在 [記錄處理程式] 欄位中鍵入處理程式的絕對類別名稱。還應將處理程式類別置於 Application Server 類別路徑中,以便在伺服器啟動期間安裝該處理程式。自訂處理程式的記錄檔的記錄具有在記錄檔的記錄中描述的格式。
    • 記錄篩選器:若要篩選傳送給目標 (如 server.logsyslog 或由自訂記錄處理程式指定的目標) 的記錄檔的記錄,可以插入自訂記錄篩選器。該自訂篩選器必須實作介面 java.util.logging.Filter。在 [記錄篩選器] 欄位中鍵入篩選器的絕對類別名稱。還應將篩選器類別置於 Application Server 類別路徑中,以便在伺服器啟動期間安裝該篩選器。
    • 檔案自動重建限制:如果伺服器記錄的位元組數達到了指定大小,請建立一個名為 server.log 的新的空檔案,並將舊檔案重新命名為 server.log_date,其中 date 是自動重建檔案的日期和時間。預設值為 2 百萬位元組。該限制的最小值為 500 千位元組,如果指定較低的值,則要在達到 500 千位元組時該檔案才自動重建。若要關閉記錄檔自動重建,請將該值設定為 0。
    • 檔案自動重建時間限制:達到指定的分鐘數之後才自動重建伺服器記錄。預設值為零,這表示檔案達到 [檔案自動重建限制] 欄位中指定的大小即會自動重建。如果指定了非零的時間限制,則該時間限制優先於上述大小限制
  5. 按一下 [儲存],以儲存變更。按一下 [檢視記錄檔] 以檢視伺服器記錄。

配置記錄層級

  1. 在樹形元件中,展開 [節點代理程式] 節點或 [配置] 節點。
  2. 選取節點代理程式,或者選取要配置的實例:
    1. 若要配置特定的實例,請選取該實例的配置節點。例如,對於預設實例 server,請選取 server-config 節點。
    2. 若要為將來的實例 (實例使用 default-config 的副本) 配置預設設定,請選取 default-config 節點。
  3. 對於節點代理程式,請選取 [記錄層級] 標籤。對於配置,請選取 [記錄程式設定] 節點,然後選取 [記錄層級] 標籤。
  4. 在 [模組記錄層級] 頁面中,請從要變更記錄層級的一個或多個模組相對的下拉式清單中選擇一個新值。預設層級為 INFO,表示處於該層級或更高層級 (WARNINGSEVERE) 的訊息將顯示在記錄中。可以選擇以下任一值 (以最高層級至最低層級的順序列示):
    • 嚴重
    • 警告
    • 資訊
    • 配置
    • 較好
    • 最好
    • 關閉
  5. 使用 [附加特性] 區域可以為任何應用程式記錄程式配置記錄層級。特性名稱是記錄程式名稱空間,其值為上述八個可能的層級之一。例如,特性名稱可為 samples.logging.simple.servlet,值可為 FINE
  6. 還可以使用此區域來變更子模組的記錄層級,例如 CORBA 模組的傳輸子模組:

    javax.enterprise.resource.corba.ORBId.transport
  7. 按一下 [儲存] 以儲存變更,或按一下 [載入預設值] 以復原預設值。

System.out.println 的呼叫均在 INFO 層級使用記錄程式名稱 javax.enterprise.system.stream.out 予以記錄。對 System.err.println 的呼叫均在 WARNING 層級使用記錄程式名稱 javax.enterprise.system.stream.err 予以記錄。若要從這些源關閉記錄,請在 [附加特性] 區域中將記錄程式名稱的值指定為 OFF

對記錄層級設定所做的變更將立即生效。同時將在 domain.xml 檔案中儲存這些變更,以供伺服器重新啟動時使用。

檢視伺服器記錄

  1. 在樹形元件中,展開要檢視其記錄的伺服器實例的節點。
  2. 在 [一般資訊] 頁面中,按一下 [檢視記錄檔]。

使用 [搜尋條件] 區域自訂和篩選記錄檢視器。使用如下所示的基本欄位:

將顯示伺服器記錄中最新的 40 個項目以及在 [記錄設定] 和 [記錄層級] 頁面中指定的設定。

按一下 [時間戳記] 標頭旁邊的三角形對這些訊息進行排序,以使最新的訊息顯示在最後。

若要檢視訊息的格式化版本,請按一下標示的連結

(詳細資訊)

將顯示標有 [記錄項目詳細資訊] 的視窗,該視窗包含了訊息的格式化版本。

在項目清單的末尾,按一下按鈕以檢視記錄檔中較早或較晚的項目。

按一下 [搜尋條件] 區域中的 [進階搜尋] 以進一步細化記錄檢視器的搜尋條件。使用如下所示的 [進階選項] 欄位:

按一下 [基本搜尋] 可以隱藏 [進階選項] 區域。



上一個      目錄      下一個     


Copyright 2004 - 2005 Sun Microsystems, Inc. 版權所有。