Cisco Unified Contact Center Express サービスおよびトラブルシューティング ガイド
偏向のない言語
この製品のマニュアルセットは、偏向のない言語を使用するように配慮されています。このマニュアルセットでの偏向のない言語とは、年齢、障害、性別、人種的アイデンティティ、民族的アイデンティティ、性的指向、社会経済的地位、およびインターセクショナリティに基づく差別を意味しない言語として定義されています。製品ソフトウェアのユーザーインターフェイスにハードコードされている言語、RFP のドキュメントに基づいて使用されている言語、または参照されているサードパーティ製品で使用されている言語によりドキュメントに例外が存在する場合があります。シスコのインクルーシブランゲージに対する取り組みの詳細は、こちらをご覧ください。
翻訳について
このドキュメントは、米国シスコ発行ドキュメントの参考和訳です。リンク情報につきましては、日本語版掲載時点で、英語版にアップデートがあり、リンク先のページが移動/変更されている場合がありますことをご了承ください。あくまでも参考和訳となりますので、正式な内容については米国サイトのドキュメントを参照ください。
- Updated:
- 2017年5月30日
章のタイトル： トレース
トレース
•
「Cisco Unified CCX のログ ファイル」
トレース ファイルについて
トレース ファイルは、Cisco Unified CCX コンポーネントからのアクティビティを記録するログ ファイルです。トレース ファイルを使用して、問題のトラブルシューティングに役立つ、システムに関する具体的な詳細情報を入手できます。
Cisco Unified CCX システムは、すべてのコンポーネント サブファシリティのトレース情報を生成できます。この情報はトレース ファイルに保存されます。トレース ファイルのサイズを制御するには、情報を収集するコンポーネントおよびサブファシリティと収集する情報のレベルを指定します。
Cisco Unified CCX システムでは、システムで実行されているすべてのスレッドに関する情報も生成されます。この情報は、スレッド ダンプ トレース ファイルに保存され、トラブルシューティングの際に役立ちます。
コンポーネントのトレース ファイル
次の Cisco Unified CCX コンポーネントにトレース ファイルを作成できます。
• Cisco Unified CCX Administration
• Cisco Unified CCX Node Manager
コンポーネントのトレース ファイルには、コンポーネントの各サブファシリティに関する情報が含まれます。このトレース ファイルを設定するための一般的な手順は、次のとおりです。
トレース ファイルの読み取りについては、「トレース ファイルの表示および解釈」を参照してください。
コンポーネントのトレース ファイルの設定
デフォルトでは、Cisco Unified CCX システムはサブファシリティに関する情報を、CiscoMIVRnn.log などのトレースファイルに送信します。nn は、01 から始まる数値に置き換えられます。トレース ファイルのサイズを設定できます。設定したサイズに達するか、Cisco Unified CCX コンポーネントを再起動すると、新しいトレース ファイルが作成され、nn が 1 つ増えます。10 番目のファイルが作成されると（デフォルト）、トレース ファイルは、最初に作成されたファイルから既存のファイルを上書きします。
ここに示す例は、Cisco Unified CCX エンジン コンポーネント用です。他のコンポーネントの場合は、コンポーネント名を置き換えて同じ手順に従ってください。
これらのデフォルトのトレース ファイル パラメータを変更する手順は、次のとおりです。
ステップ 1 [Cisco Unified CCX Administration] メニューから [System] > [Tracing] を選択します。
[Trace Configuration] ページが表示されます。
ステップ 2 ナビゲーション バーからコンポーネントを選択し、展開します。
ステップ 3 必要に応じて、[Trace File] の下で次の情報を変更します。
• Trace File Output：トレース ファイルに情報を送信するには、このチェックボックスをオンにします。トレース ファイルに情報を送信しない場合は、このボックスをオフにします。デフォルトでは、このチェックボックスはオンになっています。
• File Name：トレース ファイルのベース名と拡張子を入力します。トレース ファイル名は、ベース ファシリティ名、ファイル番号、および拡張子で構成されます（例：CiscoMIVR01.log）。デフォルトのファイル名は、 Cisco<facility_code>.log です。
< facility_code> は、MIVR、MCVD、MADM、MEDT または MARC です。
• Number of Trace Files：既存ファイルの上書きを開始するまでにシステムが作成するトレース ファイル数を入力します。システムは、既存のファイルが [Trace File Size] フィールドで指定されたサイズに達すると新しいトレース ファイルを作成します。デフォルトのトレース ファイル数は 10 です。
• Trace File Size：トレース ファイルのファイル サイズを設定できます。つまり最大サイズをバイト数で入力できます。デフォルトのファイル サイズは 1048576 です。
トレース レベル オプション
トレース ファイルは、Cisco Unified CCX コンポーネント サブシステムおよびステップからのアクティビティを記録するログ ファイルです。トレース ファイルを使用して、問題のトラブルシューティングに役立つ、システムに関する具体的な詳細情報を入手できます。
Cisco Unified CCX システムは、すべてのサブファシリティのトレース情報を生成できます。この情報はエンジン トレース ファイルに保存されます。エンジン トレース ファイルのサイズを制御するには、情報を収集するサブファシリティと収集する情報のレベルを指定します。
Cisco Unified CCX システムでは、システムで実行されているすべてのスレッドに関する情報も生成されます。この情報は、スレッド ダンプ トレース ファイルに保存され、トラブルシューティングの際に役立ちます。
Cisco Unified CCX エンジンなどのコンポーネントに関するすべての情報を記録するトレース ファイルは大きくなり、読み取りが難しくなることがあります。トレース ファイルを管理しやすくするために、Cisco Unified CCX システムでは、情報を記録するサブファシリティを指定できます。これらのサブファシリティを次の表に示します。
サブファシリティごとに、[Debugging]、[Alarm Tracing]、両方、選択なしのトレース レベルを選択できます。これらの選択項目では、システムがトレース ファイルに送信するメッセージを指定します。 表 4-1 に、各トレース レベル設定の効果を示します。メッセージの重大度の説明については、「Cisco Unified CCX アラーム サービス」を参照してください。
|
|
メッセージの重大度 |
|
|---|---|---|
[Trace Configuration] ペインでは、トレース レベル オプションが次のリストに分類されています。
• アクティブ トレース レベル オプション：システムで実行されるファシリティおよびサブファシリティ
• 非アクティブ トレース レベル オプション：システムで実行されていないファシリティおよびサブファシリティ
アクティブ ファシリティで変更を加えると、トレース ファイルは、変更を即座に反映します。非アクティブ サブファシリティで変更を加えると、変更は、そのサブファシリティがアクティブになったときに反映されます。
警告 レベル 7 のトレースはデバッグのみで、システムの問題は反映されません。
Cisco Unified CCX トレース ライブラリを使用するすべてのアプリケーションで Syslog ファシリティ コードが使用されます。 表 4-2 に、トレース ファイルのファシリティと説明を示します。
|
|
|
|---|---|
表 4-3 に、トレース ファイルのサブファシリティを示します。
|
|
|
|---|---|
Cisco Unified CCX 製品を 7845 マシンで実行し、トレースをオン（デフォルト）にした場合は、[Busy Hour Call Completions (BHCC)] を 1 時間あたり 4500 コールに制限してください。高い BHCC を実行する場合は、デバッグ トレースをオフにしてください。オフにするトレース サブファシリティは、ICD_CTI、SS_TEL、SS_RM、SS_CM、および SS_RMCM です。
トレース レベル オプションの設定
トレース レベル オプションを設定する手順は、次のとおりです。
ステップ 1 [Cisco Unified CCX Administration] メニューから [System] > [Tracing] を選択します。
[Trace Configuration] Web ページが表示されます。
ステップ 2 対象の Cisco Unified CCX コンポーネントの下で、ナビゲーション バーから [Trace File Configuration] を選択します。
ステップ 3 [Active] および [Inactive] トレース レベル オプション リストの対象のボックスをオンまたはオフにします。
ステップ 5 [Inactive] トレース レベル オプション リストに変更を加えた場合は、Cisco Unified CCX エンジンを停止してから再起動し、トレース ファイルの変更を反映させる必要があります。
トレース ファイルの表示および解釈
Cisco Unified CCX サーバは、Cisco Unified CCX コンポーネントをインストールしたディレクトリの Log ディレクトリにトレース ファイルを保存します。[Cisco Unified CCX Administration] メニューから、すべてのトレース ファイルのリストを表示し、トレース ファイルの内容を表示できます。
トレース ファイルの表示
Cisco Unified CCX コンポーネントのトレース ファイルを表示する手順は、次のとおりです。
ステップ 1 [Cisco Unified CCX Administration] メニューから [System] > [Tracing] を選択します。
[Trace Configuration] Web ページが表示されます。
ステップ 2 ナビゲーション バーからコンポーネントを選択して展開し、[Trace Configuration] を選択します。
ステップ 3 サブファシリティのカテゴリを展開し、対象のサブファシリティのデバッグ レベルを選択して [Update] をクリックします。
トレース ファイルの解釈
トレース ファイルには、標準 Syslog フォーマットの情報が含まれます。ファイルには、記録されたイベントごとに次の情報の一部またはすべてが含まれます。
スレッド ダンプ トレース ファイル
スレッド ダンプ トレース ファイルの名前は JVM.log です。Cisco Unified CCX サーバの Cisco Unified CCX エンジンのインストール先ディレクトリの Log ファイルに保存されます。このファイルには、Cisco Unified CCX システムで実行されているすべてのスレッドに関するスタック トレース情報が含まれます。必要に応じて、このファイルに情報を書き込めます。また、重大なシステムの問題が検出されると、その情報がこのファイルに自動的に書き込まれます。新しい情報が生成されると、既存のスレッド ダンプ ファイルに追加されます。
（注） メモリ ダンプ ファイルもあります。このファイルは、Cisco Unified CCX Administration のスレッド ダンプ ファイルと同じ場所にあります。memory<timestamp>.log というタイプのメモリ ダンプ ファイルが作成されます。
スレッド ダンプ トレース ファイルへの書き込み
スレッド ダンプ トレース ファイルに手動で書き込む手順は、次のとおりです。
ステップ 1 [Cisco Unified CCX Administration] メニューから [System] > [Control Center] を選択します。
[Control Center] Web ページが表示されます。
ステップ 2 [Servers] をクリックし、ナビゲーション バーからサーバのホスト名を選択します（選択されたサーバではない場合）。
ステップ 3 上部にある [Server Traces] をクリックし、スレッド ダンプをイネーブルにするコンポーネントを選択します。
ステップ 4 [Dump Threads Trace] をクリックします。
スレッド ダンプ トレース ファイルの表示
スレッド ダンプ トレース ファイルを表示する手順は、次のとおりです。
ステップ 1 [Cisco Unified CCX Administration] メニューから [System] > [Control Center] を選択します。
[Control Center] Web ページが表示されます。
ステップ 2 [Servers] をクリックし、ナビゲーション バーからサーバのホスト名を選択します（選択されたサーバではない場合）。
ステップ 3 上部にある [Server Traces] をクリックし、スレッド ダンプをイネーブルにするコンポーネントを選択します。
ステップ 4 [Dump Threads Trace] をクリックします。
ステップ 5 [File Name] 列で、[JVM.log] をクリックします。
Cisco Unified CCX のログ ファイル
Cisco Unified CCX ログ ファイルは、問題のトラブルシューティングに役立ちます。 表 4-4 に、さまざまな Cisco Unified CCX コンポーネントのログ ファイルに関する情報とログ ファイルのパスを示します。
Cisco Desktop Product Suite インストール ログ
Cisco Desktop Product Suite, Version 6.4、ログ ファイルを検索する必要がある場合は、この項を参照してください。
• Install Manager のログ ファイルは、C: ドライブのルートにあります。
– IM<number>.dbg。<number> の範囲は 0001 ～ 0010です（IM0001.dbg）。
• InstallShield サイレント インストール ファイルは C:¥Winnt にあります。
– splk_<project>.log。<project> は、splk_base.log などの Desktop インストール プロジェクトです。
• InstallShield のインストールおよびアンインストールのデバッグ ファイルは、<Program Files>¥Cisco¥Desktop¥IM にあります。
– splkInstall_<version>.dbg。<version> は、Desktop ソフトウェア バージョンで、splkInstall_6.4.0.20.dbg のようになります。
– splkInstall_Obj_<version>.dbg。<version> は、Desktop ソフトウェア バージョンで、splkInstall_Obj_6.4.0.20.dbg のようになります。
Desktop のアンインストール後、ログ ファイルは次の場所に置かれます。
• Install Manager ファイルは、アンインストールでリブートされるまで上で定義した場所に置かれ、リブート後システムから削除されます。
• InstallShield サイレント アンインストール ファイルは、BootUp ドライブのルートに置かれます。
• InstallShield のインストールおよびアンインストール デバッグ ファイルは、C: ドライブのルートに置かれます。
Cisco Unified CCX Log Collection Tool
Cisco Unified CCX Log Collection Tool を使用すると、表示するすべてのログ ファイルを 1 つの zip ファイルに収集できます。ツールをリモートで実行し、zip ファイルを Cisco Unified CCX サーバから自分のデスクトップやネットワーク デバイスに移動することもできます。
Log Collection Tool を使用してログ ファイルを zip ファイルにまとめる手順は、次のとおりです。
ステップ 1 Cisco Unified CCX Log Collection Tool にアクセスするには、[Start] > [Programs] > [Cisco Unified CCX Administrator] > [Cisco Unified CCX Log Collection Tool] の順に選択します。
警告 Log Collection Tool はシステム パフォーマンスに影響する可能性があるため、オフピーク時に実行してください。システムのバックアップまたは復元中にこのツールを実行しないでください。Cisco Unified CCX サーバのディスク スペースを節約するには、ネットワーク ドライブに zip ファイルを作成します。あるいは、ファイルの取得後にCisco Unified CCX サーバから zip ファイルを削除します。zip ファイルのファイル サイズを制限するには、Log Collection Tool Advanced Options を使用して、開始日時と終了日時、コンポーネントのサブセットを選択します。
ステップ 2 メッセージを読み、同意したら [OK] をクリックします。
[Cisco Unified CCX Log Collection Tool] ダイアログ ボックスが表示されます。
ステップ 3 作成する zip ファイルのパスと名前を入力し、[Save] をクリックします。これで、システムのすべてのログ ファイルが zip ファイルに収集されます。ファイル数を日付、時刻、およびコンポーネント別に制限する場合や、zip ファイルに別の場所を選択する場合は、[Advanced Options] チェックボックスをオンにします。詳細オプションのダイアログ ボックスが表示されます。
ステップ 4 日時でログ ファイルの収集を制限する情報を入力します。ログ ファイルを収集するコンポーネントのチェックボックスをオンにし、[Source Drive] フィールドの横にある [...] ボタンをクリックして、zip ファイルを移動する場所を表示します。zip ファイルの場所を選択します。その場所が、[Source Drive] フィールドに表示されます。[Save] をクリックします。
ネットワーク ドライブではなく Cisco Unified CCX システムの場所を選択すると、続行するかどうかを尋ねる警告が表示されます。
ステップ 5 ファイルを Cisco Unified CCX システムに保存する場合は [Yes] をクリックします。戻ってネットワーク ドライブ上の別の場所を選択する場合は、[No] をクリックします。
[Yes] をクリックすると、実際に zip ファイルを書き込む前に、zip ファイルが使用する予測ディスク容量を示すダイアログ ボックスが表示されます。
ステップ 6 続行する場合は [Yes] をクリックします。zip ファイルへのログ ファイルの収集を中止する場合は [No] をクリックします。
ログ ファイルの収集中、進行状況を示すダイアログ ボックスが表示されます。
フィードバック