通用日誌配接器提供一個可讓配接器所產生的 Common Base Event 物件傳送到記載代理程式的輸出器類別。 日誌和追蹤分析器可用來連接到記載代理程式,以即時監視和分析應用程式日誌。
必備條件:請遵循下列步驟來配置配接器,以便進行監視。
附註:當建立新的配接器配置檔時,依預設,它會配置成使用 CBELogOutputter 類別。
如果您沒有變更這項設定,您可以略過這個程序。
您必須更新配接器配置檔中的輸出器元件,才能使用將 Common Base Event 物件寫入記載代理程式的 CBELogOutputter 類別。
您可以更新現有的輸出器元件或新增一個新的輸出器元件。
如果要新增輸出器元件,請執行下列動作:
名稱: | 環境定義中的輸出器名稱 |
說明: | 這個輸出器的用途說明 |
執行類別: | org.eclipse.hyades.logging.adapter.outputters.CBELogOutputter |
記載層次: | 輸出器元件應該使用的內部記載層次。
99 值表示輸出器不會記載任何訊息。 0 值表示輸出器將記載所有嚴重性的訊息。 建議值是 50,表示只記載「重要」或「嚴重」的內部輸出器錯誤。 |
角色: | 輸出器 |
唯一 ID: | 必須指向第 3 步驟中「環境定義實例」所定義的輸出器。請利用瀏覽按鈕來選取正確的 ID。 |
如果您要日誌剖析器連續監視日誌檔,您必須更新連續作業之配接器配置檔的環境定義實例內容。
您可以在外部從 Windows 環境的批次檔或從非 Windows 環境的 Shell Script 執行您建立的日誌配接器。
以下是可用來啟動將執行日誌配接器之 Java 程序的範例檔。
附註:如果要連接並監視「通用日誌配接器」所建立的記載代理程式,則必須在
執行「通用日誌配接器」的系統上,安裝 Hyades Agent Controller,且必須在啟動「通用日誌配接器」之前啟動 Hyades Agent Controller。
Windows 批次檔:
@rem 用法:runregex @rem 目的:說明「通用日誌配接器 (GLA)」的功能 @rem 使用範例配接器檔案和範例日誌檔的執行時期。 @rem 假設:這個批次檔假設 GLA 執行時期和所需的檔案 @rem 皆儲存在下列目錄結構中: @rem %GLA_HOME%\config - GLA 配接器配置檔 @rem %GLA_HOME%\lib - GLA 執行時期和所需的 JAR @rem %GLA_HOME%\schema - GLA 配接器配置綱目檔 @rem 指示: @rem 如果 GLA 執行時期和所需的檔案皆儲存在 @rem 上述假設目錄中,請將 %GLA_HOME% @rem 環境變數的值變更成儲存 GLA 執行時期 @rem 和所需檔案的絕對路徑。 @rem 如果 GLA 執行時期檔案儲存在外掛程式(如 Eclipse) @rem 環境中,請執行下列指示: @rem 1) 建立暫時目錄以儲存 GLA 執行時期和所需的檔案。 @rem 2) 在步驟 1 所建立的暫時目錄中, @rem 建立 config、lib 和 schema 目錄。 @rem 3) 將 %GLA_HOME% 環境變數的值變更成 @rem 在步驟 1 中所建立之暫時目錄的絕對路徑。 @rem 4) 將欲執行的配接器檔案複製到 %GLA_HOME%\config 目錄中。 @rem 例如,如果您想要執行 Apache 配接器檔案,則要將 @rem org.eclipse.hyades.logging.adapter.config @rem 外掛程式的 Apache 目錄和其所有內容,複製到 %GLA_HOME%\config 目錄中。 @rem 5) 將 org.eclipse.hyades.logging.adapter @rem 外掛程式的綱目目錄內容複製到 %GLA_HOME%\schema 目錄中。 @rem 6) 將下列 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 CONFIG_FILE=%GLA_HOME%\config\my.adapter @PUSHD %GLA_HOME%\config\ 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.sh # 目的:說明「通用日誌配接器 (GLA)」的功能 # 使用範例配接器檔案和範例日誌檔的執行時期。 # 假設:這個 Shell 檔假設 GLA 執行時期和所需的檔案 # 皆儲存在下列目錄結構中: # %GLA_HOME%/config - GLA 配接器配置檔 # %GLA_HOME%/lib - GLA 執行時期和所需的 JAR # %GLA_HOME%/schema - GLA 配接器配置綱目檔 # 指示: # 如果 GLA 執行時期和所需的檔案皆儲存在 # 上述假設目錄中,請將 %GLA_HOME% # 環境變數的值變更成儲存 GLA 執行時期 # 和所需檔案的絕對路徑。 # 如果 GLA 執行時期檔案儲存在外掛程式(如 Eclipse) # 環境中,請執行下列指示: # 1) 建立暫時目錄以儲存 GLA 執行時期和所需的檔案。 # 2) 在步驟 1 所建立的暫時目錄中, # 建立 config、lib 和 schema 目錄。 # 3) 將 %GLA_HOME% 環境變數的值變更成 # 在步驟 1 中所建立之暫時目錄的絕對路徑。 # 4) 將欲執行的配接器檔案複製到 %GLA_HOME%/config 目錄中。 # 例如,如果您想要執行 Apache 配接器檔案,則要將 # org.eclipse.hyades.logging.adapter.config # 外掛程式的 Apache 目錄和其所有內容,複製到 %GLA_HOME%/config 目錄中。 # 5) 將 org.eclipse.hyades.logging.adapter # 外掛程式的綱目目錄內容複製到 %GLA_HOME%/schema 目錄中。 # 6) 將下列 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 CONFIG_FILE="$GLA_HOME/config/my.adapter" export CONFIG_FILE CUR_DIR=`pwd` export CUR_DIR cd "$GLA_HOME/config" 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 程序。
現在,您已準備好開始監視即時應用程式日誌。
相關概念
通用日誌配接器概觀
Common Base Event 格式規格
相關作業
建立日誌剖析器
相關參照
配接器配置檔結構
配接器配置編輯器
正規表示式文法
(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.