2023數(shù)據(jù)中心基礎(chǔ)設(shè)施監(jiān)控系統(tǒng)

數(shù)據(jù)中心-基礎(chǔ)設(shè)施監(jiān)控系統(tǒng)互聯(lián)網(wǎng)數(shù)據(jù)中心-基礎(chǔ)設(shè)施監(jiān)控系統(tǒng)北向接口規(guī)范互聯(lián)網(wǎng)數(shù)據(jù)中心-基礎(chǔ)設(shè)施監(jiān)控系統(tǒng)北向接口規(guī)范目錄范圍 1規(guī)范性引用文件 1術(shù)語、定義與縮略語 2術(shù)語與定義 2縮略語 3通信規(guī)約 3基本定義 3通信協(xié)議 3數(shù)據(jù)格式 3對(duì)象模型 3包頭 5交互過程 6連接/斷開 6建立連接 6釋放連接 8心跳 8獲取配置 9功能說明 9交互過程 10數(shù)據(jù)格式 10測(cè)點(diǎn)數(shù)據(jù) 13在線數(shù)據(jù)拉取 13在線數(shù)據(jù)訂閱/推送 15離線數(shù)據(jù)拉取 18告警/操作 20在線告警訂閱 20離線告警拉取 23控制命令 25功能說明 25交互過程 26數(shù)據(jù)格式 26常量定義 27錯(cuò)誤碼 27節(jié)點(diǎn)類型 27附錄 28告警級(jí)別參考定義 28參考指標(biāo) 28數(shù)據(jù)中心-基礎(chǔ)設(shè)施監(jiān)控系統(tǒng)北向接口規(guī)范數(shù)據(jù)中心-基礎(chǔ)設(shè)施監(jiān)控系統(tǒng)北向接口規(guī)范PAGEPAGE10范圍（IT監(jiān)控系統(tǒng)不互聯(lián)網(wǎng)（或企業(yè)管理平臺(tái)（1（企業(yè)管理平臺(tái)）不互聯(lián)網(wǎng)數(shù)據(jù)中心基礎(chǔ)設(shè)施監(jiān)控系統(tǒng)的對(duì)接。暖通設(shè)施基礎(chǔ)設(shè)施監(jiān)控系統(tǒng)1弱電設(shè)施強(qiáng)電設(shè)施基礎(chǔ)設(shè)施監(jiān)控系統(tǒng)n上層集成平臺(tái)圖1本規(guī)范在系統(tǒng)中的關(guān)注點(diǎn)為敘述方便，本規(guī)范中將基礎(chǔ)設(shè)施監(jiān)控系統(tǒng)簡(jiǎn)稱為監(jiān)控系統(tǒng)，將上層集成平臺(tái)(或企業(yè)管理平臺(tái)）簡(jiǎn)稱為集成平臺(tái)。規(guī)范性引用文件下列文件對(duì)于本規(guī)范的應(yīng)用是必丌可少的。凡是注日期的引用文件，僅所注日期的版本適用于本規(guī)范。凡是丌注日期的引用文件，其最新版本（包括所有的修改單）適用于本規(guī)范。規(guī)范中文全稱英文全稱RFC2616HTTP協(xié)議v1.1HypertextTransferProtocol--HTTP/1.1RFC3629UTF-8編碼8-bitUnicodeTransformationFormatRFC4627JSON格式Theapplication/jsonMediaTypeforJavaScriptObjectNotationYD/T1363.2-2014通信局(站)電源、空調(diào)及環(huán)境集中監(jiān)控管理系統(tǒng)第2部分：互聯(lián)協(xié)議SPECIFICATIONOFSUPERVISIONSYSTEMFORPOWER,AIRCONDITIONERANDENVIRONMENT—Part2:IntercommunicateProtocol術(shù)語、定義與縮略語術(shù)語與定義下列術(shù)詫適用于本文件。點(diǎn)位（Point）測(cè)點(diǎn)、控制點(diǎn)和告警點(diǎn)的統(tǒng)稱。在線數(shù)據(jù)（OnlineData）監(jiān)控系統(tǒng)和集成平臺(tái)通信正常時(shí)，監(jiān)控系統(tǒng)采集到的設(shè)備測(cè)點(diǎn)的實(shí)時(shí)值。離線數(shù)據(jù)（OfflineData）在監(jiān)控系統(tǒng)和集成平臺(tái)通信中斷期間，監(jiān)控系統(tǒng)按處理在線數(shù)據(jù)的策略緩存的數(shù)據(jù)。在線告警(OnlineAlarm)監(jiān)控系統(tǒng)和集成平臺(tái)通信正常時(shí)，監(jiān)控系統(tǒng)產(chǎn)生的告警。離線告警(OfflineAlarm)在監(jiān)控系統(tǒng)和集成平臺(tái)通信中斷期間，監(jiān)控系統(tǒng)產(chǎn)生幵緩存的告警。活勱告警（ActiveAlarm）歷叱告警（Historyalarm）已恢復(fù)或已清除的告警。告警確訃（AlarmConfirmation）管理人員對(duì)告警信息的一種操作，表明已經(jīng)知曉該告警。告警清除（AlarmRemoving）管理人員對(duì)告警信息的一種操作，表明要將該活勱告警強(qiáng)制清除。告警級(jí)別（AlarmLevel)指告警的嚴(yán)重程度。周期上傳（PeriodicUploading）為每個(gè)測(cè)點(diǎn)設(shè)定的上傳時(shí)間間隔，監(jiān)控系統(tǒng)按此時(shí)間間隔傳送數(shù)值到集成平臺(tái)。變化絕對(duì)值（ChangedAbsolute變化絕對(duì)值=|Value當(dāng)前采集值-Value上次上傳值|變化百分比（ChangedPercentage）變化百分比=|（Value當(dāng)前采集值-Value上次上傳值）/Value上次上傳值|?100%。如Value上次上傳值為0,只要Value當(dāng)前采集值丌為0，則訃為變化百分比為100%。變化上傳（ChangedUploading）變化絕對(duì)值或變化百分比達(dá)到設(shè)定的閾值時(shí)，監(jiān)控系統(tǒng)上傳數(shù)據(jù)。訂閱策略（Subscriptionstrategy）訂閱策略是一組規(guī)則，它描述了訂閱的內(nèi)容和推送方式。在線數(shù)據(jù)訂閱（OnlineDataSubscription）針對(duì)在線數(shù)據(jù)，集成平臺(tái)向監(jiān)控系統(tǒng)發(fā)送在線數(shù)據(jù)訂閱命令，監(jiān)控系統(tǒng)按訂閱策略向集成平臺(tái)推送數(shù)據(jù)。空間（Space）樓宇、樓層、機(jī)房等物理位置的抽象稱謂。配置信息（Configuration）描述數(shù)據(jù)中心的空間結(jié)構(gòu)、設(shè)備屬性和點(diǎn)位信息、以及它們之間的關(guān)系。告警訂閱（AlarmSubscription）集成平臺(tái)向監(jiān)控系統(tǒng)平臺(tái)發(fā)送訂閱命令，監(jiān)控系統(tǒng)向集成平臺(tái)推送告警。19）設(shè)備（Device)指完成特定功能的軟硬件集合體，如UPS、柴發(fā)等?？s略語下列縮略詫適用于本文件?？s略語中文全稱英文AI模擬量的讀點(diǎn)AnalogInputAO模擬量的讀/寫點(diǎn)AnalogOutputDI狀態(tài)量的讀點(diǎn)DigitalInputDO狀態(tài)量的讀/寫點(diǎn)DigitalOutputHTTP超文本傳輸協(xié)議HypertextTransferProtocolJSON一種輕量級(jí)的數(shù)據(jù)交換格式JavaScriptObjectNotationUnix時(shí)間戳當(dāng)前UTC時(shí)間不1970年1月1日0時(shí)Unixtimestamp0分0秒之間相差的秒數(shù)UTC國(guó)際統(tǒng)一時(shí)間UniversalTimeCoordinated通信規(guī)約基本定義通信協(xié)議HTTPv1.1HTTPtokentoken。在實(shí)現(xiàn)本規(guī)范時(shí)，監(jiān)控系統(tǒng)和集成平臺(tái)都要支持多幵發(fā)訪問。數(shù)據(jù)格式JON：UTF8。任何參數(shù)的值為空時(shí)，必須賦值“l(fā)l對(duì)象模型本規(guī)范定義了三種對(duì)象，分別是：空間對(duì)象、設(shè)備對(duì)象和點(diǎn)位對(duì)象。通過這三種對(duì)象構(gòu)建樹型結(jié)構(gòu)來描述互聯(lián)網(wǎng)數(shù)據(jù)中心的配置信息，如圖3.1所示。UPSIuIf...0201房間0202房間2#樓UPSIuIf...0201房間0202房間2#樓1#樓XX數(shù)據(jù)中心圖3.1數(shù)據(jù)模型示意圖本規(guī)范的對(duì)象模型有以下特性：每種對(duì)象類型除本文定義的標(biāo)準(zhǔn)屬性外，還可擴(kuò)展其它自定義屬性?？臻g對(duì)象可以嵌套。guid。versionversion參數(shù)類型最大長(zhǎng)度定義描述versionstring64配置信息版本號(hào)推薦使用當(dāng)前時(shí)間作為版本號(hào)，例：20160714124155?？臻g對(duì)象空間對(duì)象的屬性如下：參數(shù)類型最大長(zhǎng)度定義描述guidstring36全局ID32,格式為“xxxx或a-f范圍內(nèi)的一個(gè)字符。例如：6F9619FF-8B86-D011-B42D-00C04FC964FF。tagstring64路徑標(biāo)識(shí)只能用字母、數(shù)字和下劃線，丌同層級(jí)下可重復(fù)。pathstring1024絕對(duì)路徑父級(jí)及以上tag的組合。路徑以“/”作為分隔符。例：/A/B。namestring64空間名稱任意字符串。node_typeint-節(jié)點(diǎn)類型空間節(jié)點(diǎn)的值為：1。詳見5.2。space_typestring64空間類型用戶自定義。推存使用“DC、樓宇、房間、匙域”等。設(shè)備對(duì)象設(shè)備對(duì)象的屬性如下：參數(shù)類型最大長(zhǎng)度定義描述guidstring36全局ID本地監(jiān)控系統(tǒng)內(nèi)唯一。推薦使用長(zhǎng)度為32個(gè)字符的標(biāo)準(zhǔn)GUID。tagstring64路徑標(biāo)識(shí)只能用字母、數(shù)字和下劃線，丌同層級(jí)下可重復(fù)。pathstring1024絕對(duì)路徑string64設(shè)備名稱任意字符串。node_typeint-節(jié)點(diǎn)類型設(shè)備節(jié)點(diǎn)的值為：2。詳見5.2。device_typestring64設(shè)備類型用戶自定義。推薦使用《互聯(lián)網(wǎng)數(shù)據(jù)中心-基礎(chǔ)設(shè)施監(jiān)控指標(biāo)id+id+id點(diǎn)位對(duì)象測(cè)點(diǎn)對(duì)象的屬性如下：參數(shù)類型最大長(zhǎng)度定義描述guidstring64點(diǎn)位guid點(diǎn)位guid規(guī)則為：設(shè)備guid.id。idint-點(diǎn)位id同一設(shè)備下點(diǎn)位id唯一。namestring64點(diǎn)位名稱任意字符串。node_typeint-節(jié)點(diǎn)類型點(diǎn)位結(jié)點(diǎn)的值為：3。詳見5.2。point_typeint-點(diǎn)位類型。unitstring64單位點(diǎn)位的單位。status_mapstring1024值的含義DIDO1=開門;0=alarm_levelint-告警級(jí)別告警級(jí)別，級(jí)別定義推薦使用附錄1。alarm_typeint-告警類別設(shè)備的告警類別。推薦使用《互聯(lián)網(wǎng)數(shù)據(jù)中心-基礎(chǔ)設(shè)施監(jiān)控指標(biāo)規(guī)范》中定義的告警類別。periodint-上傳周期上傳數(shù)據(jù)的時(shí)間間隔，單位為秒。取值應(yīng)大于0。percentagefloat-變化百分比閾值上傳數(shù)據(jù)的百分比閾值。取值應(yīng)大于等于0。abs_valuefloat-變化絕對(duì)值閾值上傳數(shù)據(jù)的絕對(duì)值閾值。取值應(yīng)大于等于0。ao_boundstring1024AO控制范圍AO的合法控制范圍。格式如：“min=15;max=30”。包頭所有交互數(shù)據(jù)包的包頭如下：請(qǐng)求參數(shù)參數(shù)類型最大長(zhǎng)度描述versionstring64協(xié)議版本號(hào)。dataobject-數(shù)據(jù)體。{"version":"20160714124155","data":請(qǐng)求JSON{…}}響應(yīng)參數(shù)參數(shù)類型描述描述error_codeint-錯(cuò)諢碼。0：正常；非0：有錯(cuò)諢，詳見5.1錯(cuò)諢碼。error_msgstring64錯(cuò)諢描述。dataobject-數(shù)據(jù)體。{}"error_code":0,"error_msg":"ok",響應(yīng)JSON"data":{…}交互過程本規(guī)范規(guī)定的總體交互過程如圖4.1.4。集成平臺(tái)監(jiān)控系統(tǒng)集成平臺(tái)監(jiān)控系統(tǒng)連接 建連獲返回token

簽權(quán)、生成token獲取配置

獲取配置返回配置信息

由版本號(hào)決定是否返回整個(gè)配置信息。數(shù)據(jù)交互

請(qǐng)求 各請(qǐng)?jiān)敎y(cè)數(shù)、響應(yīng) 告/操控命令章。推送 各推詳測(cè)數(shù)、響應(yīng) 告操等章。釋放連接斷開響應(yīng)

清除token，并為該用戶存儲(chǔ)離線數(shù)據(jù)。圖4.1.4交互過程序列圖連接/斷開建立連接功能說明token同一用戶丌能多點(diǎn)同時(shí)登陸，如果出現(xiàn)多點(diǎn)登陸，監(jiān)控系統(tǒng)釋放原連接，建立新連接。監(jiān)控系統(tǒng)應(yīng)支持IP和user的授權(quán)，即只允許指定user在指定IP的集成平臺(tái)上不監(jiān)控系統(tǒng)建立連接。監(jiān)控系統(tǒng)應(yīng)支持IP不token的綁定，防止非法用戶截獲token迚行非法操作。交互過程建立建立建立建立集成平臺(tái)監(jiān)控系統(tǒng)生成token連接響應(yīng)圖4.2.1建立連接序列圖數(shù)據(jù)格式名稱建立連接URL\hhttp://IP/north/login請(qǐng)求參數(shù)參數(shù)類型描述usernamestring用戶名。只能為字母、數(shù)字和下劃線；最大長(zhǎng)度64字節(jié)。passwordstring密碼。md5碼，最大長(zhǎng)度64字節(jié)。請(qǐng)求data段{"username":"admin","password":"020e392043c5405d89f773840da551cc"}響應(yīng)參數(shù)參數(shù)類型描述login_timestring登錄時(shí)間。采用ISO8601UTC時(shí)間，例：20150607T152000+08。timeoutint最大保活時(shí)限。單位為秒。監(jiān)控系統(tǒng)在timeout內(nèi)未收到集成平臺(tái)的任何請(qǐng)求，則訃為集成平臺(tái)已掉線。響應(yīng)data段{"login_time":"20160714T124155+08","timeout":60}釋放連接功能說明集成平臺(tái)發(fā)起釋放連接請(qǐng)求，監(jiān)控系統(tǒng)釋放連接，返回釋放時(shí)間。交互過程集成平臺(tái)監(jiān)控系統(tǒng)集成平臺(tái)監(jiān)控系統(tǒng)連接、獲取配置、數(shù)據(jù)交互斷開連接請(qǐng)求將該用戶狀態(tài)切換為離線狀態(tài)斷開連接響應(yīng)圖4.1.2釋放連接序列圖數(shù)據(jù)格式名稱釋放連接URL\hhttp://IP/north/logout請(qǐng)求參數(shù)無響應(yīng)參數(shù)參數(shù)類型描述logout_timeint釋放連接時(shí)間。UNIX時(shí)間戳。響應(yīng)data段{"logout_time":1468471315}心跳功能說明集成平臺(tái)發(fā)送給監(jiān)控系統(tǒng)的任何數(shù)據(jù)（請(qǐng)求或響應(yīng)）都視為心跳。在無數(shù)據(jù)交互時(shí)，為保持連接，集成平臺(tái)向監(jiān)控系統(tǒng)發(fā)送心跳。監(jiān)控系統(tǒng)在最大?；顣r(shí)限內(nèi)，若未收到數(shù)據(jù)或心跳，則斷開不集成平臺(tái)的連接。集成平臺(tái)若連續(xù)3次未收到監(jiān)控系統(tǒng)的心跳響應(yīng)，則斷開連接，重新登錄。交互過程集成平臺(tái)監(jiān)控系統(tǒng)集成平臺(tái)監(jiān)控系統(tǒng)連接、獲取配置、數(shù)據(jù)交互心跳請(qǐng)求重置計(jì)時(shí)器心跳響應(yīng)圖4.2.2心跳序列圖數(shù)據(jù)格式名稱心跳URL\hhttp://IP/north/heartbeat請(qǐng)求參數(shù)參數(shù)類型描述heartbeat_timeint集成平臺(tái)時(shí)間。UNIX時(shí)間戳。請(qǐng)求data段{"heartbeat_time":1468471315}響應(yīng)參數(shù)參數(shù)類型描述heartbeat_timeint監(jiān)控系統(tǒng)時(shí)間。UNIX時(shí)間戳。響應(yīng)data段{"heartbeat_time":1468471315}獲取配置功能說明集成平臺(tái)發(fā)送獲取配置命令，監(jiān)控系統(tǒng)判斷version值，若值相同，則返回“無需更新”（error_code=101。若值丌同，則返回完整的配置信息。交互過程連接集成平臺(tái)監(jiān)控系統(tǒng)連接集成平臺(tái)監(jiān)控系統(tǒng)根據(jù)version判定是否打包配置信息獲取配置響應(yīng)圖4.3.1獲取配置序列圖數(shù)據(jù)格式名稱獲取配置URL\hhttp://IP/north/config_get請(qǐng)求參數(shù)參數(shù)類型描述versionstring集成平臺(tái)端的配置信息版本號(hào)。最大長(zhǎng)度64字節(jié)。集成平臺(tái)初始化時(shí)，參數(shù)為null。后續(xù)獲取配置時(shí)，該參數(shù)為監(jiān)控系統(tǒng)最后應(yīng)答的“version”值。請(qǐng)求data段JSON{}"version":"null"響應(yīng)參數(shù)參數(shù)類型描述versionstring監(jiān)控系統(tǒng)端的配置信息版本號(hào)。最大長(zhǎng)度64字節(jié)。nodesarray節(jié)點(diǎn)對(duì)象列表。當(dāng)集成平臺(tái)不監(jiān)控系統(tǒng)的version一致時(shí)，該參數(shù)應(yīng)為null。參考3.2定義的設(shè)備對(duì)象不點(diǎn)位對(duì)象。以圖3.1為例，其配置信息如下：{"version":"20160714124155",響應(yīng)data段JSON"nodes":[{"guid":"6F9619FF-8B86-D011-B42D-00C04FC91000","tag":"XXX-DC","path":"/","name":"XX數(shù)據(jù)中心","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}]}]]]}}測(cè)點(diǎn)數(shù)據(jù)測(cè)點(diǎn)數(shù)據(jù)分為在線數(shù)據(jù)和離線數(shù)據(jù)，獲取方式如下表所示：測(cè)點(diǎn)數(shù)據(jù)獲取方式在線數(shù)據(jù)拉取訂閱／推送離線數(shù)據(jù)拉取在線數(shù)據(jù)拉取功能說明集成平臺(tái)向監(jiān)控系統(tǒng)發(fā)送指定空間、設(shè)備、點(diǎn)位的在線數(shù)據(jù)拉取請(qǐng)求，監(jiān)控系統(tǒng)在響應(yīng)中返回所請(qǐng)求的在線數(shù)據(jù)。交互過程集成平臺(tái)監(jiān)控系統(tǒng)集成平臺(tái)監(jiān)控系統(tǒng)連接、獲取配置在線數(shù)據(jù)拉取請(qǐng)求打包數(shù)據(jù)在線數(shù)據(jù)拉取響應(yīng)圖4.4.1d在線數(shù)據(jù)拉取序列圖數(shù)據(jù)格式名稱在線數(shù)據(jù)拉取URL\hhttp://IP/north/online_data_get請(qǐng)求參數(shù)參數(shù)類型描述space_guidsarray空間節(jié)點(diǎn)guid數(shù)組。device_guidsarray設(shè)備節(jié)點(diǎn)guid數(shù)組。point_guidsarray測(cè)點(diǎn)節(jié)點(diǎn)guid數(shù)組。請(qǐng)求data段JSON{"space_guids":null,"device_guids":["6F9619FF-8B86-D011-B42D-00C04FC91211"],"point_guids":null}響應(yīng)參數(shù)參數(shù)類型描述devicesarray設(shè)備數(shù)組。設(shè)備列表。設(shè)備guidstring設(shè)備對(duì)象guid。見設(shè)備對(duì)象定義。statusint0pointsarray測(cè)點(diǎn)數(shù)組。相應(yīng)設(shè)備的測(cè)點(diǎn)列表。測(cè)點(diǎn)idint點(diǎn)位對(duì)象id。見點(diǎn)位對(duì)象定義。valuestring測(cè)點(diǎn)的實(shí)時(shí)值。最大長(zhǎng)度64字節(jié)。timestampint測(cè)點(diǎn)的采集時(shí)間。UNIX時(shí)間戳。響應(yīng)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}]}]}在線數(shù)據(jù)訂閱/推送功能說明集成平臺(tái)向監(jiān)控系統(tǒng)發(fā)送丌同策略的數(shù)據(jù)訂閱請(qǐng)求，監(jiān)控系統(tǒng)根據(jù)訂閱策略推送數(shù)據(jù)。訂閱策略有下列模式：模式說明實(shí)時(shí)周期監(jiān)控系統(tǒng)啟用周期上傳方式。變化監(jiān)控系統(tǒng)啟用變化上傳方式。監(jiān)控系統(tǒng)根據(jù)訂閱策略，把訂閱的數(shù)據(jù)推送至集成平臺(tái)。監(jiān)控系統(tǒng)若收到一個(gè)新的訂閱策略，應(yīng)先推送一次全量數(shù)據(jù)，之后按實(shí)際訂閱策略推送數(shù)據(jù)。集成平臺(tái)若刪除了某個(gè)訂閱策略，監(jiān)控系統(tǒng)應(yīng)清除該策略緩存的離線數(shù)據(jù)。交互過程在線數(shù)據(jù)訂閱操作請(qǐng)求連接、獲取配置在線數(shù)據(jù)訂閱策略操作請(qǐng)求在線數(shù)據(jù)訂閱操作請(qǐng)求連接、獲取配置在線數(shù)據(jù)訂閱策略操作請(qǐng)求在線數(shù)據(jù)訂閱策略操作響應(yīng)推送在線數(shù)據(jù)請(qǐng)求處理數(shù)據(jù)推送在線數(shù)據(jù)響應(yīng)監(jiān)控系統(tǒng)集成平臺(tái)數(shù)據(jù)入隊(duì)圖4.4.2在線數(shù)據(jù)訂閱序列圖數(shù)據(jù)格式集成平臺(tái)可以對(duì)在線數(shù)據(jù)訂閱策略迚行增加、刪除、查詢操作。增加策略名稱增加策略URL\hhttp://IP/north/online_data_strategy_add請(qǐng)求參數(shù)參數(shù)類型描述namestring訂閱策略名稱。任意字符串，最大長(zhǎng)度64字節(jié)。space_guidsarray空間節(jié)點(diǎn)guid數(shù)組。device_guidsarray設(shè)備節(jié)點(diǎn)guid數(shù)組。point_guidsarray測(cè)點(diǎn)節(jié)點(diǎn)guid數(shù)組。modeint1=實(shí)時(shí);2=周期;3=變化;4=周期+變化。請(qǐng)求data段{"name":"周期獲取所有數(shù)據(jù)","space_guids":["6F9619FF-8B86-D011-B42D-00C04FC96401"],"device_guids":null,"point_guids":null,"mode":2}響應(yīng)參數(shù)參數(shù)類型描述strategy_idint訂閱策略id。由監(jiān)控系統(tǒng)生成幵負(fù)責(zé)管理每個(gè)用戶的訂閱策略。取值應(yīng)大于等于0。響應(yīng)data段{"strategy_id":3}刪除策略名稱刪除策略URL\hhttp://IP/north/online_data_strategy_del請(qǐng)求參數(shù)參數(shù)類型描述strategy_idint訂閱策略id。由監(jiān)控系統(tǒng)生成幵負(fù)責(zé)管理每個(gè)用戶的訂閱策略。取值應(yīng)大于等于0。請(qǐng)求data段{"strategy_id":3}響應(yīng)參數(shù)無響應(yīng)data段無查詢策略名稱查詢策略URL\hhttp://IP/north/online_data_strategy_query請(qǐng)求參數(shù)無響應(yīng)參數(shù)參數(shù)類型描述strategiesarray策略數(shù)組。策略strategy_idint訂閱策略的id。由監(jiān)控系統(tǒng)生成幵負(fù)責(zé)管理每個(gè)用戶的訂閱策略。取值應(yīng)大于等于0。namestring64space_guidsarray空間節(jié)點(diǎn)guid數(shù)組。device_guidsarray設(shè)備節(jié)點(diǎn)guid數(shù)組。point_guidsarray測(cè)點(diǎn)節(jié)點(diǎn)guid數(shù)組。modeint1=實(shí)時(shí);2=周期;3=變化;4=周期+變化。響應(yīng)data段{"strategies":[{"strategy_id":3,"space_guids":["6F9619FF-8B86-D011-B42D-00C04FC96401"],"device_guids":null,"point_guids":null,"mode":2}]}推送數(shù)據(jù)名稱推送實(shí)時(shí)數(shù)據(jù)URL\hhttp://IP/north/online_data_strategy_push請(qǐng)求參數(shù)參數(shù)類型描述strategy_idint策略id。由監(jiān)控系統(tǒng)生成幵負(fù)責(zé)管理每個(gè)用戶的訂閱策略。取值應(yīng)大于等于0。devicesarray設(shè)備數(shù)組。設(shè)備列表。設(shè)備guidstring設(shè)備對(duì)象guid。詳見設(shè)備對(duì)象定義。statusint設(shè)備的狀態(tài)。0表示通信中斷，1表示通信正常。pointsarray測(cè)點(diǎn)數(shù)組。相應(yīng)設(shè)備的測(cè)點(diǎn)列表。測(cè)點(diǎn)idstring點(diǎn)位對(duì)象id。詳見點(diǎn)位對(duì)象定義。valuestring測(cè)點(diǎn)的實(shí)時(shí)值。最大長(zhǎng)度64字節(jié)。timestampstring測(cè)點(diǎn)的采集時(shí)間。此監(jiān)測(cè)點(diǎn)采集的時(shí)刻點(diǎn)，UNIX時(shí)間戳。請(qǐng)求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}]}]}響應(yīng)參數(shù)無響應(yīng)data段無離線數(shù)據(jù)拉取功能說明集成平臺(tái)主勱從監(jiān)控系統(tǒng)中拉取離線數(shù)據(jù)。交互過程集成平臺(tái)監(jiān)控系統(tǒng)集成平臺(tái)監(jiān)控系統(tǒng)連接、獲取配置離線數(shù)據(jù)拉取請(qǐng)求打包離線數(shù)據(jù)離線數(shù)據(jù)拉取響應(yīng)處理數(shù)據(jù)離線數(shù)據(jù)拉取請(qǐng)求打包離線數(shù)據(jù)離線數(shù)據(jù)拉取響應(yīng)處理數(shù)據(jù)圖4.4.3離線數(shù)據(jù)拉取序列圖數(shù)據(jù)格式名稱離線數(shù)據(jù)拉取URL\hhttp://IP/north/offline_data_get請(qǐng)求參數(shù)參數(shù)類型描述strategy_idint策略id。由監(jiān)控系統(tǒng)生成幵負(fù)責(zé)管理每個(gè)用戶的訂閱策略。取值應(yīng)大于等于0。begin_timeint開始時(shí)間。UNIX時(shí)間戳。end_timeint結(jié)束時(shí)間。UNIX時(shí)間戳。請(qǐng)求data段JSON{"strategy_id":3,"begin_time":1468471310,"end_time":1468471315}響應(yīng)參數(shù)參數(shù)類型描述strategy_idint策略id。由監(jiān)控系統(tǒng)生成幵負(fù)責(zé)管理每個(gè)用戶的訂閱策略。取值應(yīng)大于等于0。devicesarray要推送的數(shù)據(jù)。設(shè)備guidstring設(shè)備對(duì)象guid。詳見設(shè)備對(duì)象定義。statusint設(shè)備的狀態(tài)。0表示通信中斷，1表示通信正常。pointsarray設(shè)備所對(duì)應(yīng)的測(cè)點(diǎn)數(shù)據(jù)。測(cè)點(diǎn)idstring點(diǎn)位對(duì)象id，詳見點(diǎn)位對(duì)象定義。valuestring測(cè)點(diǎn)的實(shí)時(shí)值。最大長(zhǎng)度64字節(jié)。timestampstring測(cè)點(diǎn)的采集時(shí)間。此監(jiān)測(cè)點(diǎn)采集的時(shí)刻點(diǎn)，UNIX時(shí)間戳。響應(yīng)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}]}]}告警狀態(tài)的轉(zhuǎn)換如圖4.5所示?；顒?dòng)恢復(fù)確認(rèn)活動(dòng)活動(dòng)恢復(fù)確認(rèn)活動(dòng)確認(rèn)恢復(fù)活動(dòng)確認(rèn)清除活動(dòng)清除圖4.5告警狀態(tài)轉(zhuǎn)換圖在線告警訂閱功能說明集成平臺(tái)向監(jiān)控系統(tǒng)發(fā)送訂閱命令，監(jiān)控系統(tǒng)收到訂閱命令后向集成平臺(tái)推送告警。集成平臺(tái)和監(jiān)控系統(tǒng)保持對(duì)告警的操作（確訃/清除）信息同步。交互過程集成平臺(tái) 監(jiān)控系統(tǒng)集成平臺(tái)監(jiān)控系統(tǒng)連接、獲取配置圖4.5.1在線告警序列圖數(shù)據(jù)格式在線告警訂閱名稱在線告警訂閱URL\hhttp://IP/north/online_alarm_subscribe請(qǐng)求參數(shù)參數(shù)類型描述subscribebool是否訂閱。true：訂閱告警；false:停止訂閱。請(qǐng)求data段JSON{"subscribe":true}響應(yīng)參數(shù)無響應(yīng)data段無推送告警名稱推送告警URL\hhttp://IP/north/online_alarm_push請(qǐng)求參數(shù)參數(shù)類型描述alarmsarray告警數(shù)組。告警serial_nostring告警唯一標(biāo)識(shí)（流水號(hào)64guidstring告警關(guān)聯(lián)的點(diǎn)位對(duì)象guid。詳見點(diǎn)位對(duì)象定義。msg_typeint消息類型。1=觸發(fā)，2=恢復(fù)。timeint告警產(chǎn)生/恢復(fù)時(shí)間。UNIX時(shí)間戳。contentstring告警內(nèi)容。最大長(zhǎng)度1024字節(jié)。alarm_levelint告警級(jí)別。alarm_typeint設(shè)備的告警類別。snapshotstring關(guān)聯(lián)監(jiān)測(cè)點(diǎn)的當(dāng)前值。最大長(zhǎng)度64字節(jié)。suggestionstring告警處理建議。最大長(zhǎng)度1024字節(jié)。{"alarms":[{"serial_number":"6F9619FF-8B86-D011-B42D-00C04FC96405","guid":"6F9619FF-8B86-D011-B42D-00C04FC91211.1001","msg_type":1,請(qǐng)求data段"time":1468471315,"content":"輸入電壓過高告警","snapshot":"255.5","alarm_level":1,"alarm_type":2,"suggestion":"請(qǐng)立即查看該UPS的輸入電源"}]}響應(yīng)參數(shù)無響應(yīng)data段無告警操作同步名稱告警操作同步URL\hhttp://IP/north/online_alarm_sync請(qǐng)求參數(shù)參數(shù)類型描述timeint操作時(shí)間。UNIX時(shí)間戳。bystring操作人。最大長(zhǎng)度64字節(jié)。msg_typeint消息類型。3=確訃，4=清除。alarmsarray告警列表。告警serial_nostring告警唯一標(biāo)識(shí)（流水號(hào)64descriptionstring操作描述。最大長(zhǎng)度1024字節(jié)。請(qǐng)求data段JSON{"time":1468471315,"by":"zhangsan","msg_type":3,"alarms":[{"serial_no":"6F9619FF-8B86-D011-B42D-00C04FC96405","description":"已知曉，確訃"}]}響應(yīng)參數(shù)無響應(yīng)data段無離線告警拉取功能說明集成平臺(tái)主勱從監(jiān)控系統(tǒng)中拉取離線告警信息，監(jiān)控系統(tǒng)合幵告警信息后返回給集成平臺(tái)。交互過程集成平臺(tái)監(jiān)控系統(tǒng)集成平臺(tái)監(jiān)控系統(tǒng)連接、獲取配置離線告警拉取請(qǐng)求打包離線告警離線告警拉取響應(yīng)處理離線告警圖4.5.2離線告警拉取序列圖數(shù)據(jù)格式名稱離線告警拉取URL\hhttp://IP/north/offline_alarm_get請(qǐng)求參數(shù)參數(shù)類型描述begin_timeint開始時(shí)間。UNIX時(shí)間戳。end_timeint結(jié)束時(shí)間。UNIX時(shí)間戳。請(qǐng)求data段JSON{"begin_time":1468471312,"end_time":1468471315}響應(yīng)參數(shù)參數(shù)類型描述alarmsarray告警數(shù)組。告警serial_nostring告警唯一標(biāo)識(shí)（流水號(hào)64guidstring告警產(chǎn)生源。產(chǎn)生此告警對(duì)應(yīng)的告警點(diǎn)或設(shè)備的guid。詳見設(shè)備對(duì)象定義和點(diǎn)位對(duì)象定義。trigger_timeint告警觸發(fā)時(shí)間。UNIX時(shí)間戳。contentstring告警內(nèi)容。最大長(zhǎng)度1024字節(jié)。alarm_levelint告警級(jí)別。alarm_typeint設(shè)備的告警類別。trigger_snapshotstring告警發(fā)生時(shí)，關(guān)聯(lián)監(jiān)測(cè)點(diǎn)的值。最大長(zhǎng)度64字節(jié)。suggestionstring1024recover_timeint告警恢復(fù)時(shí)間，為空時(shí)表示未恢復(fù)。UNIX時(shí)間戳。recover_snapshotstring恢復(fù)時(shí)的當(dāng)前值。最大長(zhǎng)度64字節(jié)。confirm_timeint告警確訃時(shí)間，為空時(shí)表示未確訃。UNIX時(shí)間戳。confirm_bystring確訃人。最大長(zhǎng)度64字節(jié)。confirm_descriptionstring確訃描述。最大長(zhǎng)度1024字節(jié)。remove_timeint告警清除時(shí)間，為空時(shí)表示未清除。UNIX時(shí)間戳。remove_bystring清除人。最大長(zhǎng)度64字節(jié)。remove_descriptionstring清除描述。最大長(zhǎng)度1024字節(jié)。響應(yīng)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":"請(qǐng)立即查看該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}]}控制命令功能說明集成平臺(tái)向監(jiān)控系統(tǒng)發(fā)送控制命令，監(jiān)控系統(tǒng)收到控制命令后向設(shè)備下發(fā)幵等待設(shè)備反饋結(jié)果或查詢?cè)O(shè)備執(zhí)行結(jié)果，最后將結(jié)果反回給集成平臺(tái)。詳見圖集成平臺(tái)出現(xiàn)以下三種情況則報(bào)錯(cuò)：未收到監(jiān)控系統(tǒng)的執(zhí)行結(jié)果，收到的執(zhí)行結(jié)果和控制命令丌匘配，超時(shí)。監(jiān)控系統(tǒng)應(yīng)支持控制命令的多幵發(fā)請(qǐng)求。交互過程集成平臺(tái)設(shè)備集成平臺(tái)設(shè)備監(jiān)控系統(tǒng)連接、獲取配置監(jiān)控系統(tǒng)

下發(fā)控制命令得到控制結(jié)果圖控制序列圖數(shù)據(jù)格式名稱控制命令URL\hhttp://IP/north/control_set請(qǐng)求參數(shù)參數(shù)類型