Cloud Composer 3 | Cloud Composer 2 | Cloud Composer 1
本页面介绍了如何获取有关您环境中的 DAG 的信息。
查看有关 DAG 的信息的方法
Cloud Composer 提供了多种方式来获取有关环境中 DAG 的详细信息:
- DAG 界面是 Cloud Composer 的 Google Cloud 控制台界面的一部分,专门用于查看和监控 DAG、DAG 运行和各项任务。
- Airflow 界面是 Airflow 的内置网页界面。
- Airflow CLI 是 Airflow 的命令行界面。您可以通过运行带有
gcloud
的 Airflow CLI 命令来获取有关 DAG 的信息。
Cloud Composer DAG 界面简介
DAG 界面是 Cloud Composer 的 Google Cloud 控制台界面的一部分,专门用于查看和监控 DAG、DAG 运行和各项任务。
在 DAG 界面中,您可以:
查看环境中的 DAG 列表,包括调度间隔、DAG 状态和说明。
暂停、取消暂停和触发 DAG。
查看 DAG 运行详情,包括成功、活跃和失败的运行,以及自上次完成运行以来的时间。对于每个 DAG,您都可以查看与该特定 DAG 关联的 DAG 运行和任务实例的历史记录,包括已执行任务的日志。
过滤 DAG 运行作业详情。例如,您可以选择时间间隔,并创建查询来选择所需的信息。
查看有关各个 DAG 和任务的详细信息。这包括可视化的 DAG 图、DAG 中任务的相关信息、DAG 源代码以及有关 DAG 的额外信息。
准备工作
确保您的账号具有可访问 DAG 界面并查看 DAG 详细信息的角色。如需了解详情,请参阅访问权限控制。
DAG 界面需要启用 DAG 序列化。
Cloud Composer 1.17.8 及更高版本支持 DAG 界面。
查看您环境的 DAG 列表
控制台
您环境的 DAG 标签页会显示 DAG 列表,以及每个 DAG 的 DAG 运行详情。
如需查看 DAG 列表,请执行以下操作:
在 Google Cloud 控制台中,前往环境页面。
在 DAG 列表列中,点击与您的环境对应的 DAG 链接。
您可以使用过滤条件仅查看特定 DAG 或特定条件的详细信息。例如:
- 选择过滤条件字段。
- 从下拉列表中选择 DAG ID 属性。
- 指定 DAG 的标识符。结果仅显示所选 DAG 的详细信息。
- (可选)如需添加更多 DAG,请添加
OR
运算符,后跟 DAG ID。 - (可选)如需按其他条件过滤,请在过滤条件字段中添加其他属性。例如,您可以指定
Failed runs:>0
来过滤出运行失败的 DAG。
Airflow 界面
如需在 Airflow 网页界面中查看 DAG 列表,请执行以下操作:
在 Google Cloud 控制台中,前往环境页面。
在 Airflow Web 服务器列中,点击与您的环境对应的 Airflow 链接。
使用具有相应权限的 Google 账号登录。
在 Airflow 网页界面中的 DAG 页面上,系统会显示您环境的 DAG 列表。
gcloud
在 Airflow 1.10.* 中,运行 list_dags
Airflow CLI 命令:
gcloud composer environments run ENVIRONMENT_NAME \
--location LOCATION \
list_dags
在 Airflow 2 中,运行 dags list
Airflow CLI 命令:
gcloud composer environments run ENVIRONMENT_NAME \
--location LOCATION \
dags list -- -o plain
替换:
ENVIRONMENT_NAME
替换为环境的名称。LOCATION
替换为环境所在的区域。
查看 DAG 运行作业和任务的历史记录
控制台
DAG 详情页面上的运行标签页显示了单个 DAG 的 DAG 运行历史记录。
如需查看 DAG 运行的历史记录,请执行以下操作:
在 Google Cloud 控制台中,前往环境页面。
在 DAG 列表列中,点击与您的环境对应的 DAG 链接。
选择 DAG。
在 DAG 详情页面上,前往运行标签页。
从列表中选择一个 DAG 运行,即可查看该 DAG 运行的详细信息,例如该 DAG 运行的任务实例的状态、尝试次数和执行时长。您可以选择单个任务来查看任务实例日志。
Airflow 界面
如需在 Airflow 网页界面中查看 DAG 列表,请执行以下操作:
在 Google Cloud 控制台中,前往环境页面。
在 Airflow Web 服务器列中,点击与您的环境对应的 Airflow 链接。
使用具有相应权限的 Google 账号登录。
在 Airflow 网页界面中,依次选择菜单中的浏览 > DAG 运行。DAG 运行页面会显示您环境的 DAG 运行。您可以点击运行 ID 列中的链接,获取有关任务的更多信息。
gcloud
在 Airflow 1.10.* 中,运行 list_dag_runs
Airflow CLI 命令:
gcloud composer environments run ENVIRONMENT_NAME \
--location LOCATION \
list_dag_runs -- DAG_ID
在 Airflow 2 中,运行 dags list-runs
Airflow CLI 命令:
gcloud composer environments run ENVIRONMENT_NAME \
--location LOCATION \
dags list-runs -- -d DAG_ID
替换:
ENVIRONMENT_NAME
替换为环境的名称。LOCATION
替换为环境所在的区域。DAG_ID
替换为 DAG 名称。
您可以运行 tasks state
和 tasks states-for-dag-run
Airflow CLI 命令来获取有关任务实例的其他信息。
如需了解详情,请参阅访问 Airflow CLI 以及 Airflow CLI 参考文档(针对 Airflow 1 和 Airflow 2)。
查看 DAG 图表
控制台
DAG 详情页面上的图表标签页会显示包含任务依赖项的 DAG 的可视化图表。
如需查看 DAG 的图表,请执行以下操作:
在 Google Cloud 控制台中,前往环境页面。
在 DAG 列表列中,点击与您的环境对应的 DAG 链接。
选择 DAG。
在 DAG 详情页面上,前往图表标签页。
(可选)如需查看有关任务的其他信息,请在图表中选择单个任务。
Airflow 界面
如需在 Airflow 网页界面中查看 DAG 的图表,请执行以下操作:
在 Google Cloud 控制台中,前往环境页面。
在 Airflow Web 服务器列中,点击与您的环境对应的 Airflow 链接。
使用具有相应权限的 Google 账号登录。
在 Airflow 网页界面中的 DAG 页面上,系统会显示您环境的 DAG 列表。
在 Links 列中,点击相应 DAG 的 Graph View 链接。
查看 DAG 源代码和有关 DAG 的其他信息
控制台
您可以查看 DAG 的源代码以及其他信息,例如 DAG 标识符和指向环境存储桶中 DAG 定义文件的链接。
在 Google Cloud 控制台中,前往环境页面。
在 DAG 列表列中,点击与您的环境对应的 DAG 链接。
选择 DAG。
如需查看 DAG 源代码,请前往图表标签页。
如需查看有关 DAG 的其他信息,请前往来源标签页。
Airflow 界面
如需在 Airflow 网页界面中查看 DAG 的图表,请执行以下操作:
在 Google Cloud 控制台中,前往环境页面。
在 Airflow Web 服务器列中,点击与您的环境对应的 Airflow 链接。
使用具有相应权限的 Google 账号登录。
在 Airflow 网页界面中的 DAG 页面上,点击您的 DAG 的名称。
在显示 DAG 详细信息的页面中,前往可用标签页查看有关该 DAG 的其他信息。