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 v2.0に準拠しています。
認証方式は、「認証なし」または「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」を参照してください。