内容

概要

前提条件

要件

使用するコンポーネント

背景説明

コンテキストサービスステータス

サービスアビリティのコンテキストサービスステータス

APIからのコンテキストサービスステータス

SocialMinerのコンテキストサービスステータス

概要

この記事では、Unified Contact Center Express(UCCX)およびSocialMiner(SM)のCSコンポーネントのステータスを確認するために、Context Service(CS)のステータスと可能なオプションを特定する方法について説明します。

著者：Cisco TACエンジニア、シスコエンジニアリングおよびデレク・ジョンソン

前提条件

要件

次の項目に関する知識があることが推奨されます。

- UCCX Administration

- SocialMiner管理

- コンテキストサービス

使用するコンポーネント

このドキュメントの情報は、次のソフトウェアのバージョンに基づいています。

- UCCX 11.6

- SocialMiner 11.6

注：SocialMinerはオプションのコンポーネントであり、Context Serviceには必要ありません。

このドキュメントの情報は、特定のラボ環境にあるデバイスに基づいて作成されました。このドキュメントで使用するすべてのデバイスは、初期（デフォルト）設定の状態から起動しています。本稼働中のネットワークでは、各コマンドによって起こる可能性がある影響を十分確認してください。

背景説明

Context Serviceは、顧客データをクラウドに保存し、UCCXソリューションのエージェントがクラウドからデータを保存して使用できるようにします。

コンテキストサービスステータス

サービスアビリティのコンテキストサービスステータス

CSのステータスは、[Unified CCX Serviceability]ページで確認できます。最初に、[Tools]、[Context Service Status]の順に選択します。

次の表に、このコンテキストサービスステータスインターフェイスに表示されるさまざまな値を示します。

フィールド

値

コンポーネント

特定のCSコンポーネントの名前が表示されます。UCCX/SocialMiner/Finesse

都道府県

送信します。CSが登録されていません。CSが登録されていない

不明：コンポーネントに到達できないか、ダウンしている場合に表示されます。問題が発生したため、コンポーネントが停止しました。コンポーネントを再初期化するには、[action]フィールドの下の[initialize]ボタンを使用します。

ステータス

オンライン：CSが登録されている場合に表示されます:CSが登録されていない場合、またはプロキシがReady-to-registerに設定されていない場合に表示されます。プロキシまたは外部接続が設定されると表示される

モード

実習:このモードは、Context Service Production(CRS)のテスト、開発、デバッグに使用されます。このモードは、アプリケーションNAにContext Serviceをデプロイする場合に使用されます。状態が未登録または不明の場合に表示されます

モードは、ラボと実稼働の間で切り替えることができます。最初に[システム]を選択し、[システムパラメータ]

ステータス[No Connectivity]は、プロキシが設定されていない、誤ったプロキシが設定されている、またはUCCXシステムからインターネットに接続できない場合に表示されます。CSでは、UCCXにパブリックインターネット接続が必要です。次の図は、UCCXシステムに外部接続がない場合のステータスの例を示しています。

httpプロキシの設定後、すべてのコンポーネントのステータスが登録準備完了に変わります。これは、システムにUCCXから外部接続が正しく設定されたことを示します。次の図は、パブリックインターネット接続が使用可能な場合のシステムのステータスを示しています。

Finesse Administrationページで[Register]を選択し、CSを登録します。次の図は、状態とステータスが登録済みとオンラインに変更されたことを示しています。

APIからのコンテキストサービスステータス

各CSコンポーネントのステータスの詳細な要約を取得するために、UCCX 11.6はJava Application Programming Interface(API)を提供しています。 このAPIは、コネクタのgetstatusメソッドを呼び出して、各コンポーネントの詳細を提供するJavaScript Object Notation (JSON)応答を返します。[CS serviceability]ページの[Export]オプションをクリックし、JSON応答ファイルをダウンロードします。次の図は、[エクスポート]オプションの場所を示しています。

CSがオフラインの場合にUCCXコンポーネントに返されるJSON応答の例を次に示します。

UCCX:uccx116j1.cisco.com = {"status":{"overallStatus":"OFFLINE","successfulUpgradeCount":0,"failureUpgradeCount":0},

"config":{"staticSdkVersion":"2.0.3","extensionSdkVersion":"2.0.3-10673","state":"UNREGISTERED"},

"services":[{"name":"ccfs","url":"ccfs.ciscoccservice.com","ping":{"status":"NOT_REACHABLE","latency":0}}],

"timeStamp":"2017-08-07T06:19:32.500Z"}

次の表に、JSON応答のフィールドに表示される値を示します。

セクション

フィールド

値

ステータス

overallStatus

ONLINE – 接続データセットがあり、コネクタが登録されている場合（設定状態を参照）

オフライン – 接続データがないか、コネクタが登録されていません

config

state

UNREGISTERED：初期化前の初期状態

REGISTERED – 正常に登録されました(init()メソッドの呼び出しによる)

STOPPED – 接続が破棄されます(destroy()メソッドの呼び出しによって)

サービス

ping.status

ping REST APIコールへのHTTP応答ステータスコード

サービス

state

初期化 – KMSが初期化されました

初期化されていません – KMSが初期化されていません

これは、すべてのコンポーネントが登録され、ステータスがONLINEである場合のJSON出力の例です。このサンプルは、CSが無効なステータスを示す問題がある場合に比較するために参照できます。

FMC:uccx116j1.cisco.com = {"status":{"overallStatus":"ONLINE","successfulUpgradeCount":1,"failureUpgradeCount":0},"config":{"appType":"ccx","orgId":"4a6ac8c5-66f5-42b9-8245-7af90eeac12c","uuid":"d86a8f22-c918-4648-9a07-5fe55728b990","staticSdkVersion":"2.0.3","extensionSdkVersion":"2.0.4-10710","proxy":"http://proxy-wsa.esl.cisco.com:80","type":"cs_mgmt","state":"REGISTERED"},"services":[{"name":"fms","url":"hercules-a.wbx2.com","lastSuccessfulHeartBeatTime":"2017-08-07 22:24:31.942","ping":{"status":"200","latency":2031}}],"timeStamp":"2017-08-07T16:54:54.118Z"}

UCCX:uccx116j1.cisco.com = {"status":{"overallStatus":"ONLINE","successfulUpgradeCount":1,"failureUpgradeCount":0},"config":{"appType":"ccx","orgId":"4a6ac8c5-66f5-42b9-8245-7af90eeac12c","uuid":"d86a8f22-c918-4648-9a07-5fe55728b990","staticSdkVersion":"2.0.3","extensionSdkVersion":"2.0.4-10710","proxy":"http://proxy-wsa.esl.cisco.com:80","enabledFeatures":[{"name":"KMS_ENCRYPTION_KEY"}],"type":"cs_context","state":"REGISTERED","labMode":false,"requestTimeout":5000,"tcpTimeout":10000,"maxRetries":1,"cluster":{"clusterId":"4750a37e-2a5a-4825-a301-30252c100288","clusterName":"ccx-context-15DBD8FE18B"}},"services":[{"name":"kms","url":"encryption-a.wbx2.com","ping":{"status":"200","latency":1196},"state":"INITIALIZED"},{"name":"fms","url":"hercules-a.wbx2.com","lastSuccessfulHeartBeatTime":"2017-08-07 22:24:46.016","ping":{"status":"200","latency":1059}},{"name":"ci","url":"idbroker.webex.com","ping":{"status":"200","latency":1092}},{"name":"context","url":"context-service.produs1.ciscoccservice.com","ping":{"status":"200","latency":1185}},{"name":"dictionary","url":"dictionary.produs1.ciscoccservice.com","ping":{"status":"200","latency":1180}},{"name":"ccfs","url":"ccfs.ciscoccservice.com","ping":{"status":"200","latency":1170}},{"name":"discovery","url":"discovery1.produs.ciscoccservice.com","ping":{"status":"200","latency":1214}}],"timeStamp":"2017-08-07T16:55:01.528Z"}

UCCX:uccx116j2.cisco.com = {"status":{"overallStatus":"ONLINE","successfulUpgradeCount":1,"failureUpgradeCount":0},"config":{"appType":"ccx","orgId":"4a6ac8c5-66f5-42b9-8245-7af90eeac12c","uuid":"d86a8f22-c918-4648-9a07-5fe55728b990","staticSdkVersion":"2.0.3","extensionSdkVersion":"2.0.4-10710","proxy":"http://proxy-wsa.esl.cisco.com:80","enabledFeatures":[{"name":"KMS_ENCRYPTION_KEY"}],"type":"cs_context","state":"REGISTERED","labMode":false,"requestTimeout":5000,"tcpTimeout":10000,"maxRetries":1,"cluster":{"clusterId":"4750a37e-2a5a-4825-a301-30252c100288","clusterName":"ccx-context-15DBD8FE18B"}},"services":[{"name":"kms","url":"encryption-a.wbx2.com","ping":{"status":"200","latency":1290},"state":"INITIALIZED"},{"name":"fms","url":"hercules-a.wbx2.com","lastSuccessfulHeartBeatTime":"2017-08-07 22:24:50.224","ping":{"status":"200","latency":1121}},{"name":"ci","url":"idbroker.webex.com","ping":{"status":"200","latency":1067}},{"name":"context","url":"context-service.produs1.ciscoccservice.com","ping":{"status":"200","latency":1168}},{"name":"dictionary","url":"dictionary.produs1.ciscoccservice.com","ping":{"status":"200","latency":1225}},{"name":"ccfs","url":"ccfs.ciscoccservice.com","ping":{"status":"200","latency":1230}},{"name":"discovery","url":"discovery1.produs.ciscoccservice.com","ping":{"status":"200","latency":1166}}],"timeStamp":"2017-08-07T16:55:01.582Z"}

SocialMiner:sm116.aru.com = {"status":{"overallStatus":"ONLINE","successfulUpgradeCount":1,"failureUpgradeCount":0},"config":{"appType":"ccx","orgId":"4a6ac8c5-66f5-42b9-8245-7af90eeac12c","uuid":"d86a8f22-c918-4648-9a07-5fe55728b990","staticSdkVersion":"2.0.3","extensionSdkVersion":"2.0.4-10710","proxy":"http://proxy-wsa.esl.cisco.com:80","enabledFeatures":[{"name":"KMS_ENCRYPTION_KEY"}],"type":"cs_context","state":"REGISTERED","labMode":false,"requestTimeout":5000,"tcpTimeout":10000,"maxRetries":1,"cluster":{"clusterId":"4750a37e-2a5a-4825-a301-30252c100288","clusterName":"ccx-context-15DBD8FE18B"}},"services":[{"name":"kms","url":"encryption-a.wbx2.com","ping":{"status":"200","latency":1254},"state":"INITIALIZED"},{"name":"fms","url":"hercules-a.wbx2.com","lastSuccessfulHeartBeatTime":"2017-08-07 22:24:39.628","ping":{"status":"200","latency":1127}},{"name":"ci","url":"idbroker.webex.com","ping":{"status":"200","latency":1028}},{"name":"context","url":"context-service.produs1.ciscoccservice.com","ping":{"status":"200","latency":1175}},{"name":"dictionary","url":"dictionary.produs1.ciscoccservice.com","ping":{"status":"200","latency":1174}},{"name":"ccfs","url":"ccfs.ciscoccservice.com","ping":{"status":"200","latency":1128}},{"name":"discovery","url":"discovery1.produs.ciscoccservice.com","ping":{"status":"200","latency":1179}}],"timeStamp":"2017-08-07T16:55:01.589Z"}

Finesse:uccx116j1.cisco.com = {"status":{"overallStatus":"ONLINE","successfulUpgradeCount":1,"failureUpgradeCount":0},"config":{"appType":"ccx","orgId":"4a6ac8c5-66f5-42b9-8245-7af90eeac12c","uuid":"d86a8f22-c918-4648-9a07-5fe55728b990","staticSdkVersion":"2.0.3","extensionSdkVersion":"2.0.4-10710","proxy":"http:\/\/proxy-wsa.esl.cisco.com:80","enabledFeatures":[{"name":"KMS_ENCRYPTION_KEY"}],"type":"cs_context","state":"REGISTERED","labMode":false,"requestTimeout":5000,"tcpTimeout":10000,"maxRetries":1,"cluster":{"clusterId":"4750a37e-2a5a-4825-a301-30252c100288","clusterName":"ccx-context-15DBD8FE18B"}},"services":[{"name":"kms","url":"encryption-a.wbx2.com","ping":{"status":"200","latency":1123},"state":"INITIALIZED"},{"name":"fms","url":"hercules-a.wbx2.com","lastSuccessfulHeartBeatTime":"2017-08-07 22:24:52.328","ping":{"status":"200","latency":1149}},{"name":"ci","url":"idbroker.webex.com","ping":{"status":"200","latency":1085}},{"name":"context","url":"context-service.produs1.ciscoccservice.com","ping":{"status":"200","latency":1168}},{"name":"dictionary","url":"dictionary.produs1.ciscoccservice.com","ping":{"status":"200","latency":1181}},{"name":"ccfs","url":"ccfs.ciscoccservice.com","ping":{"status":"200","latency":1171}},{"name":"discovery","url":"discovery1.produs.ciscoccservice.com","ping":{"status":"200","latency":1136}}],"timeStamp":"2017-08-07T16:55:02.099Z"}

Finesse:uccx116j2.cisco.com = {"status":{"overallStatus":"ONLINE","successfulUpgradeCount":1,"failureUpgradeCount":0},"config":{"appType":"ccx","orgId":"4a6ac8c5-66f5-42b9-8245-7af90eeac12c","uuid":"d86a8f22-c918-4648-9a07-5fe55728b990","staticSdkVersion":"2.0.3","extensionSdkVersion":"2.0.4-10710","proxy":"http:\/\/proxy-wsa.esl.cisco.com:80","enabledFeatures":[{"name":"KMS_ENCRYPTION_KEY"}],"type":"cs_context","state":"REGISTERED","labMode":false,"requestTimeout":5000,"tcpTimeout":10000,"maxRetries":1,"cluster":{"clusterId":"4750a37e-2a5a-4825-a301-30252c100288","clusterName":"ccx-context-15DBD8FE18B"}},"services":[{"name":"kms","url":"encryption-a.wbx2.com","ping":{"status":"200","latency":1196},"state":"INITIALIZED"},{"name":"fms","url":"hercules-a.wbx2.com","lastSuccessfulHeartBeatTime":"2017-08-07 22:24:51.027","ping":{"status":"200","latency":1210}},{"name":"ci","url":"idbroker.webex.com","ping":{"status":"200","latency":1032}},{"name":"context","url":"context-service.produs1.ciscoccservice.com","ping":{"status":"200","latency":1168}},{"name":"dictionary","url":"dictionary.produs1.ciscoccservice.com","ping":{"status":"200","latency":1189}},{"name":"ccfs","url":"ccfs.ciscoccservice.com","ping":{"status":"200","latency":1207}},{"name":"discovery","url":"discovery1.produs.ciscoccservice.com","ping":{"status":"200","latency":1251}}],"timeStamp":"2017-08-07T16:55:02.457Z"}

このJSON出力は、コネクタが初期化されたときに行われ、次の情報が含まれます。

- 全体的なステータス（コネクタのステータスに基づいて現在決定）

- 静的および拡張（ソフトウェア開発キット）SDK jarバージョン

- 現在の状態のコネクタタイプ

- 現在のセキュアチャネルの状態（アクティブ、未初期化、エラー）（可能な場合）

- アップグレード数

- アップグレードステータス

- 最後のハートビートタイムスタンプ

- サービスURL

- プロキシが設定されている場合のプロキシ情報

- 設定オブジェクト（可能な場合）

- さまざまなコアサービスへの接続ステータス

SocialMinerのコンテキストサービスステータス

SocialMiner(SM)11.6でAPIが導入され、SMとのコンテキストサービス統合ステータスが示されます。ブラウザを使用してSocialMinerサーバ上のこの場所に移動します。 <SM-IP>:<port>/ccp-webapp/ccp/serviceability/contextServiceStatus

CS登録後のSocialMinerからの出力例を次に示します。

{"status":{"overallStatus":"ONLINE","successfulUpgradeCount":1,"failureUpgradeCount":0},"config":{"appType":"ccx","orgId":"4a6ac8c5-66f5-42b9-8245-7af90eeac12c","uuid":"0ff304fa-7ce6-470d-9fcb-f83266a06f35","staticSdkVersion":"2.0.3","extensionSdkVersion":"2.0.4-10710","proxy":"http://proxy-wsa.esl.cisco.com:80","enabledFeatures":[{"name":"KMS_ENCRYPTION_KEY"}],"type":"cs_context","state":"REGISTERED","labMode":false,"requestTimeout":5000,"tcpTimeout":10000,"maxRetries":1,"cluster":{"clusterId":"065cce61-79de-4173-87f3-fd6fff30da11","clusterName":"ccx-context-15DC0905FC4"}},"services":[{"name":"kms","url":"encryption-a.wbx2.com","ping":{"status":"200","latency":1132},"state":"INITIALIZED"},{"name":"fms","url":"hercules-a.wbx2.com","lastSuccessfulHeartBeatTime":"2017-08-10 13:40:36.905","ping":{"status":"200","latency":1236}},{"name":"ci","url":"idbroker.webex.com","ping":{"status":"200","latency":975}},{"name":"context","url":"context-service.produs1.ciscoccservice.com","ping":{"status":"200","latency":1273}},{"name":"dictionary","url":"dictionary.produs1.ciscoccservice.com","ping":{"status":"200","latency":1228}},{"name":"ccfs","url":"ccfs.ciscoccservice.com","ping":{"status":"200","latency":1500}},{"name":"discovery","url":"discovery1.produs.ciscoccservice.com","ping":{"status":"200","latency":1191}}],"timeStamp":"2017-08-10T08:10:43.983Z"}

Context Serviceが登録され、SMが有効な属性との接続を確立できる場合、このAPIの応答には値「ONLINE」の属性「overallStatus」が含まれます。

Context Serviceが有効になっていないか、SMが接続の確立に失敗した場合、属性overallStatusにはONLINE以外の値があります。

CSがSMに登録されていない場合の応答の例を次に示します。

{"status":{"overallStatus":"OFFLINE","successfulUpgradeCount":2,"failureUpgradeCount":0},"config":{"staticSdkVersion":"2.0.3","extensionSdkVersion":"2.0.4-10712","proxy":"http://proxy-wsa.esl.cisco.com:80","state":"STOPPED"},"services":[],"timeStamp":"2017-08-11T06:11:38.086Z"}

これで、Context Serviceのステータスを特定する手順は終了です。