帮你快速理解、总结文档立即下载

管理事件推送

最近更新时间:2026-07-17 16:44:43

我的收藏
事件推送以推送通道为配置和管理单元。每条推送通道定义需要推送的事件类型、过滤范围及绑定的 EventBridge 事件集。
本文介绍如何查看、运营和维护已创建的推送通道、查看 WeData 推送日志,以及定位 WeData、EventBridge 和下游目标之间的投递问题。新建通道及配置 EventBridge 规则的操作,请参见 新建事件推送

前提条件

项目内已创建推送通道。
当前账号具有本次操作所需的事件推送权限。项目管理员默认具有事件推送相关权限;项目也可以在成员与角色管理中,为自定义角色配置以下权限:
推送通道:查看和管理推送通道。
推送日志:查看推送日志。
用户可执行的操作以其角色实际获得的权限为准。

进入事件推送页面

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 已将事件成功投递到下游目标。
测试事件的内容说明,请参见 事件推送概述 > 测试事件的 data 字段

删除推送通道

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. 完成检查后再次测试。如果仍无法定位问题,请 提交工单,并提供通道名称、推送时间和失败原因。
EventBridge 首次开通授权和 WeData 服务授权是两个不同的授权环节,具体说明请参见 新建事件推送

WeData 推送日志显示成功,但下游未收到事件

WeData 推送日志显示成功,只表示 WeData 已将事件发送到 EventBridge。继续按以下步骤排查:
1. 在 WeData 推送日志中单击 EventBridge 事件 ID,进入 EventBridge 链路追踪页面。
2. 确认 EventBridge 已接收事件。
3. 检查事件是否匹配到预期规则;如果未匹配,请检查事件模式。
4. 检查规则向投递目标的投递结果;如果 EventBridge 显示投递成功但业务未生效,请继续检查下游服务的处理逻辑。
EventBridge 链路追踪的具体操作,请参见 链路追踪

常见问题

为什么无法新建推送通道?

请依次确认:
当前账号具有事件推送下的“推送通道”权限。
当前项目的推送通道数量未达到 10 条。
项目已完成 WeData 调用 EventBridge 所需的服务授权。

编辑通道后,下游没有收到事件怎么办?

如果修改了绑定事件集,请确认新事件集中已经配置事件规则和投递目标。如果未修改事件集,请先查看 WeData 推送日志,再根据 EventBridge 事件 ID 检查链路追踪结果。

相关文档