ボッシュ接続が Finesse Agent Desktop 存在のためにどのようにはたらくか

概要

この資料に、そしてこれへの関する問題が診断することができるかどのように同期 HTTP （ボッシュ）上の双方向ストリームを使用する Finesse 接続の後ろのアーキテクチャ記述されています。

ボッシュとは何か。

拡張可能なメッセージングおよび存在プロトコル（XMPP）はクライアント/サーバモデルのステートフルプロトコルです。 アプリケーションが XMPP を使用する必要がある場合 mutliple 問題は起こります。 ブラウザはブラウザの中で動作する XMPP を元々サポートしません、従ってすべての XMPP トラフィックはプログラムによって処理する必要があります。 

最初の問題は HTTP がステートレス プロトコルであることです。 これは各 HTTP 要求が他のどの要求と関連していないことを意味します。 ただし、この問題は applicative によって意味します当たることができます--たとえばクッキー/ポスト データの使用によって。

第 2 問題は HTTP の単方向動作です。 クライアントだけ要求を送信 し、サーバは応答ただできます。 データを押すサーバの不可能は HTTP 上の XMPP を設定することを不自然にします。

この問題はクライアントが直接 TCP 要求をすることができる場合除去され（従って HTTP の必要を省きます）。 ただし（たとえば JavaScript が HTTP 要求を送信できるので） HTTP ドメイン内の問題を提起したいと思えば、2 つの可能な解決策があります。 両方とも HTTP と XMPP 間のブリッジを必要とします。 ソリューションは（新しいデータを頼む繰り返された HTTP 要求）および長いポーリング、別名ボッシュ ポーリングしています。

ボッシュを使用する目的はすぐに要求があるのでサーバが応答する必要がないというファクトを隠すことです。 応答はサーバにクライアントのためのデータがある、およびそれから応答として送信 されますまで遅れます（長いポーリング）。 クライアントがそれを得るとすぐ彼は New 要求を（彼は送信 することを何もなくても）等します。

ボッシュはサーバ負荷観点からかなり効率的、トラフィック的にです。

Finesse デスクトップ クライアント（Webアプリケーション）は 30 秒毎に古いボッシュ接続を確立します。 30 秒後に、Finesse Notificaiton サービスから更新がなければ、通知サービスは 200 OK および（ほぼ）空応答本体との HTTP 応答を返します。 通知サービスにエージェントの存在のアップデートがあるかまたはダイアログ（コール）イベント、たとえば、データは Finesse Web クライエントにすぐに送信 されます。

まとめ

1. Finesse Web クライエントに TCPポート 7443 によって設定された Finesse サーバへの古い HTTP 接続（http バインド）が常にあります。 これはボッシュ長いポーリングとして知られています。
   
   
2. Finesse 通知サービスはエージェント、コール、先祖などの状態に関する更新を掲示する存在サービスです
   
   
3. Notiication サービスにアップデートがある場合、HTTP 応答本体の XML メッセージとして状態アップデートの http バインド要求に答えます。
   
   
4. あれば状態は http バインド要求を受け取った後 30 秒をアップデートしません Finesse Web クライエントが別の http バインド要求を送信 するように、Notificaiton サービスは状態更新なしで答えます。 これは通知サービス Finesse Web クライエントが通知サービスに接続まだできること、そしてエージェントがブラウザを閉じなかったし、またはスリープの状態であるためにコンピュータを置かなかったことを確認する先祖などのための方法として動作します

また、Finesse Web クライエントはイメージに示すようにチェックが毎分 Tomcat ステータスをうまく解決する SystemInfo 要求を送信 します:

イメージに示すように、通知サービス（発砲して下さい）デバッグ ログはエージェント PC の IP アドレスおよびポートと共にデスクトップの http バインディングを示します。

イメージに示すように、最後のアクティブは 0 ms セッションがまだアクティブであることを示します。

イメージに示すように Unified Contact Center Express （UCCX）の有効通知サービス デバッグ ログ、:

イメージに示すように Unified Contact Center Enterprise （UCCE） （スタンドアロン Finesse）の有効通知サービス デバッグ ログ、:

ボッシュ接続解除によるよくある 問題

UCCX に関しては、ログアウト タイマーは 60 秒後ブラウザ 接続解除でした。 エージェントはログアウトのための準備ができたのかない READY 状態に起こることある場合もあります。

UCCE に関しては、Finesse は 120 秒程またはブラウザが閉じるか、Finesse が CTI サーバへ強制 Logout 要求を送信 する前に 60 秒をクラッシュし、エージェントがブラウザを待っているとき検出するためにかかります。 このような状況の下で、Finesse は 180 秒程エージェントに署名するためにかかることができます。

UCCE Finesse デスクトップ動作に関する詳細については、Cisco Finesse 管理 ガイドの Cisco Finesse フェールオーバー メカニズム章のデスクトップ動作 セクションを参照して下さい。

Log Analysis

Finesse および Notificaiton サービス ログは RTMT または CLI によって集めることができます:

ファイルは activelog /desktop を圧縮繰り返します得ます

デバッグ ログ 

これらのログは /desktop/logs/openfire フォルダにあり、debug.log と指名されます。

2017.06.17 00:14:34 Session (id=f382a015) was last active 0 ms ago: 1001003@xxxxx.xxxx.xxx.cisco.com/desktop
2017.06.17 00:15:04 Session (id=f382a015) was last active 13230 ms ago: 1001003@xxxxx.xxxx.xxx.cisco.com/desktop 
2017.06.17 00:15:34 Session (id=f382a015) was last active 43230 ms ago: 1001003@xxxxx.xxxx.xxx.cisco.com/desktop
2017.06.17 00:16:04 Session (id=f382a015) was last active 63231 ms ago: 1001003@xxxxx.xxxx.xxx.cisco.com/desktop
 
2017.06.17 00:17:04 Unable to route packet. No session is available so store offline. <message from="pubsub. xxxxx.xxxx.xxx.cisco. com" to="1001003@xxxxx.xxxx.xxx.cisco.com.cisco.com" id="/finesse/api/User/1001003__1001003@xxxxx.xxxx.xxx.cisco.com__o5Aqb"><event xmlns="http://jabber.org/protocol/pubsub#event"><items node="/finesse/api/User/1001003"><item id="0d78a283-466d-4477-a07e-6e33a856fce388"><notification xmlns="http://jabber.org/protocol/pubsub">&lt;Update&gt
 

情報ログ

これらのログは /desktop/logs/openfire フォルダにあり、info.log と指名されます。

2017.06.17 00:16:04 Closing idle session (id=f382a015): 1001003@xxxxx.xxxx.xxx. cisco.com/desktop after being inactive for more than threshold value of 60
2017.06.17 00:16:04 A session is being closed for 1001003@xxxxx.xxxx.xxx. cisco.com/desktop

エージェントがログアウト 1 最小値を誘発し、これがレポートの理由コード 255 として現われることをアイドル状態のセッションを閉じる Openfire 示します

Webservices ログ

これらのログは /desktop/logs/webservices フォルダにあり、Desktop-webservices.YYYY-MM-DDTHH-MM-SS.sss.log と指名されます。

0000001043: XX.XX.XX.XXX: Jun 17 2017 00:16:04.630 +0530: %CCBU_Smack Listener Processor (1)-6-PRESENCE_NOTIFICATION_RECIEVED: %[FROM JID=1001003@xxxxx.xxxx.xxx.cisco.com/desktop][PRESENCE_TYPE=unavailable]:Finesse received a presence notifcation
0000000417: XX.XX.XX.XXX: Jun 17 2017 00:16:04.631 +0530: %CCBU_Smack Listener Processor (1)-6-UNSUBSCRIBE_REQUEST_SUCCESS: %[NodeId=/finesse/api/User/1001003/ClientLog][user_id=1001003@xxxxx.xxxx.xxx.cisco.com]: Sucessfully unsubscribed from a node on the XMPP server
0000001044: XX.XX.XX.XXX:  Jun 17 2017 00:16:04.631 +0530: %CCBU_Smack Listener Processor (1)-6-AGENT_PRESENCE_MONITOR: %[message_string=Adding agent 1001003 into the expiry hash.]:  
0000001051: XX.XX.XX.XXX:  Jun 17 2017 00:16:35.384 +0530: %CCBU_pool-8-thread-1-6-AGENT_PRESENCE_MONITOR: %[message_string=[Expired] Removed agent from cache 1001003]: 
0000001060: XX.XX.XX.XXX:: Jun 17 2017 00:17:04.632 +0530: %CCBU_CoreImpl-worker12-6-PRESENCE DRIVEN LOGOUT: %[agent_id=1001003]: Performing CTI Logout on basis of the agents unavailable presence
0000001061: XX.XX.XX.XXX:: Jun 17 2017 00:17:04.633 +0530: %CCBU_CoreImpl-worker12-6-MESSAGE_TO_CTI_SERVER: %[cti_message=Invoke id :39 , agentstate : 1, workmode : 0, reason code: 255, forceflag :1, agentcapacity: 1, agentext: 1001003, agentid: 1001003, supervisorid: null, ssoFlag=false][cti_message_name=SetAgentStateReq]: Message going to the backend cti server
0000001066:  XX.XX.XX.XXX:: Jun 17 2017 00:17:04.643 +0530: %CCBU_CTIMessageEventExecutor-0-6-DECODED_MESSAGE_FROM_CTI_SERVER: %[cti_message=CTIAgentStateEvent [skillGroupState=1 (LOGOUT), stateDuration=0, skillGroupNumber=-1, skillGroupPriority=0, agentState=1 (LOGOUT), eventReasonCode=255, numFltSkillGroups=0, CTIClientSignature=null, agentID=1001003, agentExtension=1001003, agentInstrument=null, agentID_Long=1001003, duration=null, nextAgentState=null, fltSkillGroupNumberList=[], fltSkillGroupIDList=[], fltSkillGroupPriorityList=[], fltSkillGroupStateList=[], MRDId=1, agentMode=0]CTIMessageBean [invokeID=null, cti_sequence_id=105, msgID=30, timeTracker={"id":"AgentStateEvent","CTI_MSG_RECEIVED":1497638824642,"CTI_MSG_DISPATCH":1497638824643}, msgName=AgentStateEvent, deploymentType=CCX]][cti_response_time=1][dispatch_phase=DnD-CHECKPOINT-3B]: Decoded Message to Finesse from backend cti server

ボッシュ接続解除のための一般的な原因 

• ネットワークの問題
  
  
• サポートされていないブラウザやバージョン。
  
  
• Other タブ/ウィンドウの満足すること原因でブラウザ スタックした状態。
  
  
• スリープの状態であるために置かれるコンピュータ。
  
  
• サーバの高い CPU またはハイ メモリ問題。
  
  
• バックグラウンドの偽りアクティビティをするサード パーティ小道具。
  
  
• Finesse サーバの接続を失う CTI Server/CCX エンジン。
  
  
• サーバまたはクライアントの NTP 問題。

提案操作

• ガイドによってサポート された ブラウザ/バージョンおよび設定を使用して下さい。
  
  
• 取除かれるすべてのサード パーティ小道具との動作をテストして下さい。
  
  
• エージェント 動作および作業の流 れを理解して下さい。
  
  
• Cisco Finesse Tomcat および通知サービスを再開して下さい。
  
  
• utils を診断し、サーバのテストを、順方向に検証し、サーバおよびクライアント両方からのリバース DNS ルックアップ実行して下さい。
  
  
• サーバの utils NTP ステータスをチェックして下さい。
  
  
• クライアント ログでは、ドリフトおよびネットワーク待ち時間をチェックして下さい。 クライアント ログはブラウザ Webコンソール ログからまたは Finesse ページの Send エラー レポートを押し、Finesse ログを集めることによって表示される場合があります。 ログは /desktop/logs/clientlogs にあります。

注: タイマー値は製品要件によって未来に変更するかもしれません。