BetterStack 結構化日誌輔助自動化 - n8n 工作流程

DevOps 與監控核心邏輯與流程控制

一個強大且可重複使用的 n8n 工作流程範本，透過 n8n 的 HTTP Request 節點將結構化訊息（層級、內容）發送到 BetterStack，以集中化日誌管理。簡化您所有 n8n 範本的監控作業。

工作流預覽

準備好自動化了嗎？

下載此 n8n 工作流程範本並立即開始使用。

n8n 工作流使用的節點

HTTP Request

Execute Workflow Trigger

Execute Sub-workflow

Sticky Note

Manual Trigger

適用對象

需要為自動化流程集中化日誌的 DevOps 工程師。
運行大量需要穩健錯誤監控的 n8n 範本的 n8n 資深用戶。
希望在其 n8n 工作流程設計中，將日誌記錄邏輯與核心自動化業務邏輯分離的開發人員。
正在尋找專注於可觀測性（Observability）的特殊 n8n 範本的用戶。

總覽

對於複雜的自動化設置來說，維持全面的可觀測性至關重要。這個特定的 n8n 工作流程範本透過充當專用的日誌服務，來解決集中化、結構化日誌記錄的需求。您不再需要在每個主要的 n8n 工作流程中重複呼叫日誌 API，只需使用 n8n 的 Execute Workflow 節點呼叫這個可重複使用的 n8n 工作流程即可。這種方法能讓您的主要 n8n 範本更簡潔、更易於維護，並確保日誌格式一致。當任何正在運行的 n8n 工作流程中發生錯誤或關鍵事件時，這個日誌 n8n 工作流程會處理將日誌資料（內容和嚴重性層級）安全傳輸到 BetterStack 的工作，從而大幅提升事件應對和監控能力。

運作方式

此自動化主要在您更廣泛的 n8n 環境中作為一個可呼叫的服務運作。此流程由一個專門用於工作流程間通訊的特定 n8n 觸發器啟動：

接收觸發訊號： n8n 工作流程以「接收日誌訊息 (Recieve log message)」n8n 觸發器（即 Execute Workflow 觸發器）啟動。此觸發器等待另一個正在運行的 n8n 工作流程或 n8n 範本進行呼叫，預期接收包含 level（例如：'error'、'info'）和 message 的結構化輸入資料。

資料結構化： 由 n8n 觸發器捕獲的接收資料會接著進行動態映射。

API 傳輸： 設定為 HTTP Request 的「發送到 BetterStack 記錄 (Send Log to BetterStack)」n8n 節點會擷取結構化輸入（message 和 level），並將其格式化為 BetterStack Logs API 所需的 JSON 負載。

安全傳送： n8n 節點利用儲存的 Header Authentication 憑證，向 BetterStack 端點執行安全的 POST 請求，從而完成日誌記錄程序。

示範路徑： 內含的「測試工作流程 (Test workflow)」n8n 節點（手動觸發）和「發送測試日誌訊息 (Send test log message)」n8n 節點，示範了如何從任何其他 n8n 工作流程正確呼叫此日誌服務，並傳遞必要的輸入變數。

安裝指南

若要有效部署和使用此日誌 n8n 工作流程範本，請遵循以下步驟：

匯入 n8n 工作流程： 複製提供的 JSON 資料，並透過「工作流程 (Workflows)」視圖直接匯入您的 n8n 實例中。

設定 BetterStack 憑證： 此 n8n 工作流程需要 HTTP Header Authentication 才能安全存取 BetterStack Logs API。

前往 n8n 中的「憑證 (Credentials)」。
建立一個新的「HTTP Header Auth」憑證。
將「標頭名稱 (Header Name)」設定為 Authorization。
將「標頭數值 (Header Value)」設定為您的 BetterStack 存取權杖 (Bearer token)（例如：Bearer YOURAPIKEY）。
* 將此憑證指派給「發送到 BetterStack 記錄 (Send Log to BetterStack)」n8n 節點。

設定端點： 編輯「發送到 BetterStack 記錄 (Send Log to BetterStack)」n8n 節點，並輸入您的特定 BetterStack Logs 擷取端點 URL。

在其他 n8n 範本中使用： 在您的主要 n8n 工作流程中，使用「執行工作流程 (Execute Workflow)」n8n 節點。將其設定為呼叫此日誌工作流程的 ID，並確保傳遞預期的參數：level 和 message。

節點詳情

接收日誌訊息 (Recieve log message) (Execute Workflow 觸發器)： 此關鍵的 n8n 觸發器將工作流程設定為可被其他 n8n 範本呼叫的可重複使用 API 端點。它定義了所需的輸入：level 和 message。
發送到 BetterStack 記錄 (Send Log to BetterStack) (HTTP Request n8n 節點)： 此 n8n 節點負責與日誌服務進行實際通訊。
功能： 向 BetterStack Logs API 發送 POST 請求。
關鍵配置： 使用 JSON 內文（{"message":"{{ $json.message }}", "level": "{{ $json.level }}"}），動態抓取起始 n8n 觸發器的資料。它使用 HTTP Header Auth 憑證進行安全傳輸。
測試工作流程 (Test workflow) (Manual Trigger)： 僅用於匯入後測試此 n8n 工作流程的邏輯。
發送測試日誌訊息 (Send test log message) (Execute Workflow n8n 節點)： 示範任何其他 n8n 工作流程如何呼叫此日誌子工作流程。它會傳遞範例資料（level: error，message: This is a test log message）來測試此日誌 n8n 節點的功能。