ETSI アラーム
ESC は、NFVO にアラームと通知を提供します。NFVO はこれらのアラームと通知に登録し、要求を ESC に送信する必要があります。
NFVO は、次の方法でアラームに関する情報を受信できます。
すべてのアラームをクエリする
NFVO は、アラームリソースからすべてのアラームのリストを取得できます。
メソッドタイプ:
GET
VNFM エンドポイント:
/vnffm/v1/alarms
HTTP 要求ヘッダー:
Accept:application/json
たとえば、イベントタイプが ENVIRONMENTAL_ALARM のすべてのアラームをクエリする場合
メソッドタイプ:
GET
VNFM エンドポイント:
http://localhost:8250/vnffm/v1/alarms?eventType="ENVIRONMENTAL_ALARM"
HTTP 要求ヘッダー:
Accept:application/json
複数アラームのクエリ中に、NFVO は URI クエリパラメータを使用して結果をフィルタ処理できます。アラームの URI クエリでは、次の属性名がサポートされています。
-
id
-
managedObjectId
-
rootCauseFaultyResource.faultyResourceType
-
eventType
-
perceivedSeverity
-
probableCause
(注) |
URI クエリパラメータは、複数のアラームのクエリ専用です。 |
個々のアラームのクエリ
NFVO は、alarmId リソースから特定のアラームをクエリできます。
メソッドタイプ:
GET
VNFM エンドポイント
/vnffm/v1/alarms/{alarmId}
HTTP 要求ヘッダー:
Accept:application/json
個々のアラームの変更
アラームを変更するには、NFVO が AlarmModifications リソースに PATCH 要求を送信する必要があります。
メソッドタイプ:
PATCH
VNFM エンドポイント:
/vnffm/v1/alarms/{alarmId}
HTTP 要求ヘッダー:
Content-Type: application/merge-patch+json
If-Match: ETag value
(注) |
If-Match: はオプションです。指定した場合、その値は VNF に保存された ETag 値に対して検証されます(1 つの VNF クエリから返されます)。 |
サポートされる属性は ackState で、サポートされる属性値は ACKNOWLEDGE です。他のすべての変更ペイロードは拒否されます。
VNF 障害および負荷アラーム
次のアラームは、ETSI VNF 障害および負荷通知用に作成されます。
-
障害アラーム:ESC は、VFND の VM_ALIVE KPI 設定に基づいて VNF 内のコンピューティングリソースの 1 つが到達不能になると、障害アラームを生成します。詳細については、「VNF 障害および負荷アラーム 」を参照してください。
例:
メソッドタイプ
POST
VNFM エンドポイント
/vnffm/v1/extension/alarms
HTTP 要求ヘッダー
Content-Type:application/json
要求ペイロード:
{ "externalAlarmId" : "26bf1e3d-cefa-4f59-88ea-210a29358a5c", #generated value "alarmSource" : "MONA", #hard-coded "managedObjectId" : "08733ef2-319b-46ce-9d8d-95730306bd1a", #external_deployment_id "rootCauseFaultyResource" : "chrimann-dep_g1_0_212da327-0573-421b-ae37-057f6b1a6aef", #vm_name "alarmRaisedTime" : "$timestamp", #generated value "ackState" : "UNACKNOWLEDGED", #hard-coded "perceivedSeverity" : "CRITICAL", #hard-coded "eventTime" : "2018-05-08T00:59:32.571+00:00", #do we have the eventTime? "eventType" : "EQUIPMENT_ALARM", #hard-coded "faultType" : "COMPUTE", #hard-coded "probableCause" : "VM_MANUAL_RECOVERY_NEEDED", #event_name "isRootCause" : "TRUE", #hard-coded "links" : { "objectInstance" : "{http_scheme}://{api_root}/vnflcm/v1/vnf_instances/08733ef2-319b-46ce-9d8d-95730306bd1a" } }
-
負荷アラーム:ESCは、VFND の関連 KPI 設定に基づいて、VNF 内のコンピューティングリソースの 1 つが過負荷または過小負荷になると、負荷アラームを生成します。ESC は、NFVO から通知を受信した後にこれらのアラームを作成します。詳細については、「VNF 障害および負荷アラーム 」を参照してください。
例:
メソッドタイプ
POST
VNFM エンドポイント
/vnffm/v1/extension/alarms
HTTP 要求ヘッダー
Content-Type:application/json
要求ペイロード
アラーム拡張
ETSI は、サードパーティツールとやり取りするアラームの拡張機能を提供します。アラームを作成するには、POST 要求を送信する必要があります。
メソッドタイプ
POST
VNFM エンドポイント
/vnffm/v1/extension/alarms
HTTP 要求ヘッダー
Content-Type:application/json
要求ペイロード
[admin@davwebst-esc-4-2-0-49-keep ETSI]$ cat CreateAlarm.json
{
"id": "alm87032",
"externalAlarmId": "ext-id-xx11214",
"managedObjectId": "930fb087-c1b9-4660-bec8-2a8d97dc1df5",
"rootCauseFaultyResource": {
"id": "fres7629",
"faultyResource": {
"resourceId": "res7727"
},
"faultyResourceType": "NETWORK"
},
"alarmRaisedTime": "2018-05-30T13:55:15.645000+00",
"ackState": "UNACKNOWLEDGED",
"perceivedSeverity": "MAJOR",
"eventTime": "2018-05-30T13:55:15.645000+00",
"eventType": "ENVIRONMENTAL_ALARM",
"probableCause": "Server room overheating",
"isRootCause": "false",
"vnfInstanceIds": [
"res-a3023a03-fc73-430a-a983-5e9439011e45"
}