设备日活统计管理

核心概念：数据分析 | 设备日活统计管理 | 概览

设备日活统计管理用于统计设备的每日活跃情况。系统支持两路独立的活跃来源，在同一张明细表中通过 UOTA类型 字段区分、各自独立去重：

• UOTA1（默认）：来自主UOTA心跳上报，原有口径。当日有心跳即计入当日、当月、当年活跃。
• UOTA2（域名分发）：来自备UOTA调用域名分发接口时服务端推送的活跃消息。即使主UOTA异常，只要备UOTA仍在工作，UOTA2 维度仍可看到设备在线情况。

为什么要分两路

主UOTA可能因升级失败、被卸载、政策封禁等原因失联，此时心跳数据会断流；备UOTA独立运行、稳定性高，其调用域名分发接口的行为天然可作为设备"还活着"的兜底信号。详见域名分发管理。

---

核心概念：数据分析 | 设备日活统计管理 | 快速访问

快速访问

在设备日活统计管理模块中，您可以快速访问系统。

• 功能入口：数据分析 -> 设备日活统计管理
• 直接访问：点击跳转到设备日活统计管理

---

核心概念：数据分析 | 设备日活统计管理 | 功能说明

功能说明

设备日活统计管理的功能说明：该模块帮助管理员了解每日设备的活跃程度。

---

核心概念：数据分析 | 设备日活统计管理 | 1. 日活数据列表

1. 日活数据列表

设备日活统计的列表展示：在设备日活统计管理的列表页面中，这里展示了每日设备的活跃统计数据。数据来源于当日设备的心跳上报，若有心跳则计入当日、当月及当年的活跃设备。

操作说明：

• 支持通过 MAC、CPU、地区 进行搜索。
• 可选择 统计维度（日、月、年） 和 记录时间范围（跟随统计维度）来筛选数据。
• UOTA类型：用于区分活跃来源。
  • 1 默认（UOTA1）：主UOTA心跳产生的活跃。
  • 2 域名分发（UOTA2）：备UOTA调用域名分发接口产生的活跃。

字段说明：

• MAC：设备MAC地址。
• CPU：设备CPU ID。
• IP：设备IP地址。
• 地区：设备所属地区（根据IP解析）。
• UOTA类型：活跃来源类型（1=默认/UOTA1，2=域名分发/UOTA2）。同一设备同一周期在两种类型下分别独立去重。
• 记录时间：对应统计维度（年、月、日）的具体时间。

数据导出：

• 同步导出：点击导出后，系统立即处理并返回导出结果。

---

核心概念：数据分析 | 设备日活统计管理 | 业务逻辑与数据流

业务逻辑与数据流

1. 业务流程图

Mermaid Diagram Code:

flowchart TD
    A1[主UOTA发送心跳] --> B{设备是否已验证?}
    A2[备UOTA调用域名分发接口] --> A3[服务端发送Kafka消息<br/>TOPIC_DOMAIN_DEVICE_ACTIVITY]
    A3 --> A4[DomainDeviceActivityConsumer]
    A4 --> N{今日UOTA2是否已活跃?}
    B -->|否| C[验证设备信息]
    C -->|验证失败| D[返回错误]
    B -->|是| E{今日UOTA1是否已活跃?}
    C -->|验证成功| E
    E -->|否| F[记录UOTA1日活跃]
    E -->|是| G[跳过]
    N -->|否| F2[记录UOTA2日活跃]
    N -->|是| G
    F --> H{本月UOTA1是否已活跃?}
    F2 --> H2{本月UOTA2是否已活跃?}
    H -->|否| I[记录UOTA1月活跃]
    H -->|是| J[跳过]
    H2 -->|否| I2[记录UOTA2月活跃]
    H2 -->|是| J
    I --> K{本年UOTA1是否已活跃?}
    I2 --> K2{本年UOTA2是否已活跃?}
    K -->|否| L[记录UOTA1年活跃]
    K -->|是| M[跳过]
    K2 -->|否| L2[记录UOTA2年活跃]
    K2 -->|是| M

2. 活跃入库流程

触发条件（任一即可）：

• UOTA1：设备主UOTA发送心跳请求。
• UOTA2：设备备UOTA调用域名分发接口，服务端将 mac/cpu/time/ip 推送到 Kafka topic TOPIC_DOMAIN_DEVICE_ACTIVITY，由 DomainDeviceActivityConsumer 消费落库。

业务规则：

1. 设备验证：系统首先验证设备是否在平台注册（UOTA2 通过设备缓存查询补充 regionId/deviceId）。
2. 按UOTA类型去重：UOTA1 与 UOTA2 在同一统计周期内分别独立去重，互不影响。
3. 多维度统计：一次活跃事件同时记录日、月、年三个维度的活跃数据。
4. 地区解析：根据设备IP自动解析所属地区。

3. 统计维度说明

统计维度	说明	数据保留	清理规则
日活跃	当日有心跳的设备	90天	每日自动清理2天前的缓存
月活跃	当月有心跳的设备	365天	每月自动清理上月缓存
年活跃	当年有心跳的设备	6年	每年自动清理去年缓存

4. 数据来源说明

• 心跳机制：设备定期向平台发送心跳请求，证明设备在线
• 去重策略：同一设备在同一统计周期内只记录一次活跃
• 延迟处理：支持设备离线后重新上线时的数据补录

---

关联模块

• 查看设备详情请前往 设备管理