事件推送以推送通道为配置和管理单元。每条推送通道定义需要推送的事件类型、过滤范围及绑定的 EventBridge 事件集。
本文介绍如何查看、运营和维护已创建的推送通道、查看 WeData 推送日志,以及定位 WeData、EventBridge 和下游目标之间的投递问题。新建通道及配置 EventBridge 规则的操作,请参见 新建事件推送。
前提条件
项目内已创建推送通道。
当前账号具有本次操作所需的事件推送权限。项目管理员默认具有事件推送相关权限;项目也可以在成员与角色管理中,为自定义角色配置以下权限:
推送通道:查看和管理推送通道。
推送日志:查看推送日志。
用户可执行的操作以其角色实际获得的权限为准。
进入事件推送页面
1. 登录 数据开发治理平台 WeData 控制台。
2. 单击左侧菜单中的项目列表,选择目标项目。
3. 进入目标项目后,单击右上角的项目管理。
4. 在项目管理页面的左侧导航栏选择事件推送。
页面默认展示推送通道页签;单击推送日志页签,可以查看本项目所有通道的投递日志。
管理推送通道
查看和筛选通道
推送通道列表展示以下信息:
列名 | 说明 |
通道名称 | 单击名称可进入通道详情页 |
状态 | 已开启或已关闭 |
绑定事件集 | EventBridge 事件集名称;单击名称可进入 EventBridge 控制台中的事件集页面 |
地域 | EventBridge 事件集所在地域 |
推送事件类型 | 通道已配置的事件类型;超过 3 个时折叠展示 |
过滤范围 | 全部任务、指定任务、全部工作流或指定工作流 |
今日推送量 | 当天通过该通道成功发送到 EventBridge 的事件数 |
今日失败量 | 当天发送失败的事件数;存在失败时高亮展示 |
最近推送时间 | 最近一次成功发送事件的时间 |
负责人 | 通道负责人 |
操作 | 编辑、开启或关闭、测试推送、删除 |
可以按通道名称搜索,也可以按状态、负责人或绑定事件集筛选通道。
单个项目最多可以创建 10 条推送通道。达到上限后,无法继续新建通道。
查看通道详情
在通道列表中单击通道名称,进入通道详情页。详情页包含两个页签:
基本信息:展示通道名称、描述、状态、地域、绑定事件集、推送事件类型、过滤范围、负责人、最近修改人和最近修改时间。
推送日志:仅展示当前通道向 EventBridge 发送事件的记录。
基本信息下方的推送概览展示以下指标:
指标 | 说明 |
今日推送量 | 当天通过该通道成功发送的事件数 |
今日失败量 | 当天发送失败的事件数 |
最近推送时间 | 最近一次成功发送事件的时间 |
累计推送量 | 通道创建以来发送的事件总数 |
详情页右上角提供编辑、开启/关闭、测试推送和删除操作。
编辑推送通道
1. 在通道列表或详情页单击编辑。
2. 修改通道配置。编辑页字段与新建页一致,现有配置会自动回填。
3. 单击保存。
修改绑定事件集后,请在新的事件集中确认已经配置所需的事件规则和投递目标。
开启或关闭推送通道
在通道列表或详情页单击开启/关闭,可以切换通道状态。
关闭通道后,WeData 停止通过该通道发送事件,但保留通道配置。
重新开启通道后,WeData 按通道配置发送后续触发的事件。
关闭通道不会影响 WeData 任务或工作流本身的调度和运行。
测试推送
1. 在通道列表或详情页单击测试推送。
2. 系统向通道绑定的 EventBridge 事件集发送一条
wedata:test.connectivity 测试事件。3. 查看测试结果:
测试成功时,弹窗展示 EventBridge 事件 ID。可以通过该 ID 进入 EventBridge 链路追踪页面,也可以前往绑定事件集继续配置事件规则和投递目标。
测试失败时,弹窗展示失败原因。根据提示检查授权和事件集后再次测试。
说明:
测试成功只表示 WeData 已将测试事件发送到 EventBridge,不表示 EventBridge 已将事件成功投递到下游目标。
删除推送通道
1. 在通道列表或详情页单击删除。
2. 在确认弹窗中确认删除。
注意:
删除后,该通道停止发送事件,且通道配置不可恢复。
查看推送日志
推送日志记录 WeData 向 EventBridge 发送事件的结果。可以从以下入口进入:
项目级日志:进入事件推送页面,单击推送日志页签,查看本项目所有通道的日志。
通道级日志:进入通道详情页,单击推送日志页签,仅查看当前通道的日志。
日志字段
列名 | 说明 |
推送时间 | WeData 发送事件的时间,精确到秒 |
事件类型 | 事件类型名称;指向名称时展示事件类型编码 |
关联任务/工作流 | 触发事件的任务或工作流名称;单击名称可进入对应详情页 |
实例数据时间/计划调度时间 | 实例的时间标识;项目开启时区功能时展示计划调度时间,否则展示实例数据时间 |
推送状态 | 成功或失败 |
失败原因 | 发送失败时的错误信息;发送成功时显示 - |
EventBridge 事件 ID | EventBridge 返回的事件 ID;单击 ID 可进入 EventBridge 链路追踪页面 |
筛选日志
筛选项 | 说明 |
时间范围 | 默认近 24 小时,最长可查询近 7 天 |
推送状态 | 全部、成功或失败 |
事件类型 | 全部或指定事件类型 |
通道名称 | 全部或指定通道;在通道详情页中固定为当前通道 |
关联任务/工作流 | 按任务或工作流名称搜索 |
超过 7 天的推送日志会自动清理。如需长期留存事件记录,可以在 EventBridge 侧将 CLS 日志配置为投递目标。
排查投递问题
WeData 推送日志和 EventBridge 链路追踪的范围不同:
查看位置 | 可以确认的范围 |
WeData 推送日志 | WeData 是否已将事件发送到 EventBridge |
EventBridge 链路追踪 | EventBridge 是否接收事件、事件是否匹配规则,以及事件向下游目标的投递情况 |
WeData 推送日志显示失败
1. 对该通道执行一次测试推送。
2. 如果测试失败,根据弹窗或推送日志中的失败原因,检查 WeData 调用 EventBridge 的服务授权是否有效。
3. 确认绑定的 EventBridge 自定义事件集仍然存在,并且地域与通道配置一致。
4. 完成检查后再次测试。如果仍无法定位问题,请 提交工单,并提供通道名称、推送时间和失败原因。
WeData 推送日志显示成功,但下游未收到事件
WeData 推送日志显示成功,只表示 WeData 已将事件发送到 EventBridge。继续按以下步骤排查:
1. 在 WeData 推送日志中单击 EventBridge 事件 ID,进入 EventBridge 链路追踪页面。
2. 确认 EventBridge 已接收事件。
3. 检查事件是否匹配到预期规则;如果未匹配,请检查事件模式。
4. 检查规则向投递目标的投递结果;如果 EventBridge 显示投递成功但业务未生效,请继续检查下游服务的处理逻辑。
常见问题
为什么无法新建推送通道?
请依次确认:
当前账号具有事件推送下的“推送通道”权限。
当前项目的推送通道数量未达到 10 条。
项目已完成 WeData 调用 EventBridge 所需的服务授权。
编辑通道后,下游没有收到事件怎么办?
如果修改了绑定事件集,请确认新事件集中已经配置事件规则和投递目标。如果未修改事件集,请先查看 WeData 推送日志,再根据 EventBridge 事件 ID 检查链路追踪结果。
相关文档
新建事件推送