設定自訂剖析器

支援的服務:

本文說明如何在沒有預建剖析器,或需要更多控制權時,建立自訂剖析器。自訂剖析器會與預建剖析器一起顯示在剖析器清單中。

常見用途包括:

限制和不支援的操作

建立及管理自訂剖析器時,請考量下列作業限制:

  • 剖析器語法與 YARA-L 偵測規則:擷取剖析器和剖析器擴充功能會在擷取時,使用 Logstash Grok 和設定語法搭配篩選器 (例如 grok、mutate、json、date 和 base64),將原始記錄剖析為 Unified Data Model (UDM)。剖析器無法使用 YARA-L 語法、結果區塊或產生器函式 (例如 yield)。YARA-L 2.0 嚴格來說是一種偵測引擎查詢語言,會在下游對標準化 UDM 事件進行評估,用於威脅警示,無法剖析原始記錄、變更 UDM 欄位或捨棄傳入的記錄流量。
  • 1:1 擷取模型:Google SecOps 自訂剖析器嚴格按照 1:1 關係運作。自訂剖析器無法將包含多個內嵌事件 (例如 JSON 陣列或串連字串) 的單一記錄項目,取消批次處理、迴圈或分割成獨立的 UDM 事件。您必須先使用記錄收集管道 (例如 BindPlane OP、OpenTelemetry Collector、Fluent Bit 或預先擷取的 Cloud Run 函式) 分割多事件酬載,才能擷取。
  • drop {} 篩選器行為:剖析器中的 drop {} 篩選器只會抑制 UDM 事件生成。剖析器捨棄記錄時,Google SecOps 不會建立 UDM 記錄,偵測規則也無法評估事件。不過,Google SecOps 會將原始記錄保留在不可變更的原始存放區,以符合法規遵循和稽核保留規定。您仍可透過原始記錄檔搜尋功能,搜尋原始記錄檔。如要在儲存前捨棄記錄,請在轉送站或收集器中設定上游篩選。
  • 預設僅向前剖析:啟用自訂剖析器後,只會對啟用後新擷取的記錄套用。如果業務上有重要需求,必須將自訂剖析器對應套用至現有的歷來記錄,可以要求執行後端記錄重播工作。詳情請參閱「重新剖析歷來資料 (記錄重播)」。

根據對應指示建立自訂剖析器

您可以編寫程式碼,將原始記錄轉換為 UDM 記錄,藉此建立自訂剖析器。

延伸閱讀:

建立剖析器時,請盡可能填入重要的 UDM 欄位。

  1. 依序前往「設定」>「資料管理」>「剖析器」。如果使用的是 SIEM 專用平台,請依序前往「設定」>「剖析器」。

  2. 按一下「Create Parser」。

  3. 從「Log Source」(記錄來源) 清單中選取適當的記錄來源。

  4. 選取「僅使用原始記錄開始操作」,即可依據需求建立新的剖析器。

  5. 點選「建立」。

  6. 在「Parser Code Terminal」(剖析器程式碼終端機) 中輸入程式碼。詳情請參閱「建立程式碼片段對應操作說明」。

    注意:請確認自訂剖析器邏輯正確對應,並產生有效的目前時間戳記。如果自訂剖析器將時間戳記錯誤對應至標準保留期限以外的日期,資料會成功擷取,但無法在使用者介面中搜尋。搜尋功能會根據事件時間戳記篩選資料,因此即使資料成功擷取,只要對應到錯誤日期,就無法顯示。

  7. 選用:按一下「編輯」圖示 ,編輯現有的原始記錄或副本。

  8. 選用:按一下「載入」圖示 ,載入最新的原始記錄。

  9. 按一下「預覽」即可查看 UDM 輸出內容。如果代碼不正確,系統會顯示錯誤訊息。

    在預先發布版中,您可以使用 statedump 篩選器外掛程式,驗證剖析器的內部狀態。詳情請參閱「使用 statedump 外掛程式驗證資料」。

  10. 按一下「Validate」(驗證),驗證自訂剖析器。

    驗證程序可能需要幾分鐘,因此建議您先預覽自訂剖析器,視需要進行變更,然後再驗證自訂剖析器。

  11. 按一下「提交」。

    剖析器會在 20 分鐘後啟用,開始正規化程序。

根據現有剖析器建立自訂剖析器

使用現有剖析器做為範本,建立新的自訂剖析器。這個方法僅支援程式碼做法。如要開始使用,請按照下列步驟操作:

  1. 依序前往「設定」>「資料管理」>「剖析器」。如果使用的是 SIEM 專用平台,請依序前往「設定」>「剖析器」。

  2. 按一下「Create Parser」。

  3. 從「Log Source」(記錄來源) 清單中選取適當的記錄來源。

  4. 選取「使用現有的預先建構剖析器開始操作」,以現有剖析器為基礎,建立新的自訂剖析器。

  5. 點選「建立」。

  6. 在「Parser Code Terminal」(剖析器程式碼終端機) 中編輯程式碼。詳情請參閱「建立程式碼片段對應操作說明」。

  7. 選用:按一下 「Edit」(編輯),即可編輯原始記錄。

  8. 選用:按一下「 重新整理」,重新整理原始記錄。

  9. 新增程式碼來建構剖析器時,請按一下「預覽」查看 UDM 輸出內容。如果代碼不正確,系統會顯示錯誤訊息。

    在預先發布版中,您可以使用 statedump 篩選器外掛程式,驗證剖析器的內部狀態。詳情請參閱「使用 statedump 外掛程式驗證資料」。

  10. 按一下「Validate」(驗證),驗證自訂剖析器。

    驗證程序可能需要幾分鐘才能完成,因此建議您先預覽自訂剖析器,視需要進行變更,然後再驗證自訂剖析器。

  11. 按一下「提交」。

    剖析器會在 20 分鐘後啟用,開始正規化程序。

停用自訂剖析器

  1. 依序前往「設定」>「資料管理」>「剖析器」。如果使用的是 SIEM 專用平台,請依序前往「設定」>「剖析器」。

  2. 按一下要停用的剖析器旁的「 選單」,然後從清單中選取「停用」。

    「Make parser inactive」(停用剖析器) 對話方塊隨即顯示。

  3. 按一下「設為無效」。

自訂剖析器會停用,目前的預建剖析器版本則會在 20 分鐘後啟用。預建剖析器現在會成為預設剖析器。

刪除自訂剖析器

  1. 依序前往「設定」>「資料管理」>「剖析器」。如果使用的是 SIEM 專用平台,請依序前往「設定」>「剖析器」。

  2. 找到要刪除的自訂剖析器,按一下「選單」圖示 ,然後從清單中選取「刪除」。注意:您無法刪除預先建構的剖析器。

    系統會顯示「Delete custom parser」(刪除自訂剖析器) 對話方塊。

  3. 點選「刪除」。

自訂剖析器會刪除,目前的預建剖析器版本會在 20 分鐘後啟用。

建立擴充功能

剖析器擴充功能可讓您靈活擴充現有自訂剖析器的功能。不會取代自訂剖析器。而是能順暢地從原始記錄中擷取其他欄位,並加入 UDM 記錄。剖析器擴充功能與自訂剖析器不同。

如要建立剖析器擴充功能,請參閱「使用剖析器擴充功能」。

驗證狀態

「驗證」欄會顯示自訂剖析器或剖析器擴充功能的驗證測試狀態。

  • 剖析器失敗:自訂剖析器驗證失敗
  • 剖析器通過驗證:自訂剖析器驗證成功
  • 已略過:自訂剖析器未經驗證
  • 已略過擴充功能:剖析器擴充功能未經驗證

還有其他問題嗎?向社群成員和 Google SecOps 專家尋求解答。