配置實時管道任務-任務控制

  • 文檔創建者:Roxy
  • 編輯次數:18
  • 最近更新:shuning 于 2026-06-29
  • icon提示:
    本文內容適用於 4.2.11.3 及之後版本;4.2.11.3 之前版本,請參見:曆史文檔


    1. 概述

    1.1 版本

    FineDataLink版本
    功能變動
    4.0.26「管道控制」步驟中,新增「失敗重試」設定
    4.2.19.1新增「WeLink」通知方式
    4.2.19.4釘釘通知渠道中,新增「提醒方式」、「群成員列表」設定項


    1.2 歷史版本更新

    FineDataLink版本功能變動
    4.0.27髒資料臨界值由某個任務在某次開始運作到結束運作的區間臨界值變為任務自建立至今整體臨界值
    4.0.28

    「結果通知」中:

    • 新增釘釘、飛書、企業微信通知渠道

    • 簡訊/郵件/平台渠道:基於平台體系配置通知物件,通知物件可選擇平台使用者、部門、角色,三者取並集

    4.1.1可為管道任務單獨設定日誌匯出級別
    4.2.1.1髒資料臨界值改名為表髒資料臨界值

    通知內容中,可設定:當任務或表失敗重試時,發出通知

    管道任務中的表出現異常時,支援自動重試功能

    4.2.1.2建立管道任務時,日誌等級預設設定為 INFO
    4.2.11.3任務控制設定項,位置行動

    通知內容劃分為任務級和表級,任務級和表級異常重試、或異常中止時,都可以進行通知

    4.2.13.3「企業微信群機器人」通知方式更名為「企業微信群訊息推播」
    4.2.14.4通知內容新增「同步延遲」
    4.2.15.1通知內容中新增「髒資料變化(每小時通知)」


    1.2 功能簡介

    設定來源表目標表映射關系後,即可對實時管道任務進行任務執行控制。如下圖所示:

    2. 操作步驟

    2.1 單表髒資料臨界值

    注1:限制最多10w行,且處理髒資料後,會重置臨界值統計。

    注2:若需要對産生的髒資料進行處理,詳情參見:管道任務處理髒資料

    管道任務中單表髒資料達到表髒資料臨界值後,任務會異常中止。

    2.2 設定失敗重試

    管道任務管道任務包含的表由於當時的網路波動或者其他原因,運作中斷,過段時間網路即可恢複正常,希望可自動重新運作,可在「失敗重試」中設定重跑次數和間隔時間。


    設定項
    說明
    重跑次數預設值為 3 次,最大值為 10 次
    間隔時間預設值為 2 分鍾,最大值為 60 分鍾

    具體說明如下表所示:

    級別
    錯誤說明開啟失敗重試效果
    任務級
    來源端網路異常

    網路連結失敗(僅包含網路問題

    觸發自動重試,重試邏輯:

    1)若全量同步未完成,會從頭全量同步;若全量同步已完成,會從斷點開始;即全量階段沒有斷點,只有增量階段有斷點同步

    2)管道任務只要重新運作了,都是按第一次開始重新計算

    配置庫異常

    配置庫讀寫失敗(包含網路、欄位、權限等所有會引起配置庫讀寫失敗的問題)

    訊息佇列異常

    網路連結失敗(僅包含網路問題)

    來源端非網路原因異常(各類源端日誌異常問題)不支援失敗重試功能
    其他非預期異常
    表級

    産生髒資料

    包含任何因為目標端異常而沒寫進去資料的情況

    全量階段髒資料達到臨界值
    增量階段髒資料達到臨界值4.2.1.1 及之後版本,則按照配置自動觸發髒資料重試(對髒資料進行重試),同時表狀態變為「髒資料處理中」

    2.3 設定結果通知

    可設定當任務異常時的通知。如下圖所示:

    注1:結果通知中勾選源表結構變化相關介紹詳情參見:資料管道-同步源表結構變化

    注2:單個管道任務失敗的通知限制為 10s 一次。


    2.3.1 通知內容

    4.2.1.1 及之後版本,任務或表失敗重試時可進行通知。

    通知項
    通知內容格式
    任務異常重試

    通知時機:

    管道任務異常,進入第一次重試

    通知內容

    • 標題:[實時管道] 任務 #jobname# 發生異常重試

    • 內容:實時管道任務 #jobname# 發生網路或其他因素導致的異常,正在進行重試,請即時關注並處理

    任務異常中止通知時機:

    管道任務異常中止 

    通知內容:

    • 標題:[實時管道] 任務 #jobname# 發生異常中止

    • 內容:實時管道任務 #jobname# 異常中止,可能是網路因素或其他導致任務無法繼續運作的異常因素,請即時關注並處理

    表同步異常重試
    通知時機通知內容

    表同步時,出現異常,進入第一次重試

    從識別到第一個表同步出現此情況開始,收集 3min 內具體相同情況的表同步物件,統計為 list 放到通知內容裏

    標題

    [實時管道]  任務 #jobname# 發生表同步重試

    內容

    實時管道任務 #jobname# 中存在寫入異常的表同步物件,正在對進行重試寫入,源表: #sourcetablename_list#,請即時關注

    重試完成,表同步恢復正常

    從識別到第一個表同步出現此情況開始,收集 3min 內具體相同情況的表同步物件,統計為list放到通知內容裏

    標題

    [實時管道] 任務 #jobname# 表同步重試成功

    內容

    實時管道任務 #jobname# 中源表: #sourcetablename_list# 重試完成,已正常恢復同步,請即時關注

    表同步異常中止通知時機

    表異常中止

    從識別到第一個表同步出現此情況開始,收集3min內具體相同情況的表同步物件,統計為list放到通知內容裏 

    通知內容: 

    • 標題:[實時管道] 任務 #jobname# 發生表同步中止

    • 內容:實時管道任務 #jobname# 中存在異常中止的表同步物件,源表: #sourcetablename_list#,請即時關注並處理

    源表結構變化

    通知時機:

    表同步時,源表發生表結構變化 

    通知內容: 

    • 標題:[實時管道] 任務 #jobname# 發生源表結構變化

    • 內容:實時管道任務 #jobname# 出現源表結構變化,源表 #tablename# 變化情況:#changetype#,在目標表應用情況:#applyresult#,請即時關注。

    同步延遲

    2026-06-29_14-24-50.png

    應用場景

    解析異常、Kafka快取異常、寫入異常等問題會導致實時同步產生延遲,業務人員查看報表會發現資料不對,會反饋給 IT,IT會排查實時管道任務是否出現問題

    當實時管道寫入延遲過大時,或者待同步量過大時,希望能提醒 IT 人員

    功能簡介:

    每個表的同步延遲=解析延遲 + 寫入延遲

    1)支援配置單表延遲臨界值、通知間隔

    • 單表延遲臨界值:單位為分鐘、小時;值必須大於等於30

    • 通知間隔:單位為分鐘、小時;值必須大於等於1

    2)功能邏輯:

    • 當實時管道中的每一個表啟動運作時間>30時,才進行延遲檢查(防止啟動時追歷史資料,導致誤判延遲)

    • 當表的同步延遲超過臨界值時,進入延遲磁軌狀態:每1min進行檢查,管道任務中所有表的延遲時間;如果存在一張表連續超過 5 次檢查,延遲時間持續超過臨界值,則觸發通知

    • 當觸發通知後,在通知間隔內,不再傳送新通知,通知間隔按任務級計時

    3)通知內容:

    實時管道${任務名稱}同步延遲警報,請即時處理,延遲情況如下:${表名}同步延遲${最新同步延遲時間}、${表名}同步延遲${最新同步延遲時間}....等(只列印10張表的情況,按同步延遲時間降冪列印前十張)

    髒資料變化(每小時通知)應用場景:

    實時管道任務產生髒資料時,不會進行通知,等維運人員處理髒資料時,可能已經超過 Kafka 的儲存時間,導致需要重新同步管道任務,恢復成本較高

    功能簡介:

    1)將過去一個小時中產生的髒資料情況通知給使用者(若過去一小時沒產生髒資料,則不通知)

    2)通知頻率為一小時通知一次

    注:髒資料的 topic 訊息儲存時間調整為 30 天

    3)通知內容:

    • 標題:[實時任務|實時管道]${任務名稱}新增髒資料

    • 內容:過去一小時,[實時任務|實時管道]${任務名稱}新增了髒資料,可能導致資料不一致,請即時處理,髒資料情況如下:${表名}新增${該表髒資料條數}條髒資料、${表名}新增${該表髒資料條數}條髒資料....

    2.3.2 平台/郵件/簡訊說明

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

    • 通知渠道選擇簡訊/信箱時,「自訂收件人」與「平台使用者組」不能同時為空;其中,「自訂收件人」不支援引用參數。

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

    2.3.3 釘釘/飛書/企業微信/WeLink設定說明

    通知渠道選擇「使用者端」時,可設定通知渠道為釘釘群機器人/飛書群機器人/企業微信群機器人/WeLink 。

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

    2026-06-29_11-29-55.png


    1)釘釘群機器人 Webhook 地址:可參考 自訂機器人接入;4.2.19.4 及之後版本,新增「提醒方式」、「群成員列表」設定項,詳情請參見:釘釘群機器人

    目前暫不支援在釘釘群機器人中設定加簽 。

    2026-06-29_11-54-04.png

    2)飛書群機器人 Webhook 地址:自訂機器人使用指南

    3)企業微信群訊息通知 Webhook 地址:新增群訊息推播步驟如下圖所示,新增成功的提示頁面上會有 webhook 地址:

    4)4.2.19.1 及之後版本,新增「WeLink」通知方式,具體設定項說明請參見:WeLink

    2.4 日誌等級

    可為管道任務單獨設定日誌匯出級別,滿足使用者按需查看日誌、除錯和排錯的需求;可以在更細粒度的日誌等級裏,列印詳細的日誌,供使用者查看。

    如下圖所示:

    注:4.2.1.2 及之後版本,建立管道任務時,日誌等級預設設定為 INFO。

    1)匯出的日誌說明:管道任務:讀寫程式日誌\異常和錯誤日誌。

    2)預設不開啟,未開啟時使用 全局設定的業務日誌等級記錄日誌全局日誌等級預設為 WARN。

    3)僅在管道未處於運作狀態時可以配置,啟動後生效。

    4)日誌級別可選擇 ERROR、WARN、INFO。

    • 日誌級別大小排序(嚴重程度):ERROR>WARN>INFO

    • 日誌詳細程度排序:ERROR<WARN<INFO

    日誌級別
    說明
    ERROR錯誤,異常情況導緻不可用
    WARN警告,可能會出現問題,但是依然可用,屬於警報
    INFO普通資訊,用於記錄運作狀態或重要事件

    5)調整單個管道任務的日誌匯出級別後,若修改了全局的日誌級別全局日誌的級別不會影響手動修改過日誌等級任務的級別。

    3. 後續步驟

    1)點選「啟動所有表按鈕,實時同步所有來源表。如下圖所示:

    2)進行任務維運管理:單個管道任務管理管道任務維運

    3)實時管道任務運作一段時間後,若想修改任務配置,請參見:管理實時管道任務

    附件列表


    主題: 實時管道
    • 有幫助
    • 沒幫助
    • 只是瀏覽
    中文(繁體)

    滑鼠選中內容,快速回饋問題

    滑鼠選中存在疑惑的內容,即可快速回饋問題,我們將會跟進處理。

    不再提示

    10s後關閉

    獲取幫助
    線上支援
    獲取專業技術支援,快速幫助您解決問題
    工作日9:00-12:00,13:30-17:30在线
    頁面反饋
    針對當前網頁的建議、問題反饋
    售前咨詢
    業務咨詢
    電話:0933-790886或 0989-092892
    郵箱:taiwan@fanruan.com
    頁面反饋
    *問題分類
    不能為空
    問題描述
    0/1000
    不能為空

    反馈已提交

    网络繁忙