SigmaSystemCenterのイベントを外部の製品や、サービスに通知する方法について、説明します。
イベントログを収集・解析が可能な製品により、SigmaSystemCenterがイベントログに出力するイベントの情報を収集することが可能です。
SigmaSystemCenterのイベントログ出力の動作については、「2.2.6. イベントログ出力、メール通報、イベントの外部通知(webhook)」を参照してください。
SigmaSystemCenterでは、「webhook」の機能を利用して、受信したイベントや実行ジョブの情報を外部サービスへ通知することができます。
この機能により、SigmaSystemCenterが受信した管理対象、および管理連携製品から通知されたイベントを、他のサービスに通知する事が可能です。
イベントの通知は、Webサービスに対するPOSTメソッド実行により通知します。
この通知方式は、一般的に「webhook」と呼ばれます。
通知先の情報をSigmaSystemCenterに登録することで、イベントの通知が行われるようになります。
通知先の情報の設定は、ssc eventdeliveryコマンドで行います。「sscコマンドリファレンス」を参照してください。
以下の条件を満たすWebサービスをイベント通知先として登録することができます。
WebAPI(POSTメソッド)を提供できるWebサービス
イベントの外部通知機能では、以下の情報を通知します。
管理対象から通知されるイベント全般
ジョブの開始/完了
イベントに関しては、「2.2.2. ポリシー制御の対象イベントについて」を参照してください。
イベント通知のタイミングや条件の詳細については、「2.2.6. イベントログ出力、メール通報、イベントの外部通知(webhook)」を参照してください。
イベントの外部通知機能では、通知する情報をJson形式で通知します。
また、Json形式で通知する情報の内容に関しては、cloudevents v0.2に準拠しています。
認証方式は、「認証なし」、または「HMAC-SHA256」をサポートします。
cloudeventsの詳細に関しては、「https://cloudevents.io/」を参照してください。
イベントの外部通知(webhook)の詳細に関しては、「SigmaSystemCenter Web API リファレンス」を参照してください。
以下が、通知情報のサンプルです。
イベント
{
"Records": [
{
"contenttype": "application/json",
"data": {
"EventNumber": "RE14456",
"AcceptDate": "2019-06-08T11:16:21.56509+09:00",
"AlertType": "Other",
"Category": "Unknown",
"EventId": "ILO[0X800017D2]",
"EventLevel": "警告",
"Message": "[Target]192.168.5.100 [Source]iLO [ID]0x800017D2(6098) [Summary]NVDIMMエラー - 初期化エラー",
"Owner": "ESMPRO",
"Severity": "Unknown",
"TargetGuid": "8a69186f-c8dd-e811-80f6-005056ad0bed",
"TargetIPAddress": null,
"TargetName": "MarinMast",
"TargetType": "PhysicalMachine",
"TargetUuid": "30381c00-d797-11dd-3f10-001697a7fe00",
"Time": "2019/06/08 2:16:21"
},
"id": "e50e2539-80fa-4833-95e2-4cf493821abf",
"source": "http://<HostName>/Provisioning/Default.aspx?type=machine&id=9ce0c8d2-4786-e911-b36f-005056addbd9",
"specversion": "0.2",
"time": "2019-01-08T04:12:58.3907823Z",
"type": "com.nec.jp.ssc.resource"
}
]
}
ジョブの開始/完了
{
"Records": [
{
"contenttype": "application/json",
"data": {
"EventNumber": "SY14452",
"JobId": "00760",
"Result": "Success"
},
"id": "3fc34cb9-9ddc-432f-aab7-731ba622e41a",
"source": "http://<HostName>/Provisioning/Default.aspx?type=event&id=SY14452",
"specversion": "0.2",
"time": "2019-01-08T04:12:05.4369826Z",
"type": "com.nec.jp.ssc.job.end"
}
]
}
SigmaSystemCenterのWeb APIを利用可能であれば、リソースイベント一覧取得APIを使用して、外部からSigmaSystemCenterが受信したイベントの情報を取得するように、作り込むことが可能です。
リソースイベント一覧取得APIの詳細について、「SigmaSystemCenter Web API リファレンス」の「2.85.リソースイベント一覧取得API」を参照してください。