トレース機能を強化する場合

はじめに

Cisco Intelligent Contact Management（ICM）Event Management System（EMS）には、ICM プロセスにイベントを報告するために使用するアプリケーション プログラミング インターフェイス（API）があります。このドキュメントでは、Cisco ICM の問題のトラブルシューティングに役立てるために、トレースをオンにする方法について説明します。

前提条件

要件

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

• Cisco ICM

• Microsoft Windows NTバージョン4およびWindows 2000

使用するコンポーネント

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

• Cisco ICM バージョン 4.6.2 以降

• Microsoft Windowsバージョン4およびWindows 2000

このドキュメントの情報は、特定のラボ環境にあるデバイスに基づいて作成されました。このドキュメントで使用するすべてのデバイスは、クリアな（デフォルト）設定で作業を開始しています。対象のネットワークが実稼働中である場合には、どのようなコマンドについても、その潜在的な影響について確実に理解しておく必要があります。

表記法

表記法の詳細については、『シスコ テクニカル ティップスの表記法』を参照してください。

トレース機能の起動

Cisco ICMの問題をドキュメント化するには、APIを使用する方法と、トレースを起動する方法の2通りがあります。

API

APIを使用して、次の操作を行います。

• ローカルEMSログファイルにイベントを記録します。

• Microsoft Windows NT/2000アプリケーションイベントログにイベントを記録します。

• Cisco ICMデータベースに保存するイベントをデータベースサーバに送信します。

• Cisco Technical Assistance Center(TAC)に配送するイベントをセントラルカスタマーサービス転送サービス(CSFS)に送信します。

トレース機能の起動

ICMの問題をトラブルシューティングするには、次のいずれかの手順でトレースを起動できます。

• Microsoft Windows NTまたはWindows 2000レジストリエディタ

• Regacc ユーティリティ

• OPCTest

• rttest

• Procmon

注：終了したら、必ずすべてのトレースをオフにしてください。また、テストが終了した時点で、processコマンドのウィンドウを開いたままにしないでください。これはシステム リソース、特に CPU 使用率とメモリに大きく影響します。

Windows NTまたはWindows 2000レジストリエディタ

regedit32を実行するには、次の手順を実行します。

1. [Start] > [Run] を選択します。

2. regedt32と入力して、Windows NTまたはWindows 2000のレジストリエディタを開きます。

   レジストリエディタとEMS Peripheral Interface Manager(PIM)の設定例を次に示します。これらの設定を表示するには、次のパスに移動します。

   • Cisco ICMバージョン4.6以前：

     Software\geotel\icr\cust_inst\ICRcomponenttype\EMS\CurrentVersion\
       Library\Processes

   • Cisco ICM バージョン 5.0 以降:

     Software\Cisco Systems,Inc.\icm\cust_inst\ICMcomponenttype\EMS\
       CurrentVersion\Library\Processes

   [レジストリエディタ]ウィンドウの左側にキーが表示され、右側に値が表示されていることが理想的です。

3. 変更する値をダブルクリックすると、[DWORDエディタ]ダイアログボックスが表示されます。

4. RadixパネルでHexをクリックします。

5. 値を変更します。

6. [OK] をクリックします。

この表は、レジストリエディタで変更できる値を示しています。変更する最も一般的な値は、AllLogFileMax、LogFileMax、およびTraceMaskです。ログファイルの数は変更できません。

値	パス
EMSAllLogFileMax	プロセスのすべてのEMSログファイルの合計の最大サイズです。デフォルトは6000000/6 MBまたは2000000/2 MBです。
EMSAllLogFileCount	プロセスのEMSログファイルの数。デフォルトは20で、通常は変更する必要はありません。
EMSLogFileMax	各EMSログファイルの最大サイズ。デフォルトは100000または100Kです。
EMSTraceMask	EMSログファイルにより多くのデータを記録するプロセスのトレースビット。デフォルト値は 0 です。
EMSUserData	空白のままにします。procmonでトレースビットを設定すると、このフィールドに値が自動入力されます。
EMSDisplayToScreen	デフォルトは 1.プロセスウィンドウにデータを表示しないようにするには、0に設定します。これにより、CPUへの負荷が軽減され、pcAnywhereへのアクセスが容易になります。

トラブルシューティングのためにトレースを増やす必要がある場合は、まずマシンの空きディスク容量を調べます。十分な空きディスク領域がある場合は、次の変更を行います。

• EMSAllLogFileMaxを100 MBに設定します。

  注：まず、Cisco ICMがインストールされているドライブに十分なディスク領域があることを確認します。

• EMSLogFileMaxを10 MBに設定します。

• EMSDisplayToScreenを0に設定します。

• レジストリの変更は、ログを収集するプロセスごとに行う必要があります。

  注：EMSAllLogfilesMTaxは累積されることを覚えておいてください。OPC、PIM1、PIM2、およびCTISVRに対してEMSAllLogfilesMaxを100 MBに設定すると、使用可能なドライブ領域の400 MBが使用されます。

• 提示されるファイルサイズは単なる参照点です。大規模で多忙なコンタクトセンターでは、ログが上書きされないように、EMSAllLogfilesMaxを増やす必要が生じる可能性があります。

メッセージトレースの表示

メッセージがキャプチャされたら、dumplog EMSユーティリティを使用して表示します。DumplogはEMSログファイルを読み取り、イベントデータをフォーマットし、フォーマットしたデータを出力ファイルに書き込みます。ログファイルにメッセージトレースイベントが含まれている場合、トレースされた各メッセージはデコード形式でdumplog出力に表示されます。

データをキャプチャしたら、変更した値をリセットします。

Regacc ユーティリティ

regaccユーティリティはコマンド駆動型で、Telnetセッションで使用できます。コマンドプロンプトでregaccと入力します。次の表に、最も一般的なregaccコマンドを示します。

コマンド	機能
regcd	現在のレジストリディレクトリを変更します。
regdir	現在のレジストリディレクトリを一覧表示します。
regpwd（登録）	現在の作業ディレクトリを印刷します。
レセット	現在の作業レジストリディレクトリに新しいレジストリ値を設定します。
q	regaccユーティリティを終了します。
?	regaccのヘルプを表示します。
コマンド/?	個々のコマンドの構文を表示します。

この例では、トレースを起動するプロセスを含むディレクトリにアクセスする方法を示します。regcdコマンドを発行してディレクトリを変更した後、regdirコマンドを発行して現在の作業ディレクトリの内容を表示します。

regcd
Cisco ICM version 4.6 and earlier:
regacc:regcd software\geotel\icr\cal\pg1a\ems\currentversion\library\processes

Cisco ICM version 5.0 and later:
regacc:regcd software\Cisco Systems, Inc.\icm\cal\pg1a\ems\currentversion\library\processes
regacc:regdir
		<KEY>       : DCServer
               <KEY>       : et
               <KEY>       : hsl
               <KEY>       : mds
               <KEY>       : mis
               <KEY>       : nm
               <KEY>       : nmm
               <KEY>       : opc
               <KEY>       : pgag
               <KEY>       : pim1
               <KEY>       : tsyp

注：この値は、スペースの制約上、複数行で表示されています。

この場合、PIMプロセスではトレースが必要です。pim1ディレクトリに移動するにはregcdコマンドを使用し、そのディレクトリの内容を表示するにはregdirコマンドを使用します。

regacc:  regcd pim1 
regacc:regdir

EMSAllLogFilesMax             : REG_DWORD: 1e8480
EMSBreakOnExit                : REG_DWORD: 0x0
EMSBreakOnInit                : REG_DWORD: 0x0
EMSDebugBreak                 : REG_DWORD: 0x1
EMSDisplayToScreen            : REG_DWORD: 0x1
EMSForwardLevel               : REG_DWORD: 0x1
EMSLogFileCountMax            : REG_DWORD: 0x3e8
EMSLogFileLocation            : REG_SZ: logfiles
EMSLogFileMax                 : REG_DWORD: 0x186a0 
EMSNTEventLogLevel            : REG_DWORD: 0x2
EMSTraceMask                  : REG_DWORD: 0x0
EMSUserData                   : REG_BINARY: FFFF

regsetコマンドは、値を変更するために使用されます。この例では、EMSLogFileMaxのサイズが5 MBから1 MBに変更されています。

注：値を変更する場合は、16進形式を使用する必要があります。

regacc:regset emsalllogfilesmax 1e8480 
emsalllogfilesmax 1e8480                    :REG_DWORD:  1e8480

OPCTest、Rttest、およびProcmon

トレースで使用されるプロセスの説明を次に示します。

OPCTest

OPCTestを使用すると、OPCプロセスのみのトレースを起動できます。debugコマンドを使用して、個々のトレースメータの音量を上げます。OPCTestでdebug /?と入力すると、コマンドの詳細が表示されます。

プロセスがアサートした場合、またはサービスが停止した場合、指定したオプションがオフになります。データが出力で折り返されないようにEMSAllLogFilesMaxとEMSLogFilesMaxを増やすには、regaccコマンドまたはregedt32コマンドを使用する必要があります。

OPCTestからのトレースをオフにするには、debug /noallコマンドを発行します。テストを終了する際は、すべてのプロセスウィンドウを必ず最小化してください。

OPCTestについての詳細は、『OPCテストコマンドラインユーティリティの使用』を参照してください。

Rttest

rttestコマンドを発行すると、RTRプロセスのトレースのみを起動できます。個別のトレースメータを起動するには、debugコマンドを使用します。rttestでdebug /?と入力すると、コマンドの詳細が表示されます。

プロセスがアサートした場合、またはサービスが停止した場合、指定したオプションがオフになります。データが出力で折り返されないようにEMSAllLogFilesMaxとEMSLogFilesMaxを増やすには、regaccコマンドまたはregedt32コマンドを使用する必要があります。

rttestの詳細については、『Cisco ICM rttestユーティリティ』を参照してください。

Procmon

pim、mis、およびctiserverプロセスでトレースを起動するには、procmonを使用できます。残念ながら、これらのプロセスのトレースを起動する標準オプションはありません。たとえば、Definityスイッチのオプションはdebugですが、VRU PIMトレースを開始するには、トレースメータを設定し、ltraceコマンドを使用してトレースメータを表示する必要があります。procmonの使用法の詳細を表示するには、DOSプロンプトで次のように入力します。

procmon custname device process

mhelpコマンドを発行すると、個々のプロセスに対するオプションが一覧表示されます。

Definityスイッチのオプションの例を次に示します。

C:\>procmon cust pg2a pim1
>>>>debug /?
Usage: acd_debug [/noagent] [/agent] [/agent+] [/agent++] [/nobri] [/bri]
                 [/bri+] [/nocall] [/call] [/call+] [/nocms] [/cms] [/cms+]
                 [/noconfig] [/config] [/nocv] [/cv] [/noerror] [/error]
                 [/nohb] [/hb] [/ken] [/ken+] [/noken] [/noopc] [/opc]
                 [/nopost] [/post] [/nosim] [/sim] [/notg] [/tg] [/notimer]
                 [/timer] [/notp] [/tp] [/tp+] [/trace] [/novq] [/vq] [/vq+]
                 [/warning] [/nowarning] [/all] [/noall] [/set UserSetBit]
                 [/help] [/?]

regaccユーティリティはprocmonに組み込まれています。procmonでは、mhelpコマンドを発行してregaccコマンドを表示できます。

プロセスがアサートした場合、またはサービスが停止した場合、指定したオプションがオフになります。データが出力で折り返されないようにEMSAllLogFilesMaxとEMSLogFilesMaxを増やすには、引き続きregaccまたはregedt32コマンドを使用する必要があります。

procmonからのトレースをオフにするには、debug /noallを入力します。テストを終了する際は、すべてのプロセスウィンドウを必ず最小化してください。

procmonについての詳細は、『Remote Process Monitor Console(Procmon)の使用』を参照してください。

関連情報

• OPC テスト コマンドライン ユーティリティの使用
• Cisco ICM rttest ユーティリティ
• Remote Process Monitor Console（Procmon）の使用
• Dumplog ユーティリティの使用方法
• テクニカルサポート - Cisco Systems