Cisco MediaSense 開発者ガイド リリース 11.0(1)
トリガーされるイベント
トリガーされるイベント

トリガーされるイベント

sessionEvent

このイベントは、新しい録音セッションが開始されるか、既存の録音セッションが更新または終了されるたびに送信されます。 また、録音セッションが削除されるか、切り取られる場合にも送信されます。 削除されたり、切り取られたりしたセッションでは、セッションが 1 つのイベントでバッチ処理され、送信されます。

方式

POST

本体

JSON

{
    "eventType": "SESSION_EVENT",
    "eventAction": "DELETED",
    "forwardedEvent": "TRUE",
    "eventBody": {
        "sessionIds": ["Session-6-10.194.118.57-1284096640651",
        "Session-6-10.194.118.57-1284096640652"]
    }
}
{
    "eventAction": "STARTED",
    "eventBody": {
        "sessionId": "Session-6-10.194.118.57-1284096640651",
        "callControllerType": "Cisco-CUCM",
        "callControllerIP": "10.194.118.57"
        "ccid": "2728850048-0000065536-0000018373",
        "sessionStartDate": 1284096641174,
        "sessionState": "ACTIVE",
       "tracks": [
                    {
                        "trackStartDate": 1429519331647,
                        "trackDuration": 14252,
                        "codec": "PCMU",
                        "downloadUrl": "https://10.126.135.72:8446/mma/ExportRaw?recording=7814cd5fdf06f1-TRACK1",
                        "trackNumber": 1,
                        "trackMediaType": "AUDIO",
                        "participants": [
                            {
                                "participantStartDate": 1429519331647,
								                        "participantInformation":{
                                     "loginId": "ambdev",
                                     "lastName": "dev",
                                     "firstname": "ambrose",
                                     "loginIdDomain": "1",
                                     "loginName": "ambdev",
                                  },
                                "deviceRef": "11052",
                                "isConference": false,
                                "xRefCi": "29236211",
                                "participantDuration": 14252,
                                "deviceId": "trunk_to_cube150"
                            }
                        ]
                    },
                    {
                        "trackStartDate": 1429519331647,
                        "trackDuration": 14252,
                        "codec": "PCMU",
                        "downloadUrl": "https://10.126.135.72:8446/mma/ExportRaw?recording=7814cd5fdf06f1-TRACK0",
                        "trackNumber": 0,
                        "trackMediaType": "AUDIO",
                        "participants": [
                            {
                                "participantStartDate": 1429519331647,
								                        "participantInformation":{
                                     "loginId": "avmaitra",
                                     "lastName": "maitra",
                                     "firstname": "avirup",
                                     "loginIdDomain": "1",
                                     "loginName": "avmaitra",
                                  },
                                "deviceRef": "11024",
                                "lineDisplayName": "Avirup12",
                                "isConference": false,
                                "xRefCi": "29236210",
                                "participantDuration": 14252,
                                "deviceId": "SEPF0292958FA6D"
                            }
                        ]
                    }
                ],
        "urls": [
            {
                "rtspUrl": "rtsp://10.194.118.57/live/
                 Session-6-10.194.118.57-1284096640651"
            }
        ]
    },
    "eventType": "SESSION_EVENT",
    "forwardedEvent": "TRUE"
}
{
    "eventAction": "ENDED",
    "eventBody": {
        "sessionId": "Session-6-10.194.118.57-1284096640651",
        "callControllerType": "Cisco-CUCM",
        "callControllerIP": "10.194.118.57"
        "ccid": "2728850048-0000065536-0000018373",
        "sessionState": "CLOSED_NORMAL",
        "sessionStartDate": 1284096641174,
        "sessionDuration": 8394,
        "tracks": [
                    {
                        "trackStartDate": 1429519331647,
                        "trackDuration": 14252,
                        "codec": "PCMU",
                        "downloadUrl": "https://10.126.135.72:8446/mma/ExportRaw?recording=7814cd5fdf06f1-TRACK1",
                        "trackNumber": 1,
                        "trackMediaType": "AUDIO",
                        "participants": [
                            {
                                "participantStartDate": 1429519331647,
								                        "participantInformation":{
                                     "loginId": "ambdev",
                                     "lastName": "dev",
                                     "firstname": "ambrose",
                                     "loginIdDomain": "1",
                                     "loginName": "ambdev",
                                  },
                                "deviceRef": "11052",
                                "isConference": false,
                                "xRefCi": "29236211",
                                "participantDuration": 14252,
                                "deviceId": "trunk_to_cube150"
                            }
                        ]
                    },
                    {
                        "trackStartDate": 1429519331647,
                        "trackDuration": 14252,
                        "codec": "PCMU",
                        "downloadUrl": "https://10.126.135.72:8446/mma/ExportRaw?recording=7814cd5fdf06f1-TRACK0",
                        "trackNumber": 0,
                        "trackMediaType": "AUDIO",
                        "participants": [
                            {
                                "participantStartDate": 1429519331647,
								                        "participantInformation":{
                                     "loginId": "avmaitra",
                                     "lastName": "maitra",
                                     "firstname": "avirup",
                                     "loginIdDomain": "1",
                                     "loginName": "avmaitra",
                                  },
                                "deviceRef": "11024",
                                "lineDisplayName": "Avirup12",
                                "isConference": false,
                                "xRefCi": "29236210",
                                "participantDuration": 14252,
                                "deviceId": "SEPF0292958FA6D"
                            }
                        ]
                    }
                ],
        "urls": [
            {
                "rtspUrl": "rtsp://10.194.118.57/archive/
                 Session-6-10.194.118.57-1284096640651"
            }
        ]
    },
    "eventType": "SESSION_EVENT",
    "forwardedEvent": "TRUE"
}

storageThresholdEvent

このイベントは、ストレージのディスク容量(録音されたメディアを保存)が各種しきい値に達するたびに送信されます。 しきい値に関する詳細を次の表に示します。

方式

POST

本体

JSON

{
 "eventType":"STORAGE_THRESHOLD_EVENT",
 "eventAction":"ENTER_LOW_STORAGE_SPACE",
 "forwardedEvent":"TRUE",
 "eventBody": {
                 "nodeId": 1,
                 "nodeIPAddress":"10.X.X.X",
                 "partition" : "/common",
                 "percentageUtilization": 70
               }


 }

イベント アクション値

しきい値の割合とその意味を次の表に示します。

しきい値 ストレージの割合 説明
ENTER_LOW_

STORAGE_SPACE

録音済みメディアのストレージ使用率が 75% の限度を超えました。

ディスク ストレージがスペース不足状態になっていることを示す最初の警告です。

EXIT_LOW_

STORAGE_SPACE

録音メディアの使用率が 70% の限度以下に低下しました。

ディスク ストレージはスペース不足状態から脱出しています。

ENTER_CRITICAL_

STORAGE_SPACE

録音済みメディアのストレージ使用率が 90% の限度を超えました。

2 度目の警告です。 この状態に達した場合、このノード上で将来の録音リソースを保証するための措置を講じる必要があります。 保持優先モードで動作している場合、このしきい値に達すると新しい録音セッションは受け入れられません。 新規録音優先モードでは、新しい録音用の領域を確保するため、古い録音は自動的に切り取られます。

EXIT_CRITICAL_

STORAGE_SPACE

録音メディアの使用率が 85% の限度以下に低下しました。

ディスク ストレージは危機的なスペース状態から脱出しています。 この時点では、ローカル ノードはリソース不足状態と見なされます。

ENTER_EMERGENCY_

STORAGE_SPACE

録音済みメディアのストレージ使用率が 99% の限度を超えました。

最後の警告です。 この状態に達した場合、このノード上で将来の録音リソースを保証するための措置を講じる必要があります。 保持優先モードで稼動している場合、このしきい値に達すると既存の録音セッションが終了します。

EXIT_EMERGENCY_

STORAGE_SPACE

録音メディアの使用率が 97% の限度以下に低下しました。

ディスク ストレージは緊急ストレージ容量状態から脱出しています。 この時点では、ローカル ノードはまだリソース不足状態と見なされ、新しい録音セッションは受け入れられません。

tagEvent

このイベントは、タグがセッションに追加またはセッションから削除された場合に送信されます。 マルチサーバ MediaSense 展開では、クライアントは 1 つの MediaSense API サービスだけにサブスクライブし、他の MediaSense サービスによって生成される通知を受信できます。

方式

POST

本体

JSON

次は、期間が限定された(tagOffset フィールドあり)ユーザ定義タグの例です。 タグが作成された日付は 2010 年 9 月 9 日 23:14:13 GMT です。 Epoch converter を使用すれば、暗号化された日付と時刻を表示できます。 オフセットは、タグが表すセッションの開始からの時間をミリ秒単位で表します。 この例では、5 分を表しています。


(注)  


MediaSense では、USER_DEFINED の期間限定タグに tagOffset 0 (ゼロ値)を使用できません。 期間限定タグを使用して録音を開始する場合とき、少なくとも 1 ミリ秒の tagOffset を使用します。


{
    "eventType": "TAG_EVENT",
    "eventAction": "UPDATED",
    "eventBody":  {
                           "sessionId": "1234abcd5678efgh90xyz",
                           "tagName": "Customer response",
                           "tagType": "USER_DEFINED",
                           "tagCreateDate": 1284074053,
                           "tagOffset": 300000

                  }
}

次は、セッション内のトラックに追加されたシステム定義タグの例です。 トラックは trackNumber で識別されます。

{
    "eventType": "TAG_EVENT",
    "eventAction": "ADDED",
    "eventBody": {
        "sessionId": "57130d87d73f41",
        "tagCreateDate": 1309302169848,
        "tagName": "TrackInactive",
        "tagOffset": 11203,
        "tagType": "SYSTEM_DEFINED",
        "trackNumber": 1
    }
}