tennnzo說明文件

Agent

排程工作

排程工作頁用一週行事曆列出 Agent 定時自己跑的工作,例如日報、海巡、匯出。這頁說明怎麼看每次執行的結果、篩選 Agent 與工作、切換時區,以及打開執行紀錄。

有些事 Agent 會定時自己跑,例如每天早上整理日報、固定時間海巡、每週匯出資料。這些是「排程工作」,和 Agent 看板 上別人交辦的卡不一樣,不會出現在看板上。

「排程工作」頁讓你一眼看到這週每個工作跑了幾次、有沒有失敗,點一下就能看執行紀錄。

頁面只列目前工作區的 Agent 回報的排程工作(見 組織、工作區與導覽)。

這一頁只有內部成員看得到。從側欄「Agent」底下的「排程工作」進入。

排程工作從哪裡來#

排程是 Agent 自己設定的。Agent 會把它的排程清單和每次執行的結果回報到 tennnzo,這頁只負責呈現,不能在這裡新增或修改排程。

還沒有任何排程時,頁面會顯示「還沒有排程工作。」,等 Agent 回報後就會出現。

切換週次與篩選#

頁面上方:

  • 「上一週」「下一週」切換週次,「本週」回到這一週。
  • 「Agent」:只看某個 Agent 的工作,或選「全部」。
  • 「工作」:只看某一個工作。
  • 「時區」:行事曆和時間依哪個時區顯示,預設是台北時間(Asia/Taipei),也可以選 Asia/Kuala_Lumpur、Asia/Shanghai 或 UTC。
  • 選好後按「套用」;按「清除」回到預設。

排程清單#

「排程清單」列出每個工作:

欄位內容
工作工作名稱,點了只看這個工作
Agent負責跑的 Agent
排程用文字說明多久跑一次;Agent 沒提供時顯示「未提供排程」
下次預計下一次執行的時間
上次上一次的結果與多久以前,點了打開那次的紀錄

停用的工作會標「已停用」,整列變淡。

最近失敗#

旁邊的「最近失敗」列出最近失敗的執行,每筆有工作名稱、時間和摘要。點一筆會打開它的紀錄,行事曆也會跳到那一週。沒有失敗時顯示「沒有失敗的執行。」

一週行事曆#

行事曆的欄是週一到週日,列是一天 24 小時。每一次執行是一個色塊,放在它開始的時間;今天那一欄會特別標出。

色塊的顏色代表結果:

結果意思
成功正常跑完
失敗這次執行失敗
略過這次沒有實際執行
執行中還沒結束
不明沒有回報結果

行事曆上方寫著「本週執行」的總次數,顏色說明旁有每種結果的次數。

同一個工作在同一個小時跑了好幾次,會合成一個色塊,顏色取其中最差的結果。一格放不下時,多出來的會收成「還有 N 項」。把滑鼠停在色塊上可以看到時間、工作名稱、結果與摘要。

這週沒有任何執行時,顯示「這週沒有執行紀錄。」

看一次執行的紀錄#

點一個色塊會從右邊打開詳情:

  • 「開始」「結束」(還在跑會寫「還沒結束」)與「耗時」。
  • 「摘要」:Agent 對這次執行的簡短說明。
  • 「執行紀錄」:Agent 回報的完整紀錄,可以按「複製」貼給其他人看。沒有紀錄時顯示「沒有回報紀錄。」
  • 「排程定義」:工作名稱、排程、時區、Agent、Gateway、工作 ID、下次執行時間與說明。

提示 某個工作連續失敗時,先看「執行紀錄」找原因。需要 Agent 補做或修正,到 Agent 看板 開一張卡交辦。

Agent 端怎麼回報排程工作與執行結果,請看 API 說明。