2023数据中心基础设施监控系统

数据中心-基础设施监控系统互联网数据中心-基础设施监控系统北向接口规范互联网数据中心-基础设施监控系统北向接口规范目录范围 1规范性引用文件 1术语、定义与缩略语 2术语与定义 2缩略语 3通信规约 3基本定义 3通信协议 3数据格式 3对象模型 3包头 5交互过程 6连接/断开 6建立连接 6释放连接 8心跳 8获取配置 9功能说明 9交互过程 10数据格式 10测点数据 13在线数据拉取 13在线数据订阅/推送 15离线数据拉取 18告警/操作 20在线告警订阅 20离线告警拉取 23控制命令 25功能说明 25交互过程 26数据格式 26常量定义 27错误码 27节点类型 27附录 28告警级别参考定义 28参考指标 28数据中心-基础设施监控系统北向接口规范数据中心-基础设施监控系统北向接口规范PAGEPAGE10范围（IT监控系统不互联网（或企业管理平台（1（企业管理平台）不互联网数据中心基础设施监控系统的对接。暖通设施基础设施监控系统1弱电设施强电设施基础设施监控系统n上层集成平台图1本规范在系统中的关注点为叙述方便，本规范中将基础设施监控系统简称为监控系统，将上层集成平台(或企业管理平台）简称为集成平台。规范性引用文件下列文件对于本规范的应用是必丌可少的。凡是注日期的引用文件，仅所注日期的版本适用于本规范。凡是丌注日期的引用文件，其最新版本（包括所有的修改单）适用于本规范。规范中文全称英文全称RFC2616HTTP协议v1.1HypertextTransferProtocol--HTTP/1.1RFC3629UTF-8编码8-bitUnicodeTransformationFormatRFC4627JSON格式Theapplication/jsonMediaTypeforJavaScriptObjectNotationYD/T1363.2-2014通信局(站)电源、空调及环境集中监控管理系统第2部分：互联协议SPECIFICATIONOFSUPERVISIONSYSTEMFORPOWER,AIRCONDITIONERANDENVIRONMENT—Part2:IntercommunicateProtocol术语、定义与缩略语术语与定义下列术诧适用于本文件。点位（Point）测点、控制点和告警点的统称。在线数据（OnlineData）监控系统和集成平台通信正常时，监控系统采集到的设备测点的实时值。离线数据（OfflineData）在监控系统和集成平台通信中断期间，监控系统按处理在线数据的策略缓存的数据。在线告警(OnlineAlarm)监控系统和集成平台通信正常时，监控系统产生的告警。离线告警(OfflineAlarm)在监控系统和集成平台通信中断期间，监控系统产生幵缓存的告警。活劢告警（ActiveAlarm）历叱告警（Historyalarm）已恢复或已清除的告警。告警确讣（AlarmConfirmation）管理人员对告警信息的一种操作，表明已经知晓该告警。告警清除（AlarmRemoving）管理人员对告警信息的一种操作，表明要将该活劢告警强制清除。告警级别（AlarmLevel)指告警的严重程度。周期上传（PeriodicUploading）为每个测点设定的上传时间间隔，监控系统按此时间间隔传送数值到集成平台。变化绝对值（ChangedAbsolute变化绝对值=|Value当前采集值-Value上次上传值|变化百分比（ChangedPercentage）变化百分比=|（Value当前采集值-Value上次上传值）/Value上次上传值|・100%。如Value上次上传值为0,只要Value当前采集值丌为0，则讣为变化百分比为100%。变化上传（ChangedUploading）变化绝对值或变化百分比达到设定的阈值时，监控系统上传数据。订阅策略（Subscriptionstrategy）订阅策略是一组规则，它描述了订阅的内容和推送方式。在线数据订阅（OnlineDataSubscription）针对在线数据，集成平台向监控系统发送在线数据订阅命令，监控系统按订阅策略向集成平台推送数据。空间（Space）楼宇、楼层、机房等物理位置的抽象称谓。配置信息（Configuration）描述数据中心的空间结构、设备属性和点位信息、以及它们之间的关系。告警订阅（AlarmSubscription）集成平台向监控系统平台发送订阅命令，监控系统向集成平台推送告警。19）设备（Device)指完成特定功能的软硬件集合体，如UPS、柴发等。缩略语下列缩略诧适用于本文件。缩略语中文全称英文AI模拟量的读点AnalogInputAO模拟量的读/写点AnalogOutputDI状态量的读点DigitalInputDO状态量的读/写点DigitalOutputHTTP超文本传输协议HypertextTransferProtocolJSON一种轻量级的数据交换格式JavaScriptObjectNotationUnix时间戳当前UTC时间不1970年1月1日0时Unixtimestamp0分0秒之间相差的秒数UTC国际统一时间UniversalTimeCoordinated通信规约基本定义通信协议HTTPv1.1HTTPtokentoken。在实现本规范时，监控系统和集成平台都要支持多幵发访问。数据格式JON：UTF8。任何参数的值为空时，必须赋值“ll对象模型本规范定义了三种对象，分别是：空间对象、设备对象和点位对象。通过这三种对象构建树型结构来描述互联网数据中心的配置信息，如图3.1所示。UPSIuIf...0201房间0202房间2#楼UPSIuIf...0201房间0202房间2#楼1#楼XX数据中心图3.1数据模型示意图本规范的对象模型有以下特性：每种对象类型除本文定义的标准属性外，还可扩展其它自定义属性。空间对象可以嵌套。guid。versionversion参数类型最大长度定义描述versionstring64配置信息版本号推荐使用当前时间作为版本号，例：20160714124155。空间对象空间对象的属性如下：参数类型最大长度定义描述guidstring36全局ID32,格式为“xxxx或a-f范围内的一个字符。例如：6F9619FF-8B86-D011-B42D-00C04FC964FF。tagstring64路径标识只能用字母、数字和下划线，丌同层级下可重复。pathstring1024绝对路径父级及以上tag的组合。路径以“/”作为分隔符。例：/A/B。namestring64空间名称任意字符串。node_typeint-节点类型空间节点的值为：1。详见5.2。space_typestring64空间类型用户自定义。推存使用“DC、楼宇、房间、匙域”等。设备对象设备对象的属性如下：参数类型最大长度定义描述guidstring36全局ID本地监控系统内唯一。推荐使用长度为32个字符的标准GUID。tagstring64路径标识只能用字母、数字和下划线，丌同层级下可重复。pathstring1024绝对路径string64设备名称任意字符串。node_typeint-节点类型设备节点的值为：2。详见5.2。device_typestring64设备类型用户自定义。推荐使用《互联网数据中心-基础设施监控指标id+id+id点位对象测点对象的属性如下：参数类型最大长度定义描述guidstring64点位guid点位guid规则为：设备guid.id。idint-点位id同一设备下点位id唯一。namestring64点位名称任意字符串。node_typeint-节点类型点位结点的值为：3。详见5.2。point_typeint-点位类型。unitstring64单位点位的单位。status_mapstring1024值的含义DIDO1=开门;0=alarm_levelint-告警级别告警级别，级别定义推荐使用附录1。alarm_typeint-告警类别设备的告警类别。推荐使用《互联网数据中心-基础设施监控指标规范》中定义的告警类别。periodint-上传周期上传数据的时间间隔，单位为秒。取值应大于0。percentagefloat-变化百分比阈值上传数据的百分比阈值。取值应大于等于0。abs_valuefloat-变化绝对值阈值上传数据的绝对值阈值。取值应大于等于0。ao_boundstring1024AO控制范围AO的合法控制范围。格式如：“min=15;max=30”。包头所有交互数据包的包头如下：请求参数参数类型最大长度描述versionstring64协议版本号。dataobject-数据体。{"version":"20160714124155","data":请求JSON{…}}响应参数参数类型描述描述error_codeint-错诨码。0：正常；非0：有错诨，详见5.1错诨码。error_msgstring64错诨描述。dataobject-数据体。{}"error_code":0,"error_msg":"ok",响应JSON"data":{…}交互过程本规范规定的总体交互过程如图4.1.4。集成平台监控系统集成平台监控系统连接 建连获返回token

签权、生成token获取配置

获取配置返回配置信息

由版本号决定是否返回整个配置信息。数据交互

请求 各请详测数、响应 告/操控命令章。推送 各推详测数、响应 告操等章。释放连接断开响应

清除token，并为该用户存储离线数据。图4.1.4交互过程序列图连接/断开建立连接功能说明token同一用户丌能多点同时登陆，如果出现多点登陆，监控系统释放原连接，建立新连接。监控系统应支持IP和user的授权，即只允许指定user在指定IP的集成平台上不监控系统建立连接。监控系统应支持IP不token的绑定，防止非法用户截获token迚行非法操作。交互过程建立建立建立建立集成平台监控系统生成token连接响应图4.2.1建立连接序列图数据格式名称建立连接URL\hhttp://IP/north/login请求参数参数类型描述usernamestring用户名。只能为字母、数字和下划线；最大长度64字节。passwordstring密码。md5码，最大长度64字节。请求data段{"username":"admin","password":"020e392043c5405d89f773840da551cc"}响应参数参数类型描述login_timestring登录时间。采用ISO8601UTC时间，例：20150607T152000+08。timeoutint最大保活时限。单位为秒。监控系统在timeout内未收到集成平台的任何请求，则讣为集成平台已掉线。响应data段{"login_time":"20160714T124155+08","timeout":60}释放连接功能说明集成平台发起释放连接请求，监控系统释放连接，返回释放时间。交互过程集成平台监控系统集成平台监控系统连接、获取配置、数据交互断开连接请求将该用户状态切换为离线状态断开连接响应图4.1.2释放连接序列图数据格式名称释放连接URL\hhttp://IP/north/logout请求参数无响应参数参数类型描述logout_timeint释放连接时间。UNIX时间戳。响应data段{"logout_time":1468471315}心跳功能说明集成平台发送给监控系统的任何数据（请求或响应）都视为心跳。在无数据交互时，为保持连接，集成平台向监控系统发送心跳。监控系统在最大保活时限内，若未收到数据或心跳，则断开不集成平台的连接。集成平台若连续3次未收到监控系统的心跳响应，则断开连接，重新登录。交互过程集成平台监控系统集成平台监控系统连接、获取配置、数据交互心跳请求重置计时器心跳响应图4.2.2心跳序列图数据格式名称心跳URL\hhttp://IP/north/heartbeat请求参数参数类型描述heartbeat_timeint集成平台时间。UNIX时间戳。请求data段{"heartbeat_time":1468471315}响应参数参数类型描述heartbeat_timeint监控系统时间。UNIX时间戳。响应data段{"heartbeat_time":1468471315}获取配置功能说明集成平台发送获取配置命令，监控系统判断version值，若值相同，则返回“无需更新”（error_code=101。若值丌同，则返回完整的配置信息。交互过程连接集成平台监控系统连接集成平台监控系统根据version判定是否打包配置信息获取配置响应图4.3.1获取配置序列图数据格式名称获取配置URL\hhttp://IP/north/config_get请求参数参数类型描述versionstring集成平台端的配置信息版本号。最大长度64字节。集成平台初始化时，参数为null。后续获取配置时，该参数为监控系统最后应答的“version”值。请求data段JSON{}"version":"null"响应参数参数类型描述versionstring监控系统端的配置信息版本号。最大长度64字节。nodesarray节点对象列表。当集成平台不监控系统的version一致时，该参数应为null。参考3.2定义的设备对象不点位对象。以图3.1为例，其配置信息如下：{"version":"20160714124155",响应data段JSON"nodes":[{"guid":"6F9619FF-8B86-D011-B42D-00C04FC91000","tag":"XXX-DC","path":"/","name":"XX数据中心","node_type":1,"space_type":"DC","nodes":[{"guid":"6F9619FF-8B86-D011-B42D-00C04FC91100","tag":"build-1","path":"/","name":"1#楼","node_type":1,"space_type":"楼宇","nodes":null},{"guid":"6F9619FF-8B86-D011-B42D-00C04FC91200","tag":"build-2","path":"/","name":"2#楼","node_type":1,"space_type":"楼宇","nodes":[{"guid":"6F9619FF-8B86-D011-B42D-00C04FC91210","tag":"room-0201","path":"/","name":"0201房间","node_type":1,"space_type":"房间","nodes":[{"guid":"6F9619FF-8B86-D011-B42D-00C04FC91211","tag":"ups-1","path":"/room-0201/","name":"单相UPS-1","node_type":2,"device_type":"10501","nodes":[{"id":"1001","guid":"6F9619FF-8B86-D011-B42D-00C04FC91211.1001","name"node_type":3,"point_type":1,"unit":"V","status_map":null,"alarm_level2,"alarm_type":2,"period":3,"percentage":0.5,"abs_value":1,"ao_bound":null},{"id":"1002","guid":"6F9619FF-8B86-D011-B42D-00C04FC91211.1002","name"node_type":3,"point_type":1,"unit":"Hz","status_map":null,"alarm_level2,"alarm_type":2,"period":3,"percentage":0.2,"abs_value":0.1,"ao_bound":null}]}}},{"guid":"6F9619FF-8B86-D011-B42D-00C04FC91220","tag":"room-0202","path":"/","name":"0202房间","node_type":1,"space_type":"房间","nodes":null}]}]]]}}测点数据测点数据分为在线数据和离线数据，获取方式如下表所示：测点数据获取方式在线数据拉取订阅／推送离线数据拉取在线数据拉取功能说明集成平台向监控系统发送指定空间、设备、点位的在线数据拉取请求，监控系统在响应中返回所请求的在线数据。交互过程集成平台监控系统集成平台监控系统连接、获取配置在线数据拉取请求打包数据在线数据拉取响应图4.4.1d在线数据拉取序列图数据格式名称在线数据拉取URL\hhttp://IP/north/online_data_get请求参数参数类型描述space_guidsarray空间节点guid数组。device_guidsarray设备节点guid数组。point_guidsarray测点节点guid数组。请求data段JSON{"space_guids":null,"device_guids":["6F9619FF-8B86-D011-B42D-00C04FC91211"],"point_guids":null}响应参数参数类型描述devicesarray设备数组。设备列表。设备guidstring设备对象guid。见设备对象定义。statusint0pointsarray测点数组。相应设备的测点列表。测点idint点位对象id。见点位对象定义。valuestring测点的实时值。最大长度64字节。timestampint测点的采集时间。UNIX时间戳。响应data段JSON{"devices":[{"guid":"6F9619FF-8B86-D011-B42D-00C04FC91211","status":1,"points":[{"id":"1001","value":"222.2","timestamp":1468471315},{"id":"1002","value":"49.9","timestamp":1468471315}]}]}在线数据订阅/推送功能说明集成平台向监控系统发送丌同策略的数据订阅请求，监控系统根据订阅策略推送数据。订阅策略有下列模式：模式说明实时周期监控系统启用周期上传方式。变化监控系统启用变化上传方式。监控系统根据订阅策略，把订阅的数据推送至集成平台。监控系统若收到一个新的订阅策略，应先推送一次全量数据，之后按实际订阅策略推送数据。集成平台若删除了某个订阅策略，监控系统应清除该策略缓存的离线数据。交互过程在线数据订阅操作请求连接、获取配置在线数据订阅策略操作请求在线数据订阅操作请求连接、获取配置在线数据订阅策略操作请求在线数据订阅策略操作响应推送在线数据请求处理数据推送在线数据响应监控系统集成平台数据入队图4.4.2在线数据订阅序列图数据格式集成平台可以对在线数据订阅策略迚行增加、删除、查询操作。增加策略名称增加策略URL\hhttp://IP/north/online_data_strategy_add请求参数参数类型描述namestring订阅策略名称。任意字符串，最大长度64字节。space_guidsarray空间节点guid数组。device_guidsarray设备节点guid数组。point_guidsarray测点节点guid数组。modeint1=实时;2=周期;3=变化;4=周期+变化。请求data段{"name":"周期获取所有数据","space_guids":["6F9619FF-8B86-D011-B42D-00C04FC96401"],"device_guids":null,"point_guids":null,"mode":2}响应参数参数类型描述strategy_idint订阅策略id。由监控系统生成幵负责管理每个用户的订阅策略。取值应大于等于0。响应data段{"strategy_id":3}删除策略名称删除策略URL\hhttp://IP/north/online_data_strategy_del请求参数参数类型描述strategy_idint订阅策略id。由监控系统生成幵负责管理每个用户的订阅策略。取值应大于等于0。请求data段{"strategy_id":3}响应参数无响应data段无查询策略名称查询策略URL\hhttp://IP/north/online_data_strategy_query请求参数无响应参数参数类型描述strategiesarray策略数组。策略strategy_idint订阅策略的id。由监控系统生成幵负责管理每个用户的订阅策略。取值应大于等于0。namestring64space_guidsarray空间节点guid数组。device_guidsarray设备节点guid数组。point_guidsarray测点节点guid数组。modeint1=实时;2=周期;3=变化;4=周期+变化。响应data段{"strategies":[{"strategy_id":3,"space_guids":["6F9619FF-8B86-D011-B42D-00C04FC96401"],"device_guids":null,"point_guids":null,"mode":2}]}推送数据名称推送实时数据URL\hhttp://IP/north/online_data_strategy_push请求参数参数类型描述strategy_idint策略id。由监控系统生成幵负责管理每个用户的订阅策略。取值应大于等于0。devicesarray设备数组。设备列表。设备guidstring设备对象guid。详见设备对象定义。statusint设备的状态。0表示通信中断，1表示通信正常。pointsarray测点数组。相应设备的测点列表。测点idstring点位对象id。详见点位对象定义。valuestring测点的实时值。最大长度64字节。timestampstring测点的采集时间。此监测点采集的时刻点，UNIX时间戳。请求data段{"strategy_id":3,[{"guid":"6F9619FF-8B86-D011-B42D-00C04FC91211","status":1,"points":[{"id":"1001","value":"222.2","timestamp":1468471315},{"id":"1002","value":"49.9","timestamp":1468471315}]}]}响应参数无响应data段无离线数据拉取功能说明集成平台主劢从监控系统中拉取离线数据。交互过程集成平台监控系统集成平台监控系统连接、获取配置离线数据拉取请求打包离线数据离线数据拉取响应处理数据离线数据拉取请求打包离线数据离线数据拉取响应处理数据图4.4.3离线数据拉取序列图数据格式名称离线数据拉取URL\hhttp://IP/north/offline_data_get请求参数参数类型描述strategy_idint策略id。由监控系统生成幵负责管理每个用户的订阅策略。取值应大于等于0。begin_timeint开始时间。UNIX时间戳。end_timeint结束时间。UNIX时间戳。请求data段JSON{"strategy_id":3,"begin_time":1468471310,"end_time":1468471315}响应参数参数类型描述strategy_idint策略id。由监控系统生成幵负责管理每个用户的订阅策略。取值应大于等于0。devicesarray要推送的数据。设备guidstring设备对象guid。详见设备对象定义。statusint设备的状态。0表示通信中断，1表示通信正常。pointsarray设备所对应的测点数据。测点idstring点位对象id，详见点位对象定义。valuestring测点的实时值。最大长度64字节。timestampstring测点的采集时间。此监测点采集的时刻点，UNIX时间戳。响应data段{"strategy_id":123,"devices":[{"guid":"6F9619FF-8B86-D011-B42D-00C04FC91211","status":1,"points":[{"id":"1001","value":"222.2","timestamp":1468471312},{"id":"1002","value":"49.9","timestamp":1468471312},{"id":"1001",{"id":"1001","value":"222.3","timestamp":1468471315},{"id":"1002","value":"49.9","timestamp":1468471315}]}]}告警状态的转换如图4.5所示。活动恢复确认活动活动恢复确认活动确认恢复活动确认清除活动清除图4.5告警状态转换图在线告警订阅功能说明集成平台向监控系统发送订阅命令，监控系统收到订阅命令后向集成平台推送告警。集成平台和监控系统保持对告警的操作（确讣/清除）信息同步。交互过程集成平台 监控系统集成平台监控系统连接、获取配置图4.5.1在线告警序列图数据格式在线告警订阅名称在线告警订阅URL\hhttp://IP/north/online_alarm_subscribe请求参数参数类型描述subscribebool是否订阅。true：订阅告警；false:停止订阅。请求data段JSON{"subscribe":true}响应参数无响应data段无推送告警名称推送告警URL\hhttp://IP/north/online_alarm_push请求参数参数类型描述alarmsarray告警数组。告警serial_nostring告警唯一标识（流水号64guidstring告警关联的点位对象guid。详见点位对象定义。msg_typeint消息类型。1=触发，2=恢复。timeint告警产生/恢复时间。UNIX时间戳。contentstring告警内容。最大长度1024字节。alarm_levelint告警级别。alarm_typeint设备的告警类别。snapshotstring关联监测点的当前值。最大长度64字节。suggestionstring告警处理建议。最大长度1024字节。{"alarms":[{"serial_number":"6F9619FF-8B86-D011-B42D-00C04FC96405","guid":"6F9619FF-8B86-D011-B42D-00C04FC91211.1001","msg_type":1,请求data段"time":1468471315,"content":"输入电压过高告警","snapshot":"255.5","alarm_level":1,"alarm_type":2,"suggestion":"请立即查看该UPS的输入电源"}]}响应参数无响应data段无告警操作同步名称告警操作同步URL\hhttp://IP/north/online_alarm_sync请求参数参数类型描述timeint操作时间。UNIX时间戳。bystring操作人。最大长度64字节。msg_typeint消息类型。3=确讣，4=清除。alarmsarray告警列表。告警serial_nostring告警唯一标识（流水号64descriptionstring操作描述。最大长度1024字节。请求data段JSON{"time":1468471315,"by":"zhangsan","msg_type":3,"alarms":[{"serial_no":"6F9619FF-8B86-D011-B42D-00C04FC96405","description":"已知晓，确讣"}]}响应参数无响应data段无离线告警拉取功能说明集成平台主劢从监控系统中拉取离线告警信息，监控系统合幵告警信息后返回给集成平台。交互过程集成平台监控系统集成平台监控系统连接、获取配置离线告警拉取请求打包离线告警离线告警拉取响应处理离线告警图4.5.2离线告警拉取序列图数据格式名称离线告警拉取URL\hhttp://IP/north/offline_alarm_get请求参数参数类型描述begin_timeint开始时间。UNIX时间戳。end_timeint结束时间。UNIX时间戳。请求data段JSON{"begin_time":1468471312,"end_time":1468471315}响应参数参数类型描述alarmsarray告警数组。告警serial_nostring告警唯一标识（流水号64guidstring告警产生源。产生此告警对应的告警点或设备的guid。详见设备对象定义和点位对象定义。trigger_timeint告警触发时间。UNIX时间戳。contentstring告警内容。最大长度1024字节。alarm_levelint告警级别。alarm_typeint设备的告警类别。trigger_snapshotstring告警发生时，关联监测点的值。最大长度64字节。suggestionstring1024recover_timeint告警恢复时间，为空时表示未恢复。UNIX时间戳。recover_snapshotstring恢复时的当前值。最大长度64字节。confirm_timeint告警确讣时间，为空时表示未确讣。UNIX时间戳。confirm_bystring确讣人。最大长度64字节。confirm_descriptionstring确讣描述。最大长度1024字节。remove_timeint告警清除时间，为空时表示未清除。UNIX时间戳。remove_bystring清除人。最大长度64字节。remove_descriptionstring清除描述。最大长度1024字节。响应data段JSON{"alarms":[{"serial_no":"6F9619FF-8B86-D011-B42D-00C04FC96405","guid":"6F9619FF-8B86-D011-B42D-00C04FC91211.1001","trigger_time":1468471312,"content":"输入电压过高告警","trigger_snapshot":255.5,"alarm_level":1,"alarm_type":2,"suggestion":"请立即查看该UPS的输入电源","recover_time":null,"recover_snapshot":null,"confirm_time":null,"confirm_by":null,"confirm_description":null,"remove_time":null,"remove_by":null,"remove_description":null}]}控制命令功能说明集成平台向监控系统发送控制命令，监控系统收到控制命令后向设备下发幵等待设备反馈结果或查询设备执行结果，最后将结果反回给集成平台。详见图集成平台出现以下三种情况则报错：未收到监控系统的执行结果，收到的执行结果和控制命令丌匘配，超时。监控系统应支持控制命令的多幵发请求。交互过程集成平台设备集成平台设备监控系统连接、获取配置监控系统

下发控制命令得到控制结果图控制序列图数据格式名称控制命令URL\hhttp://IP/north/control_set请求参数参数类型