管理设置 - 工作流执行作业

管理菜单的提醒和时间表部分中的工作流执行页面会显示最近的工作流活动历史记录。如需查看工作流执行页面,您必须分配有包含 see_schedules 和 chat_with_agent 权限的角色。

您可以在管理设置 - 工作流页面上查看工作流。工作流会指定何时将内容发送到特定地址。

每次发送内容时,系统都会创建一个新的工作流。例如,如果某个工作流指定每周一向特定地址发送特定内容,那么 Looker 将在每周一创建一个新工作流,以向指定地址发送相应内容。

按执行状态过滤工作流

在工作流执行页面顶部,您可以按作业状态过滤工作流:

  • 全部:所有近期工作流
  • 正在运行:仅限正在运行的工作流
  • 成功:仅限已成功完成的工作流
  • 失败:仅限未能成功完成的工作流

包含的信息

对于每个工作流程执行或作业,系统都会提供以下信息:

列 定义
时间 工作流执行开始时间
状态 工作流执行是否已完成(绿色对勾标记)或返回错误(红色提醒图标)
阶段 正在运行的工作流执行的当前阶段
用户 创建工作流的用户
来源 内容类型,显示为 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) 以编程方式重试失败的运行。