管理員設定 – 工作流程執行作業

「管理」選單的「快訊和排程」部分中的「工作流程執行」頁面，會顯示工作流程活動的近期記錄。如要查看「工作流程執行作業」頁面，您必須獲派含有 see_schedules 和 chat_with_agent 權限的角色。

您可以在「管理設定 - 工作流程」頁面中查看工作流程。工作流程會指定何時應將內容傳送至特定地址。

每次傳送內容時，系統都會建立新的工作流程。舉例來說，如果工作流程指定每週一將特定內容傳送至特定地址，Looker 就會在每週一建立新的工作流程，將該內容傳送至指定地址。

依執行狀態篩選工作流程

在「Workflow Executions」(工作流程執行) 頁面頂端，您可以依工作狀態篩選工作流程：

  • 全部：所有近期工作流程
  • 執行中：僅限正在執行的工作流程
  • 成功：僅限順利完成的工作流程
  • 失敗：僅限無法順利完成的工作流程

包含的資訊

每個工作流程執行作業或工作都會包含下列資訊：

欄 定義
時間 工作流程執行作業開始時間
狀態 工作流程執行作業是否完成 (綠色勾號)，或是否傳回錯誤 (紅色警示圖示)
階段 執行中工作流程的目前階段
使用者 建立工作流程的使用者
來源 內容類型，顯示為 Workflow
名稱 工作流程名稱，也是工作流程內容的連結
類型 運送目的地，例如 Email 或 Slack
訊息 執行失敗時的錯誤訊息。如要順利執行，success
執行階段 工作流程執行作業的執行時間

排解工作流程執行錯誤訊息

您可以根據「訊息」欄中顯示的錯誤訊息，診斷及解決工作流程執行失敗的問題。常見的錯誤訊息包括：

收件者和許可清單錯誤

  • Unauthorized emails in plan: ["<email_address>"]：
    • 原因：一或多個收件者的電子郵件地址屬於 Looker 執行個體電子郵件網域許可清單中未列出的網域。
    • 解決方法：將收件者的網域新增至管理員電子郵件許可清單，或編輯工作流程，移除未經授權的電子郵件地址。

代理和實體錯誤

  • Agent execution failed: unexpected message received：
    • 原因：Gemini 資料代理程式在解讀指令或生成自然語言洞察摘要時，發生執行階段錯誤或收到非預期的回應。
    • 解決方法：檢查並修正工作流程設定中的自然語言指令，確保指令清楚明確。
  • entity WorkflowAgent missing：
    • 原因：與工作流程相關聯的主要資料代理程式、資訊主頁或 Explore 已遭刪除、重新命名或修改。
    • 解決方法：使用有效的資料代理或可存取的「探索」，重新建立或更新工作流程。

使用者授權和帳戶錯誤

  • 使用者授權或模型存取失敗：
    • 原因：建立工作流程的使用者無法存取探索或資訊主頁的基礎模型。
    • 解決方法：請確認工作流程擁有者在「管理」>「使用者 / 角色」中具備必要權限，或以具備授權的有效使用者身分重新建立工作流程。
  • 已停用的使用者帳戶：
    • 原因：工作流程擁有者的 Looker 使用者帳戶已停用或停權。
    • 解決方法：重新啟用使用者帳戶，或在有效使用者下重新建立工作流程。

排程器佇列和逾時錯誤

  • Job is no longer processing @<state> (其中 <state> 為 execute 或 deliver) 或 Job was expected to dequeue by @<time>：
    • 原因：工作流程在排程器佇列中停留一小時以上，但未完成，通常是因為資料庫連線暫時逾時或系統資源限制。
    • 解決方法：工作流程會在下一個排定間隔嘗試再次執行。您也可以使用 Looker API (run_scheduled_plan_once)，以程式輔助的方式重試失敗的執行作業。