事件流

2025年12月1日修改

1.
实时入库​

查询一段时间内产品加载的实时入库数据，可按事件类型、事件名称、用户ID（Client ID）等筛选项组合查询。最多展示1000条数据。​

common.docs_name - LarkCCM_Docs_Menu_Image

ℹ️

数据加载时间范围仅能以当日为起点，包含当日及未来6个自然日，总共7个自然日。开启加载实时数据后，引力将自动根据加载时间范围停止。​

2.
错误数据​

在实时入库接收时间范围内，引力将会按10分钟/次刷新统计结果，按错误码展示最新1000条记录。错误数据无法入库。​

查看详情可查询采样时间和错误码分类下的无法入库的事件，错误问题将会高亮显示，方便定位。​

2.1
错误码列表​

错误码	错误描述	校验规则	优化建议
1010001	事件不存在或未创建	事件未在元数据中创建	请先前往元数据-元事件页面新建。
1010002	入库事件发生时间超出有效窗口期	事件发生时间不在前 10 天至后 1 小时的范围内	埋点发生时间早于过去10天，事件上报延迟，建议排查客户端网络链接情况，或调用上报接口之后立即调用 flush 接口触发上报。
1010003	事件元数据已被禁止接收	事件元数据已被禁止接收	如需要该事件入库，请在元事件页面将事件的「是否接收」配置改为是。
1020001	事件属性数据类型不合法	与元数据中记录的属性数据类型不一致	实际上报的数据格式与元数据中记录的属性数据类型不一致，请按照登记类型调整上报，或在元数据-事件属性页面修改登记的数据类型。
1020002	事件属性值不合法	属性值不合法	请修改事件属性值上报，确保属性值符合元数据中登记的属性数据类型。
1020003	事件属性请求体不合法	事件属性请求体不合法	事件属性请求体应该是json格式，请检查请求体格式。
1030001	用户属性不存在或未创建	用户属性未在元数据中创建	请先前往元数据-用户属性页面新建。
1030002	用户属性类型不合法	与元数据中记录的属性数据类型不一致，且强转失败	实际上报的数据格式与元数据中记录的属性数据类型不一致，且强转失败；请按照登记类型调整上报，或修改登记的数据类型。
1030003	用户属性值不合法	属性值不合法	请修改用户属性值上报，确保属性值符合元数据中登记的属性数据类型。
1040001	用户未初始化	用户未初始化完成	请先初始化用户，再调用事件上报接口。
1040002	系统事件不允许上报	系统事件不允许上报	系统事件无需上报，自动采集，请移除该事件上报代码。
1050001	事件请求格式不合法	事件请求格式不合法	检查事件的请求body。
1050002	事件数据重复	事件数据重复	请检查订单ID是否重复上报。
1050003	事件类型不合法	事件type不合法	type只支持track和profile，请按照接口 api 检查传参是否正确，详情参考文档：https://help.gravity-engine.com/docs/shi-jian-shang-bao-jie-kou
1050004	profile事件不合法	用户profile类型事件不合法	请查看用户属性上报支持的具体的枚举字段，根据具体场景传入合法的枚举值，详情参考文档：https://help.gravity-engine.com/docs/sjgz

事件流​

事件流