配置規則型剖析器的擷取器元件

必備條件:

在規則型日誌剖析器中,擷取器的角色是採取感應器所提供的輸入行集合,將它們分到各個訊息界限中。 如果要配置擷取器,您必須先決定要用的擷取器類別。 之後,您可以根據所選的擷取器類別來配置擷取器規則

配置擷取器類別

所用的預設擷取器類別是一個正規表示式擷取器。 您可以在配接器配置檔的環境定義區段中,修改擷取器元件來改變擷取器元件。

  1. 在「配接器配置編輯器」中,展開環境定義 > 環境定義基本實作環境定義節點。 右窗格會顯示「基本實作環境定義」詳細資料。
  2. 選取元件正規表示式擷取器。 右窗格會顯示擷取器內容。

    內容窗格列出擷取器名稱、說明執行類別

  3. 將執行類別更新為您要用的類別。如果需要詳細資料,請參閱通用日誌配接器提供的擷取器類別之配置檔結構參照主題。
  4. 儲存配接器配置檔變更。

配置擷取器規則

決定要用的擷取器類別之後,您可以撰寫環境定義實例中擷取器的對應規則。

  1. 在配接器配置編輯器的左窗格中,選取配置 > 環境定義實例 > 擷取器。 這時右窗格會顯示擷取器資訊。

    感應器配置

  2. 如果日誌檔包含在檔案中跨越多行的記錄,請選取包含換行勾選框。 如果日誌檔中的各行是分開的記錄或日誌檔中沒有任何換行,請勿選取這個勾選框。
  3. 如果您要用替代符號來取代換行,請選取取代換行,在換行符號欄位中輸入這個符號。
    附註:使用這個選項的負面影響是,從日誌檔剖析出來的值不會包含換行,除非用剖析器替代規則明確新增換行。
  4. 開頭型樣欄位中,撰寫一個用來識別開頭型樣的 Script 片段。 預設正規表示式是一個脫字符號 (^),為符合字串或行開頭的空值記號。
  5. 如果要在結果中併入開頭型樣,請勾選包括開頭型樣勾選框。
  6. 結尾型樣欄位中,撰寫一個用來識別結尾型樣的 Script 片段。 預設正規表示式是一個錢幣符號 ($),為符合字串或行結尾的空值記號。
  7. 如果要在結果中併入結尾型樣,請選取包括結尾型樣勾選框。
    提示:為了協助您識別開頭和結尾型樣,請按一下重新執行圖示「重新執行配接器」圖示,再按一下顯示日誌「顯示日誌」圖示圖示。 感應器所讀取的日誌內容會顯示在「感應器結果」視圖中。
  8. 儲存配接器配置檔來套用變更。
  9. 如果要測試您的規則,請按一下重新執行配接器「重新執行配接器」圖示圖示來執行配接器。 結果會顯示在「擷取器結果」視圖中。
    提示:您可以指定要開始檢視的記錄編號。使用「重新執行」配接器圖示中的可用下拉清單和選取從記錄開始。 這時會開啟一個對話框,供您指定要開始的記錄編號。
  10. 按一下顯示下一事件「顯示下一事件」圖示圖示來查看您撰寫的擷取器規則處理過的每筆日誌記錄。

    「擷取器結果」視圖中的擷取器規則和輸出結果,略過開頭型樣,使用預設結尾型樣。


    提示:如果要變更可檢視的結果項目數量, 請按一下「通用日誌配接器」喜好設定圖示通用日誌配接器喜好設定圖示, 以啟動喜好設定頁面。啟動喜好設定頁面後,請更新緩衝區大小。

如果需要擷取器內容的詳細說明,請參閱配接器配置檔結構參照文件。

建立規則型配接器的下一步驟是配置剖析器元件。

相關概念
Hyades 通用日誌配接器概觀

相關作業
配置剖析器元件

相關參照
配接器配置檔結構
配接器配置編輯器
正規表示式文法
配接器配置編輯器的限制