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

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

獲取配置返回配置信息

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

請求 各請詳測數(shù)、響應(yīng) 告/操控命令章。推送 各推詳測數(shù)、響應(yīng) 告操等章。釋放連接斷開響應(yīng)

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

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