ICS35.020

點擊此處添加中國標準文獻分類號

DB

四川省（內江市）地方標準

DBXX/XXXXX—XXXX

城市物聯(lián)網管理平臺

事件對接規(guī)范

點擊此處添加標準英文譯名

點擊此處添加與國際標準一致性程度的標識

（報批稿）

20-XX-XX發(fā)布20-XX-XX實施

XX發(fā)布

DBXX/XXXXX—XXXX

城市物聯(lián)網管理平臺事件對接規(guī)范

1范圍

本文件規(guī)定了內江市感知設備/終端事件術語和定義、事件基本定義、事件定義標準、事件推送服

務規(guī)范。

本文件適用于內江市所有政府投資建設項目的感知設備/終端的建設。

2規(guī)范性引用文件

下列文件對于本文件的應用是必不可少的。凡是注日期的引用文件，僅所注日期的版本適用于本文

件。凡是不注日期的引用文件，其最新版本（包括所有的修改單）適用于本文件。

GB/T33474-2016物聯(lián)網參考體系結構

GB/T33745-2017物聯(lián)網術語

GB/Z33750-2017物聯(lián)網標準化工作指南

GB/T34068-2017物聯(lián)網總體技術智能傳感器接口規(guī)范

GB/T35319-2017物聯(lián)網系統(tǒng)接口要求

GB/T36620-2018面向智慧城市的物聯(lián)網技術應用指南

GB/T36951-2018信息安全技術物聯(lián)網感知終端應用安全技術要求

GB/T37024-2018信息安全技術物聯(lián)網感知層網關安全技術要求

GB/T37093-2018信息安全技術物聯(lián)網感知層接入通信網的安全要求

GB/T37686-2019物聯(lián)網感知對象信息融合模型

3術語和定義

3.1

物聯(lián)網internetofthings；IoT

通過感知設備，按照約定協(xié)議，連接物、人、系統(tǒng)和信息資源，實現(xiàn)對物理和虛擬世界的信息進行

處理并做出反應的智能服務系統(tǒng)。

[來源：GB/T33745-2017,定義2.1.1]

3.2

感知設備/終端sensingdevice/sensorterminal

能夠獲取對象信息的設備，并提供接入網絡的能力，對物或環(huán)境進行信息采集和/或執(zhí)行操作，并

能聯(lián)網進行通信的裝置。

[來源:GB/T33745-2017,定義2.1.9][GB/T37024-2018,定義3.3]

3.3

產品類型typp

1

DBXX/XXXXX—XXXX

產品類型是指行業(yè)內感知設備的通行分類，如“水位計”，是一系列產品集合。

3.4

產品product

產品是指在某種產品類型下，由某一供應商生產的特定產品，通常指一組具有相同功能的設備集合,

如產品類型：水位計。產品：XX型號水位計。生產廠商：XX公司。

3.5

設備device

歸屬于某個產品下的具體部署的設備。如產品類型：水位計。產品：XX型號水位計。生產廠商：XX

公司。設備：XX設備。

3.6

物模型thingmodel

是對設備在云端的功能描述，包括設備的屬性、服務和事件。5G物聯(lián)網管理平臺通過定義一種物的

描述語言來描述物模型，稱之為TSL(即ThingSpecificationLanguage)o

3.7

屬性property

設備的功能模型之一，一般用于描述設備運行時的狀態(tài)，如環(huán)境監(jiān)測設備所讀取的當前環(huán)境溫度等。

屬性支持GET和SET請求方式。應用系統(tǒng)可發(fā)起對屬性的讀取和設置請求。

3.8

事件event

設備的功能模型之一，設備運行時的事件。事件一般包含需要被外部感知和處理的通知信息，可包

含多個輸出參數(shù)。例如，某項任務完成的信息，或者設備發(fā)生故障或告警時的溫度等，事件可以被訂閱

和推送。

3.9

服務service

設備的功能模型之一，設備可被外部調用的能力或方法，可設置輸入參數(shù)和輸出參數(shù)。相比于屬性,

服務可通過一條指令實現(xiàn)更更雜的業(yè)務邏輯，如執(zhí)行某項特定的任務。

3.10

應用application

應用系統(tǒng)一般指面向業(yè)務需求開發(fā)的軟件系統(tǒng)，在平臺中，特指需要從5G物聯(lián)網管理平臺獲得感知

數(shù)據外部系統(tǒng)，需要在平臺上進行注冊，并頒發(fā)認證。

3.11

數(shù)據推送datapush

內江物聯(lián)網平臺面向應用提供數(shù)據服務方式之一，通過HTTP或者MQ的方式將設備屬性、事件的數(shù)據

主動推送給應用，具有實時性高的特點，但是只能推送實時數(shù)據，無法推送歷史數(shù)據。

2

DBXX/XXXXX—XXXX

表1事件定義模板

標識名稱類型數(shù)據定義描述輸出

[<參數(shù)〈參數(shù)參數(shù)（每個參數(shù)的數(shù)據定

事件標識事件1INFO無需數(shù)據事件1描IX2>,<3>]

義可對應上面的各種數(shù)據定義）

1定義述例子：

[

{"name":"開關狀態(tài)"，*dataType*:"BOOL”,

“paraOrder":0,"identifier”:

"status","dataSpecs":{"0":"開"1":"關"}},

{"name":"數(shù)值"，"dataTypc":"FLOAT”,

*paraOrder*:1,“identifier”:

value,dalaSpecs:{unit:%,unitName:

百分比”「min":"0","max":TOO"}}

]

事件標識事件2ALERT無需數(shù)據事件2描[〈參數(shù)1〉,〈參數(shù)2》,〈參數(shù)3>]

2定義述

事件標識事件3ERROR無需數(shù)據事件3描卜參數(shù)1>,〈參數(shù)2>,<參數(shù)3>]

3定義述

5.2告警事件定義標準

平臺通過內置的多種設備異常識別算法（數(shù)據上報超時:連續(xù)極值異常、極值占比異常）來及時發(fā)

現(xiàn)設備異常并觸發(fā)設備告警。

ID:RKGJbpwrgEEHh6u5im$l

“；：：：&碎ma?裁三萬

d|||bl.設.異常識融法

ID:RKGJbpwrgEEHh6u5imsl八。

*5有毒（OXJLCW_0M?京三萬

圖1設備告警流程

4

DBXX/XXXXX—XXXX

5.2.1告警事件類型

a）上報數(shù)據超時智能檢測

大部分的物聯(lián)網感知設備都會按一定頻率上報數(shù)據，如果未按時上報數(shù)據，則大概率設備出現(xiàn)損壞

或者異常，可能是為硬件故障或者電量不足等原因造成的設備離線，或者因為信號不穩(wěn)定導致的數(shù)據丟

失。

平臺會根據設備的上報數(shù)據的時間間隔來識別出設備上報數(shù)據頻率，而對于超過上報頻率還未上報

數(shù)據的設備，平臺會自動產生對應的告警記錄，同時也會將設備狀態(tài)設置為“異常”。而但是對于沒有

固定上報頻率的設備，則平臺無法產生上報數(shù)據超時的告警。

圖2上報數(shù)據超時智能檢測

b）連續(xù)極值異常智能檢測

物聯(lián)網設備本身所處的環(huán)境比較復雜，因此設備上報的數(shù)據可能因為傳感器受到損壞或者其他信號

干擾導致上報數(shù)據超出合理范疇，偶然出現(xiàn)一些數(shù)據波動可以認為是環(huán)境影響所致，無需過多關注。但

是對于設備上報數(shù)據持續(xù)超出合理范圍，則應該加以美注。

對于定義了取值范圍的設備（取值范圍根據該設備對應的物模型中對應數(shù)據項的定義），平臺會自

動檢測該設備上報的數(shù)據是否在取值范圍內，并且進行計數(shù)累加，如果計數(shù)的值超過默認次數(shù)時會自動

觸發(fā)系統(tǒng)自動生成的告警規(guī)則，并生成對應的告警記錄。

圖3連續(xù)極值異常智能檢測

c）極值占比異常智能檢測

如果設備上報的異常數(shù)據（超出正常范圍）在?段時間范圍內占比過大，則認為設備本身可能出現(xiàn)

5

DBXX/XXXXX—XXXX

故障，應及時關注，而設備上報的數(shù)據不準確也會對業(yè)務應用造成干擾。

系統(tǒng)自動識別設備數(shù)據項的閾值，在一定時間范圍內設備上報的數(shù)據超過或低于閾值的次數(shù)占比過

高，會自動觸發(fā)報警。

圖4極值占比異常智能檢測

5.2.2告警事件定義要求

告警事件名稱要求中文、英文字母、數(shù)字、下劃線和短劃線，長度限制4-32。

5.2.2.1告警事件觸發(fā)

設備告警事件觸發(fā)規(guī)則可自己定義，滿足觸發(fā)條件后系統(tǒng)會自動將設備狀態(tài)設置為異常。

5.2.2,1.1告警類型

包括數(shù)據上報超時,、連續(xù)極值異常、極值占比異常。

5.2.2.1.2關聯(lián)設備

指需要對那些設備配置該告警觸發(fā)規(guī)則，按照產品維度進行配置，即該產品下的所有設備只要滿足

告警觸發(fā)規(guī)則即會觸發(fā)告警。

5.2.2,1.3告警觸發(fā)規(guī)則

指美聯(lián)設備如果超過xx分鐘/小時沒有向平臺上報過任何數(shù)據，則會觸發(fā)設備告警，對應的設備狀

態(tài)也會自動被設置為“異?！?。

5.2.2,2告警事件去重

各部門應配置告警事件去重規(guī)則，即如果告警設備的觸發(fā)條件持續(xù)滿足，而且設備的狀杰依然是“異

?！保瑒t即便條件滿足系統(tǒng)不會針對該設備再產生新的告警記錄，從而減少頻繁設備告警造成干擾。

5.2.23告警事件恢復

對于滿足告警的設備會自動觸發(fā)設備告警，產生相應的告警記錄，同時設備狀態(tài)也會自動被設置為

“異?！?。而當設備的告警規(guī)則不再滿足時.,系統(tǒng)也會自動將設備告警記錄變成“已恢復”，同時設備

狀態(tài)也會被自動設置為“正?！薄?/p>

5.3感知事件定義標準

5.3.1感知事件等級

感知事件根據事件嚴重程度，分為“一般、較大、重大、特級重大”四個等級。各業(yè)務部門配置感

知數(shù)據，需結合業(yè)務需求定義事件嚴重等級，實現(xiàn)不同等級感知事件分級分類管理。

5.3.2感知事件定義要求

6

DBXX/XXXXX—XXXX

5.3.2.1感知事件觸發(fā)

各部門基于業(yè)務需求，結合已經接入的感知設備，配置自定義的事件警觸發(fā)規(guī)則，滿足觸發(fā)條件后

平臺會自動生成感知事件記錄。事件名稱要求中文、英文字母、數(shù)字、下劃線和短劃線，長度限制4-32。

感知事件觸發(fā)規(guī)則定義示例見圖5o

創(chuàng)建事件規(guī)則x

*事件名稱

支持中文、英文字母、數(shù)字、下劃線和短劃線，長度限制4-32

事件觸發(fā)規(guī)則

*觸發(fā)源：

F]?——展示平臺中的所有產品

需要滿足以下|任意不5條件即可觸發(fā)事件

*觸發(fā)規(guī)則

+觸發(fā)規(guī)則

o配置事件觸發(fā)規(guī)則，當觸發(fā)源中的設備上報的數(shù)據滿足觸發(fā)規(guī)則時，自動生成相

關事件記錄查■示例

*事件等級：

事件通知方式

釘打機器人

調用外部接口

確認取消

圖5創(chuàng)建感知事件

觸發(fā)規(guī)則示例1見圖6。

門磁設備檢測到老舊小區(qū)單元門保持開門狀態(tài)持續(xù)30分鐘，才產生小區(qū)安全風險事件。

7

DBXX/XXXXX—XXXX

示例x

場景1場景2場景3場景4場景5

場景描述:門密設備檢測到老舊小區(qū)單元門保持開門狀態(tài)持續(xù)30分鐘，才產生小區(qū)安全風險事件

IlR元門優(yōu)6■“開?

Bl2元門優(yōu)a.

觸發(fā)規(guī)則示例:

門磁

MR足以下任意一個*條件即可W件

觸發(fā)規(guī)則：

單元門狀態(tài)V快時值▼,v||開門持續(xù)時間V|30|分元▼

圖6觸發(fā)規(guī)則示例1

觸發(fā)規(guī)則示例2見圖7。

消防拴水壓檢測設備檢測到在2個小時內水壓平均值低于O.IMpa,產生消防設施安全隱患事件

8

DBXX/XXXXX—XXXX

示例X

場景1場景2場景3場景4場景5

場景描述:消防拴水壓檢艙HHftl斶I在2個小時內水壓平均值低于O.IMpa,產生消防設施安全?件

觸發(fā)規(guī)則示例:

室外消滅栓水壓監(jiān)測儀V

需要滿足以下任意一個▼條件即可觸發(fā)■件

觸發(fā)規(guī)則：

東百V蛻計值；［￥均值丁在2一］他.內VV卜.1|

圖7觸發(fā)規(guī)則示例2

觸發(fā)規(guī)則示例3見圖8。

河道水質檢測設備檢測的任一指標超標，產生水質污染事件。

9

DBXX/XXXXX—XXXX

示例x

場景1場景2場景3場景4場景5

場景描述:河道水質檢測設備檢測的任一指標超標，產生水質污染事件

觸發(fā)規(guī)則示例:

水質監(jiān)測終送另

需孌滿足以T~條件即可觸發(fā)?件

觸發(fā)規(guī)則：

溶超氧;實時值二＜

持續(xù)次數(shù)▼1次

期繳；實時值;~特續(xù)次數(shù)二次

圖8觸發(fā)規(guī)則示例3

5.3.2.2感知事件去重

各部門應臼行配置感知事件去重規(guī)則，同一個事件記錄產生后，在事件恢復之前，系統(tǒng)不會繼續(xù)產

生新的事件記錄。從而減少因為頻繁上報事件導致的干擾。

5.3.2.3感知事件恢復

對于產生的事件記錄，系統(tǒng)會自動識別該條事件記錄的觸發(fā)條件何時不再滿足，對于不再滿足觸發(fā)

條件事件記錄系統(tǒng)會自動變更其狀態(tài)，并設置恢復時間。

10

DBXX/XXXXX—XXXX

6感知平臺事件推送服務

6.1推送方式

應用獲得授權后，可通過HTTP和MQ兩種數(shù)據推送方式，獲得事件實時數(shù)據。

6.1.1HTTP推送

若需要推送數(shù)據的設備量不大，可以采用HTTP方式推送，但是數(shù)據推送的穩(wěn)定性依賴數(shù)據共享方

應用系統(tǒng)。（HTTP方式推送，若半小時推送失敗率超過50樂此方式會被中斷半小時，半小時后恢復再

恢復推送）。

6.1.2MQ推送

MQ（消息中間件）方式進行消息數(shù)據推送，適合大量設備的數(shù)據推送，穩(wěn)定性比較高，同時數(shù)據推

送的穩(wěn)定性不依賴數(shù)據共享方應用系統(tǒng)性能。內江物聯(lián)網平臺支持RocketMQ、Kafka等通用消息組件。

6.2事件推送格式

6.2.1設備事件消息格式

(

"tenantld":

organizationId:,

*platformKey*:",

instanceld:,

forcignProductKey

deviceName:,

“produclKey":"二

"A""""

categoryKey:,

outerld:,

2a.HH〃

time:,

*topicType*:*CITYHUF_EVENT_POST*,

“onlincStatus*:**,

“events”:[

(

time:,

identifier:,

“NN”

name:,

A*."2"

type:

)

]

}

11

DBXX/XXXXX—XXXX

6.2.2告警事件消息格式

(

anomalyld:,

status:,

startTime:,

“IF?2”2

endTime:,

anomalyName:,

Mconten,t":"H,

“l(fā)enanlld":

organizationId:,

“produclKey":"二

deviceName:,

“result”:false,

ruleld:,

*tnpieTypP*:”CITYHIIFEVENTPFRCF.PTTONPOST*,

“timeslamp”:,

“l(fā)ocation”:{

“altitude”:,

“l(fā)atitude”:,

“l(fā)ongitude”:,

/*IIft

address:

),

“dcviccPropcrtyAnomalics”:[

(

“l(fā)enanlld":、

^productKey*:

deviceName:,

“timestamp”:,

?I?C?〃

identifier:,

*rulcOrdcr*:,

“result”:,

“amount”:,

"rate”:,

"windowSize”:,

“timeUnit":"",

HyH

value:,

*startTimestairp*:,

*endTimestamp*:,

“mcssagcSizc”:,

*anomalyMessageSize*:,

*devicePropertyMessages*:[

12

DBXX/XXXXX—XXXX

dataType:

identifier:

“timestamp”:,

value:,

1

}

]

)

6.2.3感知事件消息格式

anomalyld:,

status:,

startTime:,

end!ime:,

anomalyName:,

HHrr

content“:,

“tenantld":

*organizationld*:

*productKcy*:

deviceName:,

"result/:false,

"ruleld":

"lopicType”:XITY_IIUF_EVENT_PERCEPTION_POST*,

“timestamp”:,

“l(fā)ocation”:{

“altitude”:.

“l(fā)atitude”:,

“l(fā)ongitude”:,

A*It〃

address:

},

“devicePropertyAnomalies”:[

(

*tenantld*:**,

*productKey*:**,

“d1cvi?coNKTamc":””,

1J

DBXX/XXXXX—XXXX

“timestamp”:,

identifier:,

“ruleOrder”:,

“result*:,

“amount”:,

Nft

rate:,

"windowSize*:,

timelnit:,

value:,

“slarlTimeslamp”:,

*endTimestamp*:,

“messageSize”:,

“anomalyVessageSize”:,

^devicePropertyMessages*:[

(

datatype:

identifler:

“timestamp”:,

value:,

}

]

}

]

)

6.2.4主要字段說明

感知事件主要字段說明見表2。

表2感知事件主要字段表

字段名子字段名類型字段說明

tenantld/String租戶ID

organizationId/String組織ID

platformKey/String來源平臺ID

表2感知事件主要字段表（續(xù)）

字段名子字段名類型字段說明

14

DBXX/XXXXX—XXXX

instanceld/String來源平臺實例ID

productKey/String產品ID

foreignProductKey/String外部產品ID

deviceName/String設備名稱

categoryKey/String產品品類

outerId/String外部ID,如iotld

lopicType/String消息類型

anomalyId/String事件唯一標識

status/String事件狀態(tài)

startTime/Date事件觸發(fā)時間

endTime/Date事件恢復時間

anomalyNamc/String事件名稱

content/String事件內容

感知事件變化、設備狀態(tài)變化特有，true-告

result/Boolen

警false-恢復

identifierString屬性標識符

nameString屬性名

properties

valueString屬性值

dataTypeenum數(shù)據類型

identifierString事件標識符

eventsnameString事件名稱

type