正在將自訂元件新增到配接器

新增可以內含在配接器配置檔之環境定義中的自訂元件, 便可擴充「通用日誌配接器」。您可以將自訂元件新增成配接器的新元件, 或使用自訂元件來取代配接器中的現有元件。

必備條件
建立規則型配接器
建立自訂元件

將新元件新增至配接器中

如果要將新元件新增至配接器中,請執行下列步驟:

  1. 在「通用日誌配接器」視景的「導覽器」窗格中,選取配接器配置檔。請按一下滑鼠右鍵來選取開啟工具 > 配接器配置編輯器。 這時檔案會開在編輯器中。
  2. 在「配接器配置編輯器」視窗中,展開配接器 > 配置 > 環境定義實例節點。
  3. 用滑鼠右鍵按一下「環境定義實例」,然後選取新增 > 處理單位。這時會在「環境定義實例」中建立新的處理單元。
  4. 說明欄位中,指定元件的說明。
  5. 如果您的元件需要輸入,請將每個所需輸入的內容新增到處理單元。如果要將內容新增到處理單元,請用滑鼠右鍵按一下「處理單元」,然後選取新增內容
  6. 針對每個新增的內容,指定名稱和內容值。
  7. 如果要配置配接器以使用新建處理單元,您需要先在環境定義中建立一個相關元件。 開啟您要新增處理單元的環境定義。 如果要開啟預設的環境定義,請選取配接器 > 環境定義 > 環境定義基本實作環境定義
  8. 用滑鼠右鍵按一下您要新增處理單元的環境定義。如需預設環境定義, 請用滑鼠右鍵按一下環境定義基本實作環境定義,並選取新增 > 元件。 這時會在環境定義中加入一個新元件。
    附註:元件在「環境定義」中的列出次序,就是它們的執行次序。 請確定新元件的次序是否正確。您可拖放元件,來變更它們在環境定義中的次序。
  9. 請用下列值來配置新元件:
    名稱: 環境定義中的新處理單元名稱
    說明: 這個元件的用途說明
    執行類別: 您為這個元件所建立的 Java 類別
    記載層次:輸出器元件應該使用的內部記載層次。
    99 值表示輸出器不會記載任何訊息。
    0 值表示輸出器將記載所有嚴重性的訊息。
    建議值是 50,表示只記載「重要」或「嚴重」的內部輸出器錯誤。
    角色: 您應從下拉清單中選取元件的角色。 請參閱配接器配置檔結構, 以取得不同角色的相關資訊。對於未列出的角色,請選取未宣告
    唯一 ID: 必須指向第 3 步驟中「環境定義實例」所定義的元件。 請利用瀏覽按鈕來選取正確的 ID。
  10. 儲存配接器配置檔變更。

取代配接器中的現有元件

如果要用自訂元件取代配接器中的現有元件,請執行下列步驟:

  1. 在「配接器配置編輯器」視窗中,展開您要在其中執行取代元件作業的環境定義。 如果要展開預設的環境定義,請展開配接器 > 環境定義 > 環境定義基本實作環境定義節點。
  2. 按一下您要取代的元件。這時右窗格會顯示元件的詳細資料。
  3. 更新名稱說明欄位以說明您的元件。
  4. 用您的自訂元件類別名稱來更新執行類別。以下是已取代成自訂輸出器的輸出器元件範例。
    已用自訂元件的變更,更新「環境定義實作」元件輸出器
  5. 如果您要取代的元件需要特定的內容,請開啟節點配置 > 環境定義實例,然後選取您要取代的元件。
  6. 選取新增內容便可依照您元件的需求來新增內容。如果要移除您元件配置不需要的任何內容, 請用滑鼠右鍵按一下該內容,然後選取刪除
  7. 儲存配接器配置檔變更。

相關作業
建立日誌剖析器

相關參照
配接器配置檔結構