實踐:Webhook 告警自動處理 | LanSphere 使用手冊

實踐:Webhook 告警自動處理

本篇以「Webhook 告警自動處理」為例,講解 LanSphere 工作流中 Webhook 回呼觸發器、條件判斷分級路由、知識庫檢索同藍信 MCP 通知嘅組合用法。同定時觸發唔同,Webhook 由外部系統主動調用,適合事件驅動嘅即時回應場景。適合需要對接監控系統、實現告警自動分發同處理嘅運維同開發人員閱讀。

場景與價值

監控系統產生嘅告警靠人工盯螢幕處理,問題唔少:

  • 告警全天候產生,夜間同假日無人值守嗰陣容易漏看;
  • 唔同級別告警混埋一齊,值班人分唔清輕重緩急;
  • 告警到咗唔知點處理,翻文件查方案嘥時間;
  • P0 緊急告警需要同時通知值班人同應急群組,手動操作延誤回應。

用工作流將告警處理鏈路自動化:外部監控系統透過 Webhook 回呼觸發 → 條件判斷按級別分路 → 知識庫檢索處理方案 → 大模型生成摘要 → 藍信 MCP 通知對應人員同群組,實現秒級回應、分級觸達。

你將搭建咩

一個「告警自動處理」工作流應用:由外部監控系統透過 Webhook 回呼觸發,接收告警 JSON 數據(告警級別、系統名稱、告警內容、時間戳);條件判斷節點按級別分為 P0 緊急、P1 重要、P2 一般三路——P0 檢索知識庫後大模型生成摘要,同時透過藍信 MCP 私訊通知值班人同群組訊息通知應急群組;P1 檢索知識庫後大模型生成摘要,群組訊息通知運維群組;P2 大模型生成摘要後記錄到輸出。

鏈路:Webhook 回呼 → 條件判斷 → [P0 → 知識庫 → 大模型 → MCP(私訊值班人)+ MCP(群組訊息應急群組)] / [P1 → 知識庫 → 大模型 → MCP(群組訊息運維群組)] / [P2 → 大模型 → 輸出] → 輸出

推薦流程

步驟 說明
1 準備工作 建立運維知識庫、新增藍信 MCP 服務、確認值班人同群組 ID
2 建立應用 新建工作流,設定 Webhook 回呼觸發器
3 編排畫布 條件判斷分三路 → 知識庫 → 大模型 → MCP 通知 → 輸出
4 模擬調試 用模擬 Webhook 請求測試各告警級別
5 儲存上線 發布並對接監控系統調用回呼地址

準備工作

項目 要求
平台角色 開發人員及以上(建立工作流、新增 MCP 服務)
運維知識庫 已建立運維知識庫(常見告警處理方案、運維 SOP),已通過召回測試
藍信 MCP 服務 已喺「左側選單 → MCP 服務」中新增藍信 MCP 服務,「發送私訊訊息」同「發送群組訊息」工具可用
值班人同群組 ID 值班人藍信 staffId、應急群組同運維群組嘅群組 ID(可透過藍信 MCP 群組類工具查詢取得)
監控系統 外部監控系統能發送 HTTP POST 請求到 Webhook 回呼地址

第一步:建立應用並設定 Webhook 觸發器

  1. 點擊「新建項目」,應用類型選擇「工作流」,填寫名稱(例如「告警自動處理」)。
  2. 喺畫布中,開始節點選擇「Webhook 回呼」(替代預設嘅「輸入」節點)。新增後,平台會生成一個回呼地址,外部系統透過 POST 請求調用該地址即觸發工作流。
  3. Webhook 回呼節點會接收外部系統傳入嘅請求體,作為輸出變數供下游節點引用。監控系統通常傳入 JSON 格式嘅告警數據,欄位示例:
{
  "level": "P0",
  "system": "訂單服務",
  "content": "資料庫連線數超過閾值,目前 980/1000",
  "timestamp": "2026-08-04T02:30:00Z"
}
  1. 喺環境變數中新增值班人同群組 ID 變數(例如 DUTY_STAFF_IDEMERGENCY_GROUP_IDOPS_GROUP_ID),值設為對應嘅藍信 ID,設為保密變數

注意:回呼地址係觸發工作流嘅唯一入口,儲存並發布後先至可以被外部系統調用。調試階段可用頁面提供嘅模擬請求功能測試。

第二步:編排條件判斷分支

  1. 新增「條件判斷」節點,連接喺「Webhook 回呼」節點之後。
  2. 設定三個分支,按告警 JSON 中嘅 level 欄位判斷:
分支 判斷條件 走向
P0 緊急 level 等於 P0 知識庫 → 大模型 → MCP(私訊)+ MCP(群組訊息)
P1 重要 level 等於 P1 知識庫 → 大模型 → MCP(群組訊息)
P2 一般 level 等於 P2 大模型 → 輸出
  1. 設定兜底分支,未知級別行 P2 路徑(生成摘要後記錄到輸出)。

提示:條件判斷嘅分支條件引用 Webhook 回呼節點輸出變數中嘅 level 欄位,確保欄位名稱同監控系統傳入嘅 JSON 一致。

第三步:P0 與 P1 分支連接知識庫與大模型

P0 同 P1 分支嘅鏈路結構相似,以 P0 為例:

  1. 新增「知識庫」節點,關聯運維知識庫,輸入引用告警 content 欄位(Webhook 輸出變數),設定 Top K 為 3、檢索方式為混合檢索。
  2. 新增「大模型」節點,連接喺知識庫之後,上下文引用告警數據同知識庫召回片段,提示詞示例:
你係運維告警助手。以下係監控系統傳入嘅告警資訊同從知識庫中檢索到嘅處理方案:

告警級別:(此處插入 level 變數)
告警系統:(此處插入 system 變數)
告警內容:(此處插入 content 變數)
告警時間:(此處插入 timestamp 變數)
檢索結果:(此處插入知識庫節點嘅輸出變數)

請生成一段告警摘要同處理建議,要求:
1. 開頭標註告警級別同系統名稱,一句說話概括告警內容。
2. 依據檢索結果給出處理建議,分條陳述。
3. 檢索結果中冇對應方案嗰陣,回覆「暫無標準處理方案,請值班人員排查」。
4. 全文控制喺 200 字以內,適合喺群組中快速閱讀。
  1. P1 分支按相同方式連接知識庫同大模型,提示詞結構一致。

第四步:MCP 節點通知值班人與群組

P0 分支(雙路通知)

  1. 喺大模型節點之後新增第一個 MCP 節點,選擇藍信 MCP 嘅「發送私訊訊息」工具:
    • 接收人引用環境變數 DUTY_STAFF_ID
    • 訊息內容引用大模型節點嘅輸出。
  2. 新增第二個 MCP 節點,選擇「發送群組訊息」工具:
    • 群組 ID 引用環境變數 EMERGENCY_GROUP_ID
    • 訊息內容引用大模型節點嘅輸出。

注意:P0 分支嘅兩個 MCP 節點為串行連接——先私訊通知值班人,再群組訊息通知應急群組。如需並行通知,可使用「批處理」節點。

P1 分支(群組訊息通知)

喺大模型節點之後新增 MCP 節點,選擇「發送群組訊息」工具:

  • 群組 ID 引用環境變數 OPS_GROUP_ID
  • 訊息內容引用大模型節點嘅輸出。

P2 分支(僅記錄)

P2 分支唔檢索知識庫、唔發通知。新增「大模型」節點,上下文引用告警數據,提示詞生成簡要摘要(一句說話概括告警內容即可),直接連接輸出節點記錄。

第五步:連接輸出節點

  1. 三個分支最終都連接到「輸出」節點。輸出內容引用各分支嘅處理結果:
    • P0/P1:引用大模型摘要同 MCP 節點嘅發送結果;
    • P2:引用大模型節點嘅摘要。
  2. 工作流透過「輸出」節點喺結束嗰陣返回處理結果,供「對話日誌」中追溯。

節點設定速查表

節點 關鍵設定 說明
Webhook 回呼 接收告警 JSON 外部系統觸發入口
條件判斷 level 分三路 + 兜底 按告警級別分路
知識庫(P0/P1) 關聯運維知識庫;Top K 3;混合檢索 檢索處理方案
大模型(×3) 摘要提示詞 + 引用告警數據同召回片段 生成告警摘要
MCP(發送私訊訊息) 淨係 P0;接收人引用 DUTY_STAFF_ID 私訊通知值班人
MCP(發送群組訊息) P0 引用 EMERGENCY_GROUP_ID;P1 引用 OPS_GROUP_ID 群組訊息通知
輸出 引用各分支結果 返回處理結果

第六步:模擬 Webhook 請求調試

Webhook 觸發嘅工作流無法用普通嘅整體調試直接測試,需要模擬外部系統嘅 POST 請求:

  1. 喺 Webhook 回呼節點嘅設定中,查看平台提供嘅回呼地址同請求格式說明。
  2. 用工具(例如 curl 或 Postman)向回呼地址發送模擬請求,分別測試三個級別:
# P0 緊急告警示例
curl -X POST {回呼地址} \
  -H "Content-Type: application/json" \
  -d '{"level":"P0","system":"訂單服務","content":"資料庫連線數超過閾值","timestamp":"2026-08-04T02:30:00Z"}'
  1. 逐節點檢查:
    • Webhook 回呼:確認節點接收咗完整嘅告警 JSON;
    • 條件判斷:確認告警入咗正確嘅級別分支;
    • 知識庫:確認召回片段同告警內容相關;
    • 大模型:確認摘要包含告警資訊同處理建議,冇編造;
    • MCP 節點:確認值班人/應急群組/運維群組收到咗對應訊息。
  2. 每個節點嘅輸入、輸出同報錯都可喺調試詳情中查看,過往記錄進入「調試歷史」回睇。

常見問題排查:

現象 排查方向
Webhook 未觸發 回呼地址係咪正確;監控系統係咪已儲存並發布;POST 請求係咪到達平台
告警級別路由錯誤 level 欄位名稱係咪同監控系統傳入嘅 JSON 一致;條件判斷分支條件係咪正確
知識庫召回唔相關 用召回測試複查運維知識庫;調大 Top K;補充告警處理文件
MCP 通知未送達 staffId / 群組 ID 係咪正確;藍信 MCP 服務授權係咪有效;MCP 節點報錯資訊
P0 雙路淨係通知咗一方 兩個 MCP 節點係咪都正確連接;環境變數引用係咪正確

第七步:儲存與上線

  1. 點擊「儲存」儲存工作流。發布前檢查清單會自動檢查設定完整性同邏輯正確性,按提示補齊缺漏。
  2. 點擊「儲存」按鈕下拉 →「發布到應用廣場」,或透過「發布渠道」頁籤開通 API 存取。
  3. 複製 Webhook 回呼地址,設定到外部監控系統嘅告警通知規則中,令佢喺產生告警嗰陣自動調用回呼地址。
  4. 上線後進入應用詳情頁「對話日誌」頁籤,查看每次告警嘅觸發記錄、分級路由同通知結果。

提示:上線初期建議值班人確認收到通知後回覆處理結果,核對告警級別路由同通知觸達係咪準確,先放手令告警鏈路自動執行。

調優與邊界

現象 調整方法
告警頻繁觸發導致訊息洗版 喺條件判斷前加「變數賦值」節點做去重或限頻;P2 告警改為僅記錄唔通知
知識庫缺少某類告警方案 補充運維 SOP 文件到知識庫後重建索引
值班人輪換 DUTY_STAFF_ID 改為外部介面動態查詢目前值班人,用 HTTP 請求節點取得
需要告警升級機制 喺 P1 分支加「條件判斷」子分支,逾時未處理嗰陣升級為 P0 通知
監控系統欄位格式唔同 喺條件判斷前加「腳本執行」節點做欄位對映,統一為 level / system / content 格式

擴展思路

  • 告警聚合:用「腳本執行」節點對短時間內同一系統嘅多條告警做聚合,合併為一條通知;
  • 自動回復偵測:監控系統喺告警回復嗰陣再次調用 Webhook,工作流根據 level 行回復通知分支;
  • 工單系統聯動:P0 告警額外連接工單系統 MCP 建立工單,自動派單俾值班人;
  • 多渠道通知:除藍信外,透過 HTTP 請求節點調用短訊/電郵閘道,實現多渠道觸達;
  • 告警看板:將每次告警處理結果透過 HTTP 請求寫入數據看板系統,統計告警趨勢同回應時長。