# 上报统计和实时数据
为日常上报数据提供可视化的数据展示、统计功能，包括上报统计、实时数据两个模块，模块功能说明如下：
- 上报统计：查看最近 7 日项目内数据接收情况，对埋点事件进行禁用/启用管理
- 实时数据：包括实时入库和错误数据。实时入库页面可查看实时入库数据；错误数据页面每 10 分钟统计并展示错误上报数据
# 一、功能入口和适用角色
鼠标移入导航栏「数据管理」，点击「埋点管理」，即可进入埋点管理功能模块。
默认公司超管和管理员角色可进入埋点管理模块进行查看和编辑操作，可在「项目管理」→「角色管理」中为分析师角色分配该部分的使用权限。
| 权限 | 公司超管 | 管理员 | 分析师 | 普通成员 |
|---|---|---|---|---|
| 查看上报统计、实时数据和Debug模式 | ● | ● | △ | ○ |
| 查看上报统计、实时数据和Debug模式 | ● | ● | △ | ○ |
权限说明：
● 角色必有
▲ 角色默认有，可以没有
△ 角色默认没有，可以有
○ 角色必没有
# 二、上报统计
支持查看「最近 7 日」项目内数据接收情况，对埋点事件进行禁用/启用管理。
该页面由设置区域和数据详情区域组成。
# 2.1 查询设置
1、查询时间设置：查询时间指数据的入库时间。支持自定义查看最近 7 日任一时间段的数据接收情况。默认统计「今日」的数据，当结束时间为「今日」时，可点击右侧刷新按钮更新结束时间为最新时间（每 10 分钟更新一次数据统计）。
2、区间数据：区间数据展示所设置时间段内的已接收、已入库、错误入库和入库失败数。
- 已接收数据指 receiver 接收的数据；
- 已入库包括正确入库数据和错误入库数据；
- 错误入库指包含如事件属性名不合法、属性类型不合法等属性级别错误的数据。该类数据可正常入库，数据内的错误属性将置空处理；
- 入库失败指因#event_name 缺失，#event_time 超出限定范围等上报数据不合法导致无法入库的数据。
# 2.2 统计详情与事件管理
数据详情区域展示各事件（用户属性）下的已接收、已入库、错误入库和入库失败数据，并支持对事件进行禁用/启用设置或查看事件的错误详情等操作。
1、事件的禁用和启用
- 禁用事件：点击「禁用」可设置事件为禁用状态，禁用后的事件将不再接收入库。禁用状态在设置 10 分钟后生效。
- 启用事件：禁用后的事件可重新启用。服务端上报数据将在启用设置 10 分钟后生效，通过客户端上报的数据需在用户下次打开应用时开始启用生效。
2、错误详情：点击错误详情可进入该事件的错误详情页。错误详情页内容介绍见下方。
# 2.3 查看错误详情
错误详情页展示相应事件的错误详情信息。
错误信息按照「错误类型」展开，「错误条数」指含有该错误类型的数据条数。为方便问题定位，每类错误下将给出具体的「错误原因」和抽样示例，其中针对属性级的错误类型，提供具体的错误属性名称等信息。
示例说明：
- 在所选时间段事件 ta_test 存在 2 条错误入库数据，涉及两种错误类型——“事件属性名不合法”和“事件属性类型不合法”；
- 错误入库的 2 条数据中，2 条均存在“事件属性名不合法”错误、1 条存在“事件属性类型不合法”错误；
- 错误类型“事件属性类型不合法”下，存在两个属性的属性类型错误，分别为：“属性[#zone_offset]类型不合法，合法类型：[number]”、“属性[count]类型不合法，合法类型：[number]”。
在错误信息栏，鼠标移入错误类型右侧的信息提示图标，均可查看该错误类型对应的合法规则说明，以便您做进一步的调整。
此外，为方便数据查看，每条上报数据均可选择格式化查看与一键复制。
# 三、实时数据
实时数据模块提供查看实时数据上报情况，包括实时入库和错误数据两个子模块。
# 3.1 实时入库
实时入库展示最近 24 小时正确上报数据，当数据导入量较大时，仅展示最近 1000 条数据内容。每行 json 数据都可进行格式化查看、复制操作。
支持对每条数据进行格式化查看、复制操作：
# 3.2 错误数据
错误数据模块每 10 分钟统计并展示错误上报数据的错误类型、每类错误涉及的数据条数，并针对属性级的错误提供具体的错误原因/错误示例信息。错误数据的展示上限为最近 1000 条错误统计。
# 四、最佳实践
# 4.1 在上报统计中下线过时数据
在上报统计中可以禁用事件数据的接收，禁用数据后，数据将不会入库（也不会算作数据量）。由于客户端数据上报可能受到客户端版本的影响，即部分用户仍然在使用老版本，因此仅通过版本更新下线事件数据的上报，并不能完全禁止所有数据的上报，从而造成浪费。通过后台禁止数据接收，可以完全禁止数据上报，适合对一些新版本中不再采集的数据进行下线。