任務控制-結果通知

1.1 版本

1.2 功能簡介

任務執行失敗後，可通知相關人員任務執行失敗。

• 通知渠道：平台、郵件、簡訊、釘釘群機器人、飛書群機器人、企業微信群機器人。

• 通知內容：任務異常通知、髒資料通知、源表結構變化通知。

注：数据开发-定时任务需要发布到「生产模式」中，才能使用该功能。

1.3 前提條件

若需要使用信箱或者簡訊通知，需要在平台進行配置，步驟請參見：信箱、短信

任務執行失敗後，可通知相關人員任務執失敗。

「結果通知」功能預設是關閉狀態，需要手動開啟。

需注意以下幾點：

1）訊息通知僅在任務執行失敗時，才會通知，任務執行成功不會通知。

2）單個任務的通知限制 10s 一次。例如：

A 任務配置了任務失敗提醒和髒資料提醒，在 10:00:00，因為髒資料超限導致任務停止。在 10:00:00~10:00:09.999 之間，如果 A 任務被重複觸發，同樣因為髒資料超限導致任務停止，不會再重複提醒。在 10:00:00~10:00:09.999 之間，如果 B 任務因為髒資料超限導致任務停止，會再提醒（因為不是同一個任務）。

3）4.1.5.5 以及之後的版本，當構建任務失敗，也會給予通知，例如設定通知渠道為「平台」，如下圖所示：

2.1 結果通知按鈕

預設關閉，需要手動開啟。

2.2 通知內容

2.2.1 任務異常通知

任務失敗提醒預設為（預設勾選，不可取消）：

獨立部署中，各個渠道的通知內容統一為：${任務名} 運作失敗，開始執行時間為 2023-03-21 15:22:38，結束時間為 2023-03-21 15:22:41，請前往【任務維運】-【定時任務】-【運作記錄】查看詳情

具體報錯資訊：

預設不勾選，勾選後，若任務失敗，將傳送報錯資訊

各個渠道的通知內容統一為：

${任務名} 運作失敗，開始執行時間為 2023-03-21 15:22:38，結束時間為 2023-03-21 15:22:41，報錯節點為【${節點名稱}】，具體報錯資訊。更多報錯內容請前往【任務維運】-【定時任務】-【運作記錄】查看詳情

報錯範例：

多個節點出錯，各個渠道的通知內容統一為：

${任務名} 運作失敗，開始執行時間為 2023-03-21 15:22:38，結束時間為 2023-03-21 15:22:41，報錯節點為【${節點名稱}】，具體報錯資訊；報錯節點為【${節點名稱}】，具體報錯資訊。更多報錯內容請前往【任務維運】-【定時任務】-【運作記錄】查看詳情

2.2.2 髒資料通知

1）出現髒資料按鈕：勾選「髒資料通知」按鈕後，「出現髒資料」按鈕預設勾選。當定時任務出現髒資料後，進行通知。

2）髒資料匯總資訊按鈕：勾選後，在定時任務運作完成後，將髒資料按照原因匯總傳送給使用者。

3）具體報錯內容如下表所示：

4）任務日誌的「統計」Tab下，展示統計物件的髒資料行數；點選髒資料行數可展開查看各錯誤原因分類下的髒資料條數。

2.2.3 源表結構變化通知

詳情使用步驟請參見：設定結果通知

為了保證定時任務的來源表 DDL 變化能通知使用者，可在「任務控制>結果通知」下設定通知情況。當運作中的任務出現來源表的 DDL 變化時，即會通知資訊給使用者。如下所示：

2.3 平台使用者組

當通知渠道為簡訊/郵件/平台渠道時：基於平台體系配置通知物件，通知物件可選擇平台使用者、部門、角色，三者取並集。

2.4 通知渠道

統一說明：

1）當通知渠道選擇簡訊/郵件/平台時，「通知物件」中需要勾選「平台使用者組」按鈕。如下圖所示：

2）通知渠道選擇簡訊/信箱時，「自訂收件人」與「平台使用者組」不能同時為空。

3）通知渠道選擇簡訊/信箱時，「自訂收件人」不支援引用參數。

4）通知渠道選擇簡訊/信箱時，「平台使用者組」中選擇了 A 使用者，自訂收件人中也設定了 A 使用者，不做重複通知。

具體設定說明：

通知渠道選擇「用戶端」時，可設定通知渠道為釘釘/飛書/企業微信。

注：一個通知渠道中，Webhook 地址不支援填寫多個。

釘釘群機器人 Webhook 地址：可參考 自訂機器人接入

飛書群機器人 Webhook 地址：自訂機器人使用指南

企業微信群機器人 Webhook 地址：新增群機器人步驟如下圖所示，機器人新增成功的提示頁面上會有 webhook 地址：