智能家庭网关软探针与监控平台的接口协议征求意见版.docx
- 文档编号:1914038
- 上传时间:2022-10-25
- 格式:DOCX
- 页数:8
- 大小:21.64KB
智能家庭网关软探针与监控平台的接口协议征求意见版.docx
《智能家庭网关软探针与监控平台的接口协议征求意见版.docx》由会员分享,可在线阅读,更多相关《智能家庭网关软探针与监控平台的接口协议征求意见版.docx(8页珍藏版)》请在冰豆网上搜索。
智能家庭网关软探针与监控平台的接口协议征求意见版
智能家庭网关软探针与监控平台的接口协议征求意见版
2.范围本协议规定了中国移动智能家庭网关软探针与软探针监控平台之间的接口协议,主要供智能家庭网关软探针和软探针监控平台开发人员使用。
3.规范性引用文件下列文件中的条款通过本标准的引用而成为本标准的条款。
凡是标注日期的引用文件,其随后所有的修改单(不包括勘误的内容)或修订版均不适用于本标准,然而,鼓励根据本标准达成协议的各方研究是否可使用这些文件的最新版本。
凡是不注日期的引用文件,其最新版本适用于本标准。
序号标准编号标准名称发布单位[1]《智能网关软探针中间件数据定义规范》中国移动通信集团公司[2]《中国移动智能家庭网关技术规范》中国移动通信集团公司4.术语、定义和缩略语下列术语、定义和缩略语适用于本标准词语解释DPI深度报文检测技术NATNetworkAddressTranslation网络地址转换NTPNetworkTimeProtocol网络时间协议OLTOpticalLineTerminal光线路终端ONUOpticalNetworkUnit光网络单元OUIOrganizationallyUniqueIdentifiers组织唯一标识PPPoEPPPoverEther以太网上传送PPP协议QB-╳╳-╳╳╳-╳╳╳╳3QoSQualityofService服务质量RAMRandomAessMemory随机存储器SNMPSimpleNetworkManagementProtocol简单网络管理协议SNTPSimpleNetworkTimeProtocol简单网络时间协议SOAPSimpleObjectAessProtocol简单对象访问协议SSIDServiceSetIdentifier服务集标志符TCPTransmissionControlProtocol传输控制协议TSTransportStream传输流UDPUserDatagramProtocol用户数据报协议URLUniformResourceLocator统一资源定位格式USBUniversalSerialBus通用串行总线VLANVirtualLocalAreaNetwork虚拟局域网WANWideAreaNetwork广域网WLANWirelessLAN无线局域网LANLocalAreaNetwork局域网5.智能家庭网关软探针与监控平台接口定义5.1.接口功能描述智能家庭网关软探针通过OSGIAPI(建议增加到缩略语表中)采集网关信息以及分析通过网关的数据包信息,进行预处理生成上报数据。
根据按触发上报的不同的条件,软探针与软探针监控平台的接口可分为表5-1上报接口类型上报类型功能描述开机上报上报网关的基本信息,状态信息,下挂设备信息和智能家庭网关软探针的版本信息;软探针监控平台返回相应的配置参数。
周期上报上报周期内网关运行的参数;上报周期内网页浏览,下载,即时通讯,游戏等业务参数实时上报软探针监控平台下发探测指令,软探针执行指令,并上报结果,如Ping、Tracroute等告警上报触发TCP连接超时,DNS解析超时等告警,软探针将实时上传告警信息网络探测软探针监控平台可根据需要向特定网关下发网络探测任务,通过Ping或Traceroute检验网络质量5.2.接口结构描述智能家庭网关软探针与软探针监控平台的接口分布如下图QB-╳╳-╳╳╳-╳╳╳╳4图5-1智能家庭网关软探针与软探针监控平台的接口示意图5.3.接口协议说明智能家庭网关软探针通过等应用层协议实现智能家庭网关软探针与软探针监控平台之间的远程访问;本协议采用TCP,智能家庭网关软探针作为client向软探针监控平台发起TCP连接,监控平台响应后,即可关闭连接。
5.3.1.请求发起数据传输消息由智能家庭网关软探针向软探针监控平台发起访问请求,消息格式如下RequestURI默认为“/”Host软探针监控平台的域名及端口Content-Typeapplication/JSONContent-Length表明了消息体长度;User-Agent表明了客户端的信息;POST/1.1Host:
Content-Type:
Content-Length:
User-Agent:
Date:
Aept:
Referrer:
QB-╳╳-╳╳╳-╳╳╳╳5Date发起请求的日期、时间Aept终端可以接收的响应消息的媒体类型消息体中包含一个JSON文档,详细数据格式请参考具体接口。
5.3.2.请求返回数据接收消息由软探针监控平台向智能家庭网关软探针返回数据请求结果,消息格式如下Server服务器软件信息Content-Typeapplication/JSONContent-Length消息体长度消息体中包含一个JSON文档,详细数据格式请参考具体接口。
5.3.3.FTP文件上传智能家庭网关软探针接收到开机上报请求的返回结果后,软探针定期采集数据,保存到文件里面,并以FTP方式向监控平台发送数据。
软探针可根据数据量大小和实时策略选择通过FTP协议传输数据。
5.3.4.接口JSON数据协议定义该定义为应用层协议,和具体采用的编码方式无关。
为了提供服务器和机顶盒之间的交互速度,决定采用相对简单的交互方式,采用一次交互流程进行交互。
目前选择的编码方式是JSON,Bean的数据组织格式为“beanName”:
{“para1”:
”value1”,”para2”,”value2”}ListofString的数据格式为“listName”:
[“value1”,”value2”]S/1.1200OKServer:
Content-Type:
Content-Length:
Date:
Expires:
QB-╳╳-╳╳╳-╳╳╳╳6ListofBean的数据格式为“listName”:
[{“para1”:
”value1”,”para2”:
”value2”},{“para1”:
”value1”,”para2”:
”value2”}]目前,后台端采用标准的JSON解析库来解析数据;机顶盒端通过字符串匹配的方式来解析数据。
6.开机上报接口在智能家庭网关启动时,智能家庭网关软探针向软探针监控平台发送数据,完成注册过程,和监控平台建立连接;同时触发监控平台下发采集和周期上报数据的配置。
请求URL:
s:
//xxx:
port/rest/cm_softprobe/home_gateway/bootmessage6.1.开机上报请求开机上报请求的消息体中包含一个JSON文档,具体信息如下Nullable类型含义eventTypeNBean事件类型eventCodeNInt事件号subEventYInt子事件号(这里无效)timeOffsetYInt距离该条记录正确上报时间点的时间偏移量,正常上报为0,上报由于其他时间导致延迟1分钟,上报值为60,单位为秒UserInfousernameNString用户名passwordNString密码,基于S连接,可以不加密deviceInfoNBean设备信息deviceIdNString终端序列号(即HGUSN)manufacturerNString网关厂家cpuNString网关CPU型号hardwareVersionNString网关硬件版本号firmwareVersionNString网关固件版本modelNString网关型号macNString网关MAC地址wifiInfoNString支持的WIFI信息SSIDNStringSSID编号SSIDnameNStringSSID名字SSIDMACNStringSSIDMAC地址QB-╳╳-╳╳╳-╳╳╳╳7SSIDEnableNString使能状态SSIDAdvertisementNString是否广播SSIDStandardNString标准,取值为11n/11ac/11bg/11bgn/11gn/11a/11naSSIDEncryptionModeNString加密模式,取值为OPENWEP,WPAPSK,WPAPSK2,MIXED-WPAPSK2lanIPNStringLANIP地址wanIPNStringWANIP地址nfcSupportYString是否支持NFC,”Yes”,”NO”flashSizeNString设备flash大小ram_sizeNString设备ram大小dpiVersionInfoNBean参数versionNString软探针中间件版本号interfaceVersionNString接口协议版本号deviceStatusYBean网关运行状态bootTimeNString开机时间runingTimeNString运行时间CPUNStringCPU占用率RAMNString内存占用率lan1ConnectStatusNStringLAN1的连接状态,tatus:
string状态取值CONNECTINGCONNECTEDDISCONNECTEDUNCONFIGUREDlan2ConnectStatusNStringLAN2的连接状态,取值同LAN1lan3ConnectStatusNStringLAN3的连接状态,取值同LAN1lan4ConnectStatusNStringLAN4的连接状态,取值同LAN1WANNStringWAN的连接状态,取值同LAN1WIFINStringWIFI的连接状态PPPOEDialNStringPPPOE拨号状态PPPOEErrorNStringPPPOE拨号失败原因PPPOEStatusNStringPPPOE的连接状态PONTXPowerNIntPON口的发射光功率(单位0.1微瓦)PONRXPowerNIntPON口的接收光功率(单位0.1微瓦)WLANNeighborYBean获取WLAN频段邻居信息numberYInt邻居WIFI设备数量radioInfoYBean邻居WLAN频段信息radioTypeYString2.4G,5GSSIDNameYBeanWIFI信号名称MacYBean邻居WIFI设备MACsubDeviceInfoYBean网关下挂设备信息QB-╳╳-╳╳╳-╳╳╳╳8subDeviceNumberYString下挂设备数量deviceInfoYBean设备信息deviceTypeYString设备类型,手机/PC/PADdeviceNameYString设备别名manufactureYString设备厂家modelYString设备型号WLANRadioTypeYString2.4G,5GWLANRadioPowerYStringWLAN发射功率百分比调用参数实例{"eventType":
{"eventCode":
"1","subEvent":
"0"},"timeOffset":
"0","deviceInfo":
{"deviceId":
"0025E4C2D1FE5F9C","manufacturer":
"ABCD","Model":
"HS3025","MAC":
"E4C2D1FE5F9C","WANIP":
"202.8.8.8","CPU":
"HILSI0038","wifiinfo":
[{"SSID":
"1","SSIDname":
"home01","SSIDMAC":
"E4C2D1FE5F9C","SSIDEnable":
"TRUE","SSIDStandard":
"11a/11b/11g"},{"SSID":
"5","SSIDname":
"hom
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- 智能 家庭 网关 探针 监控 平台 接口 协议 征求意见