功能概述
在飞书低代码平台中,「观测」定义了 9 种事件类型,分别记录用户在和应用发生交互时,在应用内部触发的 9 种事件。如下:
250px|700px|reset
应用开发者可以借此排查、复现问题发生的现场,解决常见场景的自运维问题:
- 已发布线上的应用,出现故障时
- 在开发阶段预览测试的应用,出现故障时
事件列表
检索事件
开发者可根据故障信息,在事件列表中对目标事件进行检索,通过设置检索时间、过滤条件、关键字方式进行检索。
250px|700px|reset
查看详情
检索到触发事件后,可点击事件查看事件详情,事件详情包含了该事件当时的完整现场记录,用以支持开发者进行现场复盘。
250px|700px|reset
事件列表详情
每个事件,均提供了不同的事件详情内容。这些内容,记录了当时的现场情况。
- 每个事件的详情内容如下:
事件链路
定义
在部分情况下,用户和应用发生一次同步交互时,会有多个事件在时间维度上被依次或同时触发,这些事件组成了一条链路,这条链路上的每个节点是一个事件。这条链路承载了当时发生应用内部在时间维度上的完整现场。
250px|700px|reset
关于「事件链路」的定义:
一次应用交互引发的一系列同步事件。
例如:用户操作、OpenAPI 调用、流程各种触发方式等……这些所有可导致应用响应的触发动作
同步区别于异步。「同步事件」是指,从一次应用交互触发的所有的事件,在没有新的应用交互出现,应用不再因本次交互产生新的事件,且之前发生的事件都处于稳态。
举个例子:
- 假设应用 X 流程 A 中涉及到审批场景
- 当用户点击了控件 C 上的按钮,触发了函数 F,函数 F 调用了流程 A,流程 A 停止在节点 N 等待审批者审批
- 此时如果管理员不在应用上进行审批动作,那么此时
- 应用 X 不再因用户的点击操作产生新的事件
- 目前所有的已经被触发的事件都处于稳态
- 用户操作事件:点击控件 C
- 函数执行事件:触发了函数 F
- 流程执行事件:函数F调用了流程 A,流程 A 停止在节点 N 等待审批者审批
- 那么,以上三个事件组成了一条事件链路
查看事件所在链路
开发者可先检索事件,通过事件详情页中的事件链路链接,查看该事件所在链路:
查看链路上下游事件的现场
当打开事件链路详情后,可通过查看上下游的事件详情,向前或向后追溯故障根因。
250px|700px|reset
查看流程关联的事件链路
- Step1 点击流程执行事件详情页上的流程拓扑
- Step2 通过流程拓扑页面获取目前业务在流程实例中的流转进展和异常环节
- Step3 再按需查看流程触发的后续事件详情(如函数执行事件)
常见问题FAQ
Q1:为什么函数事件看不到函数日志?如何解决?
原因:
云函数需要更新到较新版的server-common的sdk(版本号在2.0.1及之后),才能支持上报函数日志到观测系统
解决办法:
- 方法一:更新云函数的server-common版本,并进行部署+发布,即在新版观测平台可看到升级SDK版本后的函数日志
250px|700px|reset
- 方法二:返回旧版查看函数日志
250px|700px|reset
长期解决方案:
后续(时间待定),apaas平台会全量升级线上的server-common sdk版本,开发者无感,届时即可在新版观测平台上查询函数日志(日志范围:SDK升级后产生的函数日志)
Q2: 新版观测平台的事件存储时长是多久?
7天
Q3:新旧版观测系统可以来回切换么?
可以,新版观测系统不影响旧版观测系统功能。如图所示:
250px|700px|reset
