C.2要求

SJ/T 11435-2015 信息技術服務服務管理技術要求 /

C.2.1監控管理與過程管理接口

C.2.1.1監控管理與過程管理接口標準返回定義

監控管理與過程管理接口的標準返回定義要求：

a)應使用表C.1定義的Result結構的格式串。

C.2要求

b)相關格式串宜使用JSON格式。

c)JSON規范宜遵循如下定義：

1)屬性名需要根據標準中定義的結構屬性，區分大小寫；

2)屬性項沒有值時，填寫為null；

3)屬性名、字符型數據要填寫在英文雙引號中。

示例：

一一返回數據集是數組對象的執行結果：{“result Code”：”0000”， “errorMsg”：null， “data”：[(1， 2) ] } ；

一一返回數據集是單個結構對象的執行結果：{“result Code”：”0000”， “errorMsg”：null， “data”：{“a”：1，“b”：”abc} } ；

一一返回數據集是int值的執行結果：{“result Code”：”0000”， “errorMsg”：null， “data”：10} ；

一一返回無數據集的執行結果：{“result Code”：”0000”， “errorMsg”：null， “data”：null} ；

一一返回有異常的執行結果：{“result Code”：”0010”， “errorMsg”：”Must assign mo type.”， “data”：null} 。

C.2.1.2告警信息接口

告警信息接口用于實現監控管理域向過程管理域發送管理對象的告警信息，遵循如下要求：

a)監控管理發現故障或異常后，應通過接口將告警信息傳遞到事件管理，登記為事件，由過程管理執行事件處理。

b)告警信息接口傳遞的數據應符合表C.2的要求。

C.2要求

c)告警信息接口的方法應符合表C.3的要求。

C.2要求

示例：舉一個網絡交換機192.168.1.1發生CPU使用率嚴重告警及恢復告警并通知過程管理的例子。

第1步：監控管理組織告警信息數據：

Id：由系統自動生成UUID，“550E8400-E29B-11D4-A716-446655440000”

alarmId：自行定義本次告警標識ID，“12345”

occurTime：填入本次告警發生的時刻， “2013-11-18 10:28:15”

message：自行組織本次告警的描述， “交換機192.168.1.1在2013-11-18 10:28:15 發生CPU使用率告警，當前值為98% 。”

severity ：2

source：“xx監控管理平臺”

alarmType ：1

moId：填入交換機192.168.1.1的標識，“245accec-3c12-4642-967f-e476cef558c4”

additionalInfo：沒有附加信息， null。
第2步：監控管理通過過程管理提供的String send Alarms(String alarms) 方法可以發送告警信息。輸入參數alarms為告警信息的數組，本次告警僅有一條， JSON格式如下：

[

{“Id”：“550E8400-E29B-11D4-A716-446655440000”，

“alarm Id”：“12345”，

“occurTime”：“2013-11-18 10:28:15”，

“message”：“網絡交換機192.168.1.1在2013-11-18 10:28:15 發生CPU使用率告警，當前值為98%。”，

“severity”：2，

“source”：“xx監控管理平臺”，

“alarm Type”：1，

“moId”：“245accec-3c12-4642-967f-e476cef558c4”，

“additional Info”：null

}

]

如果調用接口成功，則輸出結果為Result結構的JSON串：

{“result Code”：”0000”， “errorMsg”：null， “data”：null}
第3步：過程管理通過發送告警方法保存告警信息，可以做進一步的處理。
第4步：當網絡交換機192.168.1.1的CPU使用率恢復正常時，應發送恢復告警通知，監控管理組織恢復告警信息數據：

Id：由系統自動生成UUID， “ddd4b5a9-fe cd-446c-bd 78-63b70bb500a1”

alarmId：與產生告警的標識相同， “12345”

occurTime：填入本次恢復告警發生的時刻， “2013-11-18 15:30:15”

message：自行組織本次恢復告警的描述， “交換機192.168.1.1在2013-11-18 15:30:15 CPU使用率告警恢復，當前值為38%。”

severity ： 2

source：“xx監控管理平臺”

alarmType ： 2

moId：填入交換機192.168.1.1的標識， “245accec-3c12-4642-967f-e476cef558c4”

additionalInfo：沒有附加信息，不填。
第5步：監控管理通過過程管理提供的String send Alarms(String alarms) 方法可以發送恢復告警信息。輸入參數alarms為告警信息的數組，本次告警僅有一條， JSON格式如下：

[

{“Id”：“ddd4b5a9-fe cd-446c-bd 78-63b70bb500al”，

“alarmId”：“12345”，

“occurTime”：“2013-11-18 15:30:15”，

“message”：“網絡交換機192.168.1.1在2013-11-18 15:30:15 CPU使用率告警恢復，當前值為38% 。”，

“severity”：2，

“source”：“xx監控管理平臺”，

“alarm Type”：2，

“moId”：“245accec-3c 12-4642-967f-e476cef558c 4”，

“additional Info”：null

]

}

如果調用接口成功，則輸出結果為Result結構的JSON串：

{“result Code”：”0000”， “errorMsg”：null， “data”：null}
第6步：過程管理通過發送告警方法保存告警信息，可以做進一步的處理。

C.2.1.3性能信息接口

性能信息接口用于實現監控管理域向過程管理域同步管理對象性能信息，遵循如下要求：

a)監控管理采集性能數據后，應通過性能信息接口將采集對象的性能數據發送給過程管理。

b)性能信息接口傳遞的數據應符合表C.4的要求。

C.2要求

c)性能信息接口的方法包括：

1)查詢管理對象支持的指標列表，該方法應符合表C.5的要求。

C.2要求

2)查詢管理對象當前性能數據，該方法應符合表C.6的要求。

C.2要求

3)查詢制定管理對象指定指標的歷史性能數據，該方法應符合表C.7的要求。

C.2要求

4)在查詢歷史性能數據時，宜通過限制單次查詢的時間段長度、指標數量等方式保障數據交互的性能。

5)在查詢當前性能數據時，宜遵循軟件實現框架中的性能保障機制，通過超時限制等方式保障數據交互的性能。

示例：舉一個獲取網絡交換機192.168.1.1當前CPU使用率的數據以及前一天采集的所有性能數據的例子。

第1步：過程管理獲取網絡交換機在監控管理系統中的標識。過程管理通過監控管理提供的接口String get Mo Type() 獲取所有管理對象類型列表(MO Type結構的數組) ，針對結果逐個人工查看，找出網絡交換機對應的某項數據，該數據中的“mo TypeId”屬性的值即為管理對象類型標識。
第2步：過程管理獲取CPU使用率這個KPI在監控管理系統中的標識。通過監控管理提供的接口String get KPI List(string mo TypeId) 可以獲取網絡交換機所支持的所有KPI列表(KPI結構的數組) 針對結果逐個人工查看，找出業務含義同CPU使用率一致的某項數據，該數據中的“kpiId”屬性的值即為KPI標識。
第3步：過程管理通過監控管理提供的接口String get CurrentPM Data(string moId， string kpiId)可以獲取當前CPU使用率的性能數據。

輸入參數中moId為過程管理系統中保存的網絡交換機192.168.1.1的標識。
第4步：過程管理通過監控管理提供的接口Mo Performance get History PM Data(string moId， string[] kpiId， string startTime，string endTime) 可以獲取前一天CPU使用率的性能數據。

假如當前為2013年11月18日，那么輸入項中start Time為“2013-11-17 00:00:00”,endTime為“2013-11-17 23:59:59”。

C.2.1.4配置信息接口

1)配置信息接口是過程管理與監控管理之間有關配置項和管理對象數據的交互接口，遵循如下要求：

a)配置項數據應包括以下三類：

1)配置項基礎數據：用于描述每個配置項都具有的基本屬性數據，如配置項名稱、編號、所屬分類、屬性閾值等，該類型數據應在過程管理中定義，并按照管理策略經本接口傳遞給監控管理；

2)配置項特征數據：配置項技術特征相關的屬性數據，不同的配置項可能有不同的技術特征屬性，如CPU的主頻屬性，內存的容量屬性等，該類型數據應從監控管理中獲得，并按照管理策略經本接口傳遞給過程管理；

3)配置項關系數據：用于描述配置項與其他配置項之間的關系數據。如A與B之間的聯接關系，該類型數據能夠被監控管理感知的，應通過本接口從監控管理傳遞到過程管理。

b)配置信息接口分為三類接口：配置項基礎數據接口、配置項特征數據接口和配置項關系接口。

這三類接口分別用于傳遞C.3.1.4a)中所列的三類配置項數據。

c)管理對象數據包括監控系統采集并處理后的管理對象各項指標和屬性數據。

d)在監控管理與過程管理之間進行數據交互時，應實現管理對象數據與配置項數據之間的映射與轉換。

e)配置項基礎數據接口的要求包括：

1)數據要求應符合表C.8的要求。

C.2要求

2)獲取管理對象中配置項基礎信息設置所需參數信息的方法應符合表C.9的要求。

C.2要求

3)獲取管理對象中配置項基礎信息設置項集合的方法應符合表C.10的要求。

C.2要求

4)設置監控管理設置項應復核表C.11的要求。

C.2要求

示例：舉一個設置一個服務器序號為1的CPU溫度大于70℃就發生告警的例子。

第1步：設置項定義由監控廠商定義并提供，見“設置項定義表”，它應包含的字段有：編碼、類別、名稱、參數和說明。CPU溫度設置項的參數有：MOId(MO唯一標識) 、index(序號) 、threshold(閾值) 、operator(操作符) 。
第2步：過程管理通過String get Mo Setting Definition(string code) 方法可以獲取設置項的相關參數信息。“CPU溫度”對應的code=0101，方法返回Json格式的結果：

struct ItemSettingDefinition{
    code=0101；
    name=”CPU溫度”；
    args Definition=[
        {arg Name：MOId， dataType：string} ，
        {arg Name：index， dataType：int} ，
        {arg Name：threshold， dataType：float} ，
        [arg Name：operator， dataType：string)
        ]；
    Description=(設置項描述信息) ；
    }

第3步：過程管理通過該方法可以知道設置CPU溫度告警閾值需要的參數包括moId、index、threshold和operator，并且知道這些參數各自的類型，確保過程管理能夠與監控管理之間完成相關設置工作。
第4步：實例化一個設置項參數setting(類型為Item Setting Argument) ，實體內容如下：

Struct Item Setting Argument{
    code=0101；
    args=[
        (key：MOId， value：(服務器MOId) } ，
        {key：index， value：1} ，
        {key：threshold， value：70} ，
        {key：operator， value：*>”
        ]
    }

第5步：設置好參數setting后，調用方法bool set Item Setting(Item Setting Argument[] setting) ，設置設置項成功后返回true，失敗則返回false。

f)配置項特征數據接口的要求包括：

1)數據要求應符合表C.12的要求。

C.2要求

2)獲取監控管理中管理對象類型以及指標定義信息的列表應符合表C.13的方法要求。

C.2要求

3)監控新發現管理對象應符合表C.14的方法要求。

C.2要求

4)獲取監控對象的配置指標值應符合表C.15的要求。

C.2要求

g)配置項關系接口的要求包括：

1)數據要求應符合表C.16的要求。

C.2要求

2)獲取指定管理對象的關系應符合表C.17的要求。

C.2要求

3)獲取關聯管理對象ID列表應符合表C.18的要求。

C.2要求

h)配置項之間的關系應支持表C.19中要求的關系。

C.2要求

i)配置項之間的關系可支持表C.20的要求。

C.2要求

注：關系對編碼25 ~ 50用于標準本身預留擴展，關系對編碼51 ~ 99用于廠家預留擴展。

j)配置項類型碼表采用階梯式結構編制，每級分類占用兩位，當某個子類進一步細分時，直接在該類別編碼后擴展兩位，如主機編碼可以設置為010101，配置項類型最長為10位，即可實現五級分類，見表C.21。

C.2要求

k)設置項定義應符合表C.22的要求，采用階梯式結構編制，每級分類占用兩位，當某個子類進一步細分時，直接在該類別編碼后擴展兩位，如“CPU溫度”設置項的編碼可以設置為0101。該表內容并未完全覆蓋所有設置項，在使用時可據實擴充。

C.2要求

C.2.2過程管理與決策支撐接口

過程管理與決策支撐之間的接口應支持：

a)過程管理通過本接口實現向決策支撐傳遞決策所需信息。

b)過程管理接口傳遞的數據要求符合表C.23的要求。

C.2要求

c)過程管理信息類別編碼應符合表C.24的要求。

C.2要求

d)個過程應實現如表C.25的最小個性化屬性集。

C.2要求

e)過程管理接口的方法應包括：

1)查詢指定流程支持的信息類型列表應符合表C.26的要求。

C.2要求

2)查詢過程指標的信息數據應符合表C.27的要求。

C.2要求

示例：舉一個獲取近一個月內，首次服務即解決的事件數量的例子(假定今天是2013年5月31日)。

第一步：獲取事件流程支持的信息列表，找到獲取首次服務即解決的時間數量這個信息類型的Info Type定義。使用的接口方法是：InfoType[]getInfoTypeList(string processNo) ，查詢表C.23得知，事件流程對應的processNo為“10”，那么接口的實際調用編碼為InfoType[]getInfoTypeList(“10”) 。
第二步：分析getInfoTypeList的返回結果， getInfoTypeList會將事件流程支持的所有信息以Json格式返回，如：[{processNo：’10’，inf TypeNum：’10001’} ， {processNo：’10’，infoTypeNum：’10002’} ，{processNo：’10’，infoTypeNum：’10003’} ，{processNo：’10’，infoTypeNum：’10004’} ，{processNo：’10’，infoTypeNum：’10005’} ， {processNo：’10’，infoTypeNum：’10006’} ， {processNo：’10’，infoTypeNum：’10007’} ， {processNo：’10’，infoTypeNum：’10008’} ， {processNo：’10’，infoTypeNum：’10009’} ， {processNo：’10’，infoTypeNum：’10010’} ， {processNo：’10’，info TypeNum：’10011’} ， {processNo：’10’，infoTypeNum：’10012’} ， {processNo：’10’，infoTypeNum：’10013’} ， {processNo：’10’，infoTypeNum：’10014’} ， ] ，查詢表C.24過程管理信息類型得知首次服務即解決的時間數量對應的信息類型編號為10001，而返回數據中包含了10001的信息類型，這說明支持獲取首次服務即解決的時間數量。
第三步，調用get Info Values獲取一個月內首次服務即解決的事件數量，調用的偽代碼如下：

InfoType infoType = {process No：’10’， infoTypeNum：’10001’} ；

InfoProp[] infoProps=[] ；

Date startDate =“2013-05-01 00:00:00”；

Int timeCycleType=0；

InfoKPI[] getInfoValues(

        infoType；

        infuProps；

        timeCycleType;
);