「通用日誌配接器」提供「輸出器」類別,讓配接器所產生的 Common Base Event 物件可以傳送到「記載代理程式」。 「日誌和追蹤分析器」可用來連接至「記載代理程式」,以即時監視及分析應用程式日誌。
必備條件:請遵循下列步驟來配置您的配接器,以進行監視作業。
附註:新的配接器配置檔建立好時,依預設,其配置會使用 CBELogOutputter 類別。如果您沒有變更此設定,則可跳過下列程序。
配接器配置檔中的「輸出器」元件需要更新為使用 CBELogOutputter 類別,以將 Common Base Event 物件寫入「記載代理程式」。您可以更新現有的「輸出器」元件,或新增「輸出器」元件。
若要新增「輸出器」元件:
名稱: | 「輸出器」在環境定義中的名稱。例如:記載代理程式輸出器 |
說明: | 說明此「輸出器」的工作 |
執行類別: | org.eclipse.hyades.logging.adapter.outputters.CBELogOutputter |
記載層次: | 「輸出器」元件應使用的內部記載層次。這個層次是以 CommonBaseEvent 嚴重性值為依據。數字愈大,訊息的嚴重性就愈高。 就「記載」層次而言,所指定的數字會讓「輸出器」元件只記載該嚴重性以上的內部「輸出器」訊息。71(含)以上的值表示「輸出器」將不會記載任何內部「輸出器」訊息。0 值表示 「輸出器」將會記載所有嚴重性的內部「輸出器」訊息。 建議值為 50,表示只會記載「重要」或「嚴重」的內部「輸出器」錯誤訊息。 |
角色: | 輸出器 |
唯一 ID: | 必須指向步驟 3 之「環境定義實例」中所定義的「輸出器」。請使用瀏覽按鈕來選取正確的 ID。 |
如果您要日誌剖析器持續監視日誌檔,則需更新配接器配置檔的環境定義實例內容,以進行持續性的作業。
您可以從 Windows 環境中的批次檔,或是非 Windows 環境中的 Shell Script,在外部執行您所建立的日誌配接器。
以下範例檔案可用來啟動 Java 程序,以執行您的日誌配接器。
附註:若要連接及監視「通用日誌配接器」所建立的記載代理程式,必須將 Agent Controller 安裝在「通用日誌配接器」所要執行的系統上,而且必須先啟動 Agent Controller,再啟動「通用日誌配接器」。
Windows 批次檔:
@rem 用法:runregex @rem 目的:使用範例配接器檔及範例日誌檔來說明「通用日誌配接器」(GLA) 執行時期的功能。 @rem 使用說明:在 GLA 執行環境中執行時,請將 %GLA_HOME% 環境變數的值,變更為解壓縮 GLA 執行時期的絕對路徑。 @rem 附註:在外掛程式(例如:Eclipse)執行環境中執行時,請建立一個暫時工作目錄,並將 %GLA_HOME% 環境變數的值,變更為 @rem 新建之暫時工作目錄的絕對路徑。另外,再建立一個 %GLA_HOME%\config 目錄,並將 org.eclipse.hyades.logging.adapter.config @rem 外掛程式的內容複製到新建的 %GLA_HOME%\config 目錄。最後,建立一個 %GLA_HOME%\lib 目錄,並將下列 JAR 檔複製到新建的 %GLA_HOME%\lib 目錄: @rem 外掛程式 | JAR @rem --------------------------------------------------- @rem org.eclipse.hyades.logging.adapter | hgla.jar @rem org.eclipse.hyades.logging.core | hlcbe101.jar @rem org.eclipse.hyades.logging.core | hlcore.jar @rem org.eclipse.hyades.execution.remote | hexr.jar @rem org.eclipse.emf.ecore | ecore.jar @rem org.eclipse.emf.common | common.jar SET GLA_HOME=d:\GenericLogAdapter SET MY_DIRECTORY=MyAdapter SET CONFIG_FILE=%GLA_HOME%\config\%MY_DIRECTORY%\myadapter.adapter PUSHD %GLA_HOME%\config\%MY_DIRECTORY%\java -DGLA_HOME="%GLA_HOME%" -classpath "%GLA_HOME%\lib\hgla.jar;%GLA_HOME%\lib\hexr.jar;%GLA_HOME%\lib\hlcbe101.jar;%GLA_HOME%\lib\ecore.jar;%GLA_HOME%\lib\common.jar;%GLA_HOME%\lib\hlcore.jar" org.eclipse.hyades.logging.adapter.Adapter -ac "%CONFIG_FILE%" -cc "%CONFIG_FILE%" POPD非 Windows 批次檔:
#!/bin/sh # 用法:runregex_example.sh # 目的:使用範例配接器檔案及範例日誌檔來說明「通用日誌配接器」(GLA) 執行時期的功能。 # 使用說明:在 GLA 執行環境中執行時,請將 $GLA_HOME 環境變數的值,變更為解壓縮 GLA 執行時期的絕對路徑。 # 附註:在外掛程式(例如:Eclipse)執行環境中執行時,請建立一個暫時工作目錄,並將 $GLA_HOME 環境變數的值,變更為 # 新建之暫時工作目錄的絕對路徑。另外,再建立一個 $GLA_HOME/config 目錄,並將 com.ibm.etools.logging.adapter.config # 外掛程式的內容複製到新建的 $GLA_HOME/config 目錄。最後,建立一個 $GLA_HOME/lib 目錄,並將下列 JAR 檔複製到新建的 $GLA_HOME/lib 目錄: # 外掛程式 | JAR # --------------------------------------------------- # org.eclipse.hyades.logging.adapter | hgla.jar # org.eclipse.hyades.logging.core | hlcbe101.jar # org.eclipse.hyades.logging.core | hlcore.jar # org.eclipse.hyades.execution.remote | hexr.jar # org.eclipse.emf.ecore | ecore.jar # org.eclipse.emf.common | common.jar GLA_HOME=/home/eclipse/GenericLogAdapter export GLA_HOME YOUR_DIRECTORY=MY_DIRECTORY export MY_DIRECTORY CONFIG_FILE="$GLA_HOME/config/$MY_DIRECTORY/myadapter.adapter" export CONFIG_FILE CUR_DIR=`pwd` export CUR_DIR cd "$GLA_HOME/config/$MY_DIRECTORY java -DGLA_HOME="$GLA_HOME" -classpath "$GLA_HOME/lib/hgla.jar:$GLA_HOME/lib/hexr.jar:$GLA_HOME/lib/hlcbe101.jar:$GLA_HOME/lib/ecore.jar:$GLA_HOME/lib/common.jar:$GLA_HOME/lib/hlcore.jar"org.eclipse.hyades.logging.adapter.Adapter -ac "$CONFIG_FILE" -cc "$CONFIG_FILE" cd "$CUR_DIR"依需要來配置檔案,以啟動 Java 程序來執行您的配接器。
現在您已準備好要監視即時應用程式日誌。
相關概念
Hyades「通用日誌配接器」的概觀
Common Base Event 格式規格
相關作業
建立日誌剖析器
相關參照
配接器配置檔結構
配接器配置編輯器
正規表示式文法
(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.