このドキュメントでは、クライアントの Cisco Unified Contact Center Enterprise(UCCE)、ペリフェラル ゲートウェイ(PG)サービス、Cisco Customer Voice Portal(CVP)、Cisco UCCE アウトバウンド ダイアラ、Cisco Unified Communications Manager(CallManager)(CUCM)、および Cisco ゲートウェイでトレースを設定する方法について説明します。
次の項目に関する知識があることが推奨されます。
セキュアシェル(SSH)を使用してFinesseサーバにログインし、必要なログを収集するために次のコマンドを入力します。ログがアップロードされるSSH FTP(SFTP)サーバを特定するよう求められます。
ログ | コマンド |
---|---|
インストールログ | file get install desktop-install.log |
デスクトップログ | file get activelog desktop recurs compress |
サーバログ | file get activelog platform/log/servm*.\* compress |
プラットフォームTomcatログ | file get activelog tomcat/logs recurs compress |
音声オペレーティングシステム(VOS)のインストールログ | file get install install install.log |
この手順では、デバッグファイルを作成して収集する方法について説明します。
[Debug Log]
Path=..\log\agent.dbg
Size=3000000
Threshold=DEBUG
この手順では、デバッグファイルを作成して収集する方法について説明します。
[Debug Log]
Path=..\log\supervisor.dbg
Size=3000000
THRESHOLD=DEBUG
CTIOSクライアントがインストールされているクライアントPCで、トレースを起動するためにRegedt32を使用します。次の設定を変更します。
Release | レジストリの場所 | デフォルト値 | Change |
---|---|---|---|
7.xより前のリリース | HKEY_LOCAL_MACHINE\Software\Cisco Systems\Ctios\Logging\TraceMask | 0x07 | 値を0xfffに増やします。 |
リリース7.x以降 | HKEY_LOCAL_MACHINE\SOFTWARE\Cisco Systems, Inc.\CTIOSトレース | 0x40000307 | トラブルシューティングの場合は、値を0xfffに設定します。 |
デフォルト出力が作成され、c:\Program Files\Cisco Systems\CTIOS Client\CTIOS Desktop Phones\ install directoryディレクトリのCtiosClientLogという名前のテキストファイルに保存されます。
CAD Sync Serviceをデバッグするための設定を次に示します。
設定値 | 値 |
---|---|
コンフィギュレーション ファイル 既定の場所 |
DirAccessSynSvr.cfg C:\Program Files\Cisco\Desktop\config |
一般的な問題 | Threshold=DEBUG |
出力ファイル | DirAccessSynSvr.log |
CAD 6.0(X) RASCALサーバをデバッグするための設定を次に示します。
設定値 | 値 |
---|---|
コンフィギュレーション ファイル 既定の場所 |
FCRasSvr.cfg C:\Program Files\Cisco\Desktop\config |
一般的な問題 | 範囲= 1 ~ 4、50、3000 ~ 8000 |
LDAP関連の問題: | 範囲= 4000 ~ 4999 |
LRM関連の問題: | 範囲= 1999 ~ 2000 |
データベース関連の問題 | 範囲= 50 ~ 59 |
出力ファイル 既定の場所 |
FCRasSvr.log、FCRasSvr.dbg C:\Program Files\Cisco\Desktop\log |
チャットサーバをデバッグする設定は次のとおりです。
設定値 | 値 |
---|---|
コンフィギュレーション ファイル 既定の場所 |
FCCServer.cfg C:\Program Files\Cisco\Desktop\config |
一般的な問題 | Threshold=DEBUG |
出力ファイル 既定の場所 |
FCCServer.log、FCCServer.dbg C:\Program Files\Cisco\Desktop\log |
ログ収集に関しては、Dumplogユーティリティを使用してログをプルするを参照してください。
プロセスモニタリング(procmon)ユーティリティを使用して、トレースレベルをオンまたはオフにします。次のコマンドは、CallManagerペリフェラルインターフェイスマネージャ(PIM)トレースをオンにします。
C:\procmon <Customer_Name> <PG_Name> <ProcessName>
>>>trace tp* !-- Turns on third party request tracing
>>>trace precall !-- Turns on precall event tracing
>>>trace *event !-- Turns on agent and call event tracing
>>>trace csta* !-- Turns on CSTA call event tracing
>>>ltrace !-- Output of all trace bits
>>>q !-- Quits
このprocmonコマンドは、CallManager PIMトレースをオフにします。
>>>trace * /off
この手順では、CUCMトレースをオンにする方法について説明します。
次のprocmonコマンドは、JGWトレースをオンにします。
C:\procmon <Customer_Name> <node> process
>>>trace JT_TPREQUESTS !-- Turns on third-party request traces
>>>trace JT_JTAPI_EVENT_USED !-- Turns on traces for the JTAPI Events the PG uses
>>>trace JT_ROUTE_MESSAGE !-- Turns on routing client traces
>>>trace JT_LOW* !-- Traces based on the underlying JTAPI and CTI layers
procmon ipcc pg1a jgwコマンドの例を示します。
この手順では、アクティブ側でCTISVRトレースを有効にする方法について説明します。
次のprocmonコマンドは、VRU PIMのトレースをオンにします。
C:\procmon <Customer_Name> <PG_Name> <ProcessName>
procmon>>>trace *.* /off !-- Turns off
procmon>>>trace !-- Verifies what settings are on/off
procmon>>>trace cti* /onprocmon>>>trace opc* /on
procmon>>>trace *ecc* /onprocmon>>>trace *session* /off
procmon>>>trace *heartbeat* /off
procmon>>>ltrace /traceprocmon>>>quit
このprocmonコマンドは、VRU PIMトレースをオフにします。
>>>trace * /off
この手順では、両方のCTIOSサーバでトレースを有効にする方法について説明します。
リリース7.0(0)を除くすべてのリリースでは、デフォルトのトレースマスクは0x3で、0x20003です。
トレースマスクの値が大きい(0xf以上)場合、CTIOSサーバのパフォーマンスとコール完了率に大きな影響があります。問題をデバッグする場合にのみ、トレースマスクを高い値に設定します。必要なログを収集したら、トレースマスクをデフォルト値に戻す必要があります。
トラブルシューティングの目的で、CTIOSサーバのトレースマスクを次のように設定します。
次のopctestコマンドは、アクティブなPGでOPCトレースをオンにします。
opctest /cust <cust_inst> /node <node>
opctest:debug /agent /routing /cstacer /tpmsg /closedcalls
次に、ラボ環境の例を示します。
C:\Documents and Settings\ICMAdministrator>opctest /cust cc1 /node pg1a
OPCTEST Release 8.0.3.0 , Build 27188
opctest: debug /agent /routing /cstacer /tpmsg /closedcalls !-- Use debug /on in
order to restore default tracing levels
opctest: quit
その他の例を次に示します。
opctest:debug /agent /routing /cstacer /rcmsg /closedcalls /inrcmsg
!-- General example
opctest:debug /agent /routing /cstacer /rcmsg /closedcalls /inrcmsg /NCT
!-- Network transfer example
opctest:debug /agent /routing /cstacer /rcmsg /closedcalls /inrcmsg /task /passthru
!-- Multimedia example
opctest:debug /agent /routing /cstacer /rcmsg /closedcalls /inrcmsg /passthru
!-- VRU PG example
次のprocmonコマンドは、アクティブなPGでeagtpimトレースをオンにします。
C:\>procmon <cust_inst> <node> pim<pim instance
>>>>trace tp* /on
>>>trace precall /on
>>>trace *event /on
>>>trace csta* /on
次に、ラボ環境の例を示します。
C:\Documents and Settings\ICMAdministrator>procmon cc1 pg1a pim1
>>>>trace tp* /on
>>>>trace precall /on
>>>>trace *event /on
>>>>trace csta* /on
>>>>quit
詳細は、『Dumplogユーティリティの使用方法』を参照してください。次の例に示すように、cdlogコマンドを使用してlogfilesディレクトリに移動します。
c:\cdlog <customer_name> pg1a !-- Or, pgXa to depending on the PG number (X)
c:\icm\<customer_name>\<<PG#>>\logfiles\
次の例は、出力をデフォルトファイルに配置する方法を示しています。いずれの場合も、/ofを使用して、出力ファイルの特定の名前を定義できます。
c:\icm\<customer_name>\<PG#>\logfiles\dumplog pim1 /bt <HH:MM> /et <HH:MM> /ms /o
!-- This PIM example places output in a default pim1.txt file
c:\icm\<customer_name>\<PG#>\logfiles\dumplog opc /bt <HH:MM> /et <HH:MM> /ms /o
!-- This OPC example places output in a default opc.txt file
c:\icm\<customer_name>\<PG#>\logfiles\dumplog jgw1 /bt <HH:MM> /et <HH:MM> /ms /o
c:\cdlog <customer_name> cg1a
c:\icm\<customer_name>\<cg#>\logfiles\
!-- This JTAPI example places output in a default jgw1.txt file
c:\icm\<customer_name>\cg#\logfiles\dumplog ctisvr /bt <HH:MM> /et <HH:MM> /ms /o
!-- This CTI server example places output in a default ctisvr.txt file
c:\ icm\<customer_name>\ctios\logfiles\dumplog ctios /bt <HH:MM> /et <HH:MM> /ms /o
!-- This CTIOS server example places output in a default ctios.txt file
この手順では、Cisco SIP IP Phoneソフトウェアを使用してCVPサーバでトレースを有効にする方法について説明します。
この手順では、H323ゲートウェイを使用するCVPサーバでトレースを有効にする方法について説明します。
setcalltrace on
setinterfacetrace on
テスト期間の間、CVP *.logファイルとError.logファイルを収集します。これらのファイルはC:\Cisco\CVP\logs directory on both CVP serversディレクトリにあります。
これらはUnified CVPのログファイルの場所です。ここで、CVP_HOMEはUnified CVPソフトウェアがインストールされているディレクトリです。
ログのタイプ | 場所 |
---|---|
コールサーバおよび/またはレポートサーバログ |
CVP_HOME\logs\ |
操作コンソールログ | CVP_HOME\logs\OAMP\ |
Voice XML(VXML)サーバログ | CVP_HOME\logs\VXML\ |
Simple Network Management Protocol(SNMP)エージェントログ | CVP_HOME\logs\SNMP\ |
Unified CVP Resource Managerログ | CVP_HOME\logs\ORM\ |
場所の例はC:\Cisco\CVPです。
配備されたAudiumアプリケーションなどのカスタム音声XMLアプリケーションでは、デバッグロガーをオンにできます。
C:\Cisco\CVP\VXMLServer\applications\APP_NAME\data\application\ directoryディレクトリのsettings.xml設定ファイルの<loggers>セクション(最後のセクション)に次の行を追加します。
<logger_instance name="MyDebugLogger"
class="com.audium.logger.application.debug.ApplicationDebugLogger"/>
実行時に、このロガーは詳細なVoiceXMLログを\Cisco\CVP\VXMLServer\applications\APP_NAME\MyDebuggerLogger directoryに出力します。
この手順では、アウトバウンドダイヤラ(通常はPGで見られます)のベースダイヤラプロセスログを増やす方法について説明します。
dumplogユーティリティを/icm/<instance>/dialer/logfilesディレクトリから実行します。
dumplog badialer /bt hh:mm:ss /et hh:mm:ss /o
この手順では、インポートプロセスログを増やす方法について説明します。
dumplog baimport /bt hh:mm:ss /et hh:mm:ss /o
この手順では、campaignmanagerプロセスログを増やす方法について説明します。
dumplog campaignmanager /bt hh:mm:ss /et hh:mm:ss /o
Avaya Communications Manager(ACD)PGで、opctestユーティリティを使用して、CallManagerとAvayaの両方で次の値を増やします。
C:\opctest /cust <instance> /node <pgname>
opctest: type debug /agent /closedcalls /cstacer /routing
opctest: q !-- Quits
この手順では、ctisvrプロセスのトレースを増やす方法について説明します。
次の手順では、ルータログを有効にする方法について説明します。
opctestリリース8.5の場合は、代わりにDiagnostic Framework Porticoを使用してください。
debug level 3 component "icm:Router A" subcomponent icm:rtr
テストの期間中にどちらかのルータからルータログを取得するには、dumplogユーティリティを使用します。詳細については、「Dumplogユーティリティの使用方法」を参照してください。
次に、09:00:00 ~ 09:30:00(24時間形式)の10/21/2011のログ要求の例を示します。 次の出力は、C:/router_output.txtファイルに出力されます。
C:\Documents and Settings\ICMAdministrator>cdlog u7x ra
C:\icm\u7x\ra\logfiles>dumplog rtr /bd 10/21/2011 /bt 09:00:00 /ed 10/21/2011
/et 09:30:00 /ms /of C:/router_output.txt
必要に応じて、トラブルシューティングのために出力ファイル(C:/router_output.txt)をシスコに送信します。
次のコマンドは、SIPを使用するCVPサーバのトレースをオンにします。
#conf t
service timestamps debug datetime msec
service timestamps log datetime msec
service sequence-numbers
no logging console
no logging monitor
logging buffered 5000000 7
end
clear logging
これは非常に堅牢なプラットフォームで、提供されたコール量で問題なく推奨されるデバッグを処理できます。ただし、シスコでは次のことを推奨しています。
logging <syslog server ip>
logging trap debugs
show proc cpu hist
これらのデバッグを有効にします:
debug isdn q931
debug voip ccapi inout
debug ccsip mess
debug http client all
debug voip application vxml all
debug vtsp all
debug voip application all
コールを発信して問題をシミュレートしたら、デバッグを停止します。
#undebug all
次の出力を収集します。
term len 0
show ver
show run
show log
次のコマンドは、Cisco Unified SIP Proxy(CUSP)のSIPトレースをオンにします。
(cusp)> config
(cusp-config)> sip logging
(cusp)> trace enable
(cusp)> trace level debug component sip-wire
完了したら、必ずログオフをオフにしてください。
この手順では、ログを収集する方法について説明します。
username <userid> create
username <userid> password <password>
username <userid> group pfs-privusers
UCCEリリース8以降では、ユニファイドシステムコマンドラインインターフェイス(CLI)を使用してトレースを収集できます。dumplogユーティリティと比較して、CLIはPGやRoggerなどの1台のサーバからログのセット全体を取得する非常に高速で効率的な方法です。
この手順では、問題の分析を開始する方法と、有効にするトレースを決定する方法について説明します。この例では、次のサーバからログを収集します。
show tech-support absdatetime mm-dd-yyyy:hh:mm mm-dd-yyyy:hh:mm redirect
dir c:\temp
最初のmm-dd-yyyy:hh:mm文字列を、イベントの約15分前の日時に置き換えます。
2番目のmm-dd-yyyy:hh:mm文字列は、イベントが解決されてから約15分後の日付と時刻に置き換えます。イベントが引き続き発生する場合は、少なくとも15分集めてください。
可能であれば、次の追加情報を収集します。
次の2つのツールがあります。診断フレームワークツールとシステムCLIツール。両方とも、デスクトップ上または各サーバのProgramsディレクトリ下のアイコンです。
この手順では、トレースにUnified System CLIを使用する方法について説明します。
show tech-support absdatetime mm-dd-yyyy:hh:mm mm-dd-yyyy:hh:mm redirect dir c:\temp