移轉

這裡討論的移轉問題包括如下:

從 AlphaWorks「通用日誌配接器」移轉到 Hyades「通用日誌配接器」

Hyades「通用日誌配接器」的綱目與 AlphaWorks 版本有很大的差異。 除了 Hyades 版本支援「共同基本事件」1.0.1 版的事實以外, 所有使用 AlphaWorks「通用日誌配接器」建立的現有配置和環境定義要在 Hyades 版本上執行之前,都需要先執行手動移轉。

建議的移轉方法是使用編輯器來開啟現有的配置和環境定義檔,將規則個別複製到剪貼簿,然後將它們貼到「配接器配置編輯器」。請注意您複製來源的編輯器必須支援 XML,否則當實體參照儲存到新檔案時會造成毀損。 同時請注意實作環境定義和元件的類別也已經變更。

#USE_PREVIOUS 指引的置換作業

「通用日誌配接器」在 AlphaWorks 版本上可用的 #USE_PREVIOUS 指引並不包括在 Hyades 版本中。 相反的,其功能已被使用上一個符合的替代作為預設值內容所取代。詳細資料請參閱剖析器內容清單。

#ADAPTER 指引的置換作業

「通用日誌配接器」在 AlphaWorks 版本上可用的 #ADAPTER 指引在 Hyades 版本中已經取代為替代規則上的使用內建函數勾選框。 下列的「共同基本事件」內容支援使用在替代規則上的使用內建函數勾選框並且顯示所產生的值:
「共同基本事件」內容 產生的值
localInstanceId <本端主機 IP 位址或「不明主機」>
<目前的時間(以毫秒為單位)>
<日誌記錄的雜湊碼>
globalInstanceId 128 位元的廣域專屬 ID
componentIndentification.location <本端主機 IP 位址或「不明主機」>
componentIdentification.locationType 「IPV4」/「IPV6」或「None」

從「共同基本事件」1.0 移轉規則到 1.0.1

Hyades 的「通用日誌配接器」支援「共同基本事件」1.0.1。 這表示需要對舊的配置規則進行小幅的變更才能使它們在新建綱目上正確的運作。 主要的差異在於「共同基本事件」1.0.1 規格已經移除了 situationType 內容並且使用 Situation 元素來取代。 現在需要撰寫規則來識別訊息是套用到哪個類型的狀況上,也需要根據狀況的類型撰寫其他的規則來識別其特性。

相關概念
Hyades「通用日誌配接器」的概觀
「共同基本事件」物件

相關作業
使用 Hyades「通用日誌配接器」架構開發日誌剖析器
使用正規表示式規則建立配接器
使用靜態剖析器 Java 類別建立配接器

相關參照
配置檔結構
「共同基本事件」物件
「通用日誌配接器」編輯器
正規表示式文法