🐝
蜂巢OPENAPI
  • 蜂巢TNest
  • 产品介绍
    • 产品概述
    • 产品功能
    • 产品优势
    • 应用场景
  • 快速入门
    • 入门概述
    • 部署
    • 快速接入
    • 应用开发及编译
    • 应用部署
  • API
    • 接口规范
    • 终端数据查询
      • 系统基本信息上报
      • 系统运行数据上报
        • 采样频率、上报频率设置
        • CPU温度定时上报
        • CPU使用率定时上报
        • 内存使用率定时上报
        • 磁盘使用率定时上报
        • 4G模组信息定时上报
        • 有线网卡流量信息定时上报
      • 容器数据上报
      • 微应用数据上报
      • 进程数据上报
      • 服务数据上报
      • 网络端口数据上报
      • 终端在线状态
      • 链路跟踪
    • 终端告警
      • 告警规则下发
      • CPU使用率告警
      • 内存使用率告警
      • 磁盘使用率告警
      • CPU温度告警
      • 证书过期告警
      • 证书修改告警
      • 插入网线告警
      • 网线拔出告警
      • 网络链路时延告警
      • 网络链路中断告警
      • 网络链路丢包率告警
    • 运行诊断
      • 网络诊断
      • 工况诊断
      • 系统诊断
      • 进程诊断
    • 容器管理
      • 下载容器
      • 安装容器
      • 启动容器
      • 停止容器
      • 替换容器
      • 卸载容器
      • 克隆容器
    • 应用管理
      • 下载微应用
      • 安装微应用
      • 启动微应用
      • 停止微应用
      • 卸载微应用
      • 使能微应用
      • 去使能微应用
      • 微应用升级
    • 设备管理
      • 物理接口管理
        • 网口管理
      • 终端校时
      • 终端重启
      • 命令行
      • 网络访问黑名单
      • 网络访问白名单
      • 网络接口封堵
    • 连接管理
      • 网络访问黑名单
      • 网络访问白名单
    • 系统更新
      • 下载固件
      • 固件升级
      • 下载补丁包
      • 安装补丁包
      • 下载配置文件
      • 部署配置文件
    • 日志管理
      • 日志提取
      • 日志监控
        • 监控规则下发
        • 监控日志上报
        • 系统操作日志上报(审计日志)
  • 用户指南
    • 蜂巢部署
    • 安全接入
    • 可观测性
      • 系统基本信息上报
      • 运行数据监控
      • 终端告警
      • 运行诊断
    • 设备管理
      • 网络接口封堵
      • 终端校时
      • 终端重启
      • 命令行
    • 日志管理
      • 日志提取
      • 监控日志上报
      • 系统操作日志审计
    • 连接管理
      • 访问黑名单
      • 访问白名单
    • 容器管理
      • 容器下载
      • 容器安装/卸载
      • 容器启动/停止
      • 容器替换
      • 容器克隆
    • 应用管理
      • 应用下载
      • 应用安装/卸载
      • 应用使能/去使能
      • 应用启动/停止
      • 应用升级
    • 系统更新
      • 固件升级
      • 补丁包安装
      • 配置更新
  • 常见问题
    • 蜂巢部署相关问题
    • 设备注册相关问题
    • API调用相关问题
    • 应用编译相关问题
由 GitBook 提供支持
在本页
  • 功能描述
  • 1. 上报消息
  • 1.1 Topic
  • 1.2 上报消息payload
  • 请求示例
  1. API
  2. 终端数据查询

系统基本信息上报

功能描述

上报当前操作系统的基础信息,包含内容如下:

  • CPU相关信息(型号、物理个数、逻辑个数、架构、频率)

  • 操作系统相关信息(名称、版本、内核版本)

  • 基础信息(内存大小、磁盘容量)

  • 有线网卡信息(网卡名、IP地址、MAC地址)

  • 4G模组信息(生产厂家、模组型号、IMSI、SIM卡号、IP、带宽频率、网络类型)

1. 上报消息

1.1 Topic

Topic
/v1/devices/device/datas

消息发送方

网关设备

消息接收方

物联网平台

1.2 上报消息payload

参数说明

字段名
必选/可选
类型
参数描述

devices

必选

DeviceS[]

设备数据。

DeviceS结构体说明

字段名
必选/可选
类型
参数描述

deviceSn

必选

String(256)

设备ESN码,用于唯一标识设备。

services

必选

List<Services>

服务列表。

Services结构体说明

字段名
必选/可选
类型
参数描述

service

必选

String(256)

服务名。BaseInfo

mid

必选

string

消息ID,用来匹配请求消息和应答消息,以及消息去重。

data

必选

ObjectNode

服务数据。

dataTime

必选

String(256)

时间格式:采用RFC3339标准,例如:1985-04-12T23:20:50.52Z

Data结构体说明

字段名
必选/可选
类型
参数描述

CPUModel

必选

String(128)

CPU型号

CPUCount

必选

uint16

CPU个数(物理)

CPUCores

必选

uint16

CPU核数(逻辑)

CPUArch

必选

String(128)

CPU架构

CPUFrequency

必选

String(128)

CPU频率,单位MHz

memCapacity

必选

String(32)

内存容量,单位MB

diskCapacity

必选

String(32)

磁盘容量,单位MB

osReleaseName

必选

String(128)

操作系统名称

osKernelVer

必选

String(32)

操作系统内核版本

osVersion

必选

String(32)

操作系统版本

patchVersion

可选

String(32)

软件补丁版本

firmwareVersion

可选

String(32)

软件固件版本

vendor

可选

String(32)

厂商信息

4GModule

可选

ObjectNode

4G模组基本信息

wiredModules

可选

List<ObjectNode>

有线网卡基本信息

4GModule结构体说明

字段名
必选/可选
类型
参数描述

manufacture

必选

String(256)

生产厂家

model

必选

String(128)

模组型号。

imsi

必选

String(64)

IMSI号。

simId

必选

String(32)

Sim卡号

ip

必选

String(16)

4G模组的ip

bandWidth

必选

Integer

带宽,MB

netType

必选

String(16)

网络类型

WiredModules结构体说明

字段名
必选/可选
类型
参数描述

iface

必选

String(256)

有线网卡名

ip

必选

String(256)

有线网卡的ip地址(没有连接时候不分配ip,为空值)

mac

必选

String(256)

有线网卡的mac地址

请求示例

{
    "devices": [
        {
            "deviceSn": "D68NZxB4",
            "services": [
                {
                    "mid":"mymessageid",
                    "data": {
                        "4GModule": {
                            "bandWidth": null,
                            "imsi": "3987393",
                            "ip": null,
                            "manufacture": "huawei",
                            "model": "2333-111",
                            "netType": "LTE",
                            "simId": "139999999"
                        },
                        "CPUArch": "x86_64",
                        "CPUCores": 8,
                        "CPUCount": 8,
                        "CPUFrequency": "2000.023MHz",
                        "CPUModel": "x86_64",
                        "diskCapacity": "204800MB",
                        "firmwareVersion": "",
                        "memCapacity": "16008.324MB",
                        "osKernelVer": "5.4.0-147-generic",
                        "osReleaseName": "Ubuntu 20.04.5 LTS",
                        "osVersion": "20.04.5 LTS (Focal Fossa)",
                        "patchVersion": "",
                        "wiredModules": [
                            {
                                "iface": "ens224",
                                "ip": "",
                                "mac": "00:50:56:9d:c4:82"
                            },
                            {
                                "iface": "ens192",
                                "ip": "172.16.24.81",
                                "mac": "00:50:56:aa:aa:12"
                            }
                        ]
                    },
                    "dataTime": "2019-10-23T17:36:25Z",
                    "service": "BaseInfo"
                }
            ]
        }
    ]
}
上一页终端数据查询下一页系统运行数据上报

最后更新于1年前