Cisco Unified Communications Manager Real-Time Monitoring Tool アドミニストレーション ガイド Release 6.1(1)

• 「インストールログの収集」

• 「トレース収集ステータスの表示とスケジュールされた収集の削除」

• 「クラッシュダンプの収集」

• 「Local Browse の使用方法」

• 「Remote Browse の使用方法」

• 「Q931 Translator の使用方法」

• 「QRT レポート情報の表示」

• 「Real-Time Trace の使用方法」

• 「RTMT のトレース設定の更新」

証明書のインポート

認証局がクラスタ内の各サーバに発行するサーバ認証証明書をインポートできます。シスコでは、Trace and Log Central オプションを使用する前に、証明書をインポートすることをお勧めします。証明書をインポートしないと、RTMT にログインして Trace and Log Central オプションを利用するたびに、Trace and Log Central オプションによってクラスタ内の各ノードのセキュリティ証明書が表示されます。証明書に表示されるデータは一切変更できません。

証明書をインポートするには、 [Tools] > [Trace] > [Import Certificate] を選択します。

システムでサーバ証明書のインポートが完了したことを示すメッセージが表示されます。 [OK] をクリックします。

追加情報

「関連項目」を参照してください。

RTMT の Trace and Log Central オプションの表示

操作を開始する前に、「証明書のインポート」の説明に従ってセキュリティ証明書がインポートされていることを確認してください。

Trace & Log Central ツリー階層を表示するには、次のいずれかのタスクを実行します。

• Quick Launch Channel で [System] をクリックし、 [Trace & Log Central] アイコンをクリックします。

• [Tools] > [Trace] > [Trace & Log Central] を選択します。

ヒント ツリー階層に表示されるどのオプションからでも、トレース対象とするサービス/アプリケーションの指定、使用するログおよびサーバの指定、収集日時のスケジュール、ファイルのダウンロード機能の設定、zip ファイルの設定、および収集したトレースファイルの削除を行うことができます。

Real-Time Monitoring Tool で Trace and Log Central のオプションを表示したら、次のいずれかのタスクを実行します。

• クラスタ内の 1 つ以上のサーバ上のサービス、アプリケーション、およびシステムログのトレースを収集します。「トレースファイルの収集」を参照してください。

• 指定する検索条件を含むトレースファイルを収集およびダウンロードして、再使用できるようにトレース収集条件を保存します。「Query Wizard の使用方法」を参照してください。

• 定期的なトレース収集をスケジュールし、ネットワーク上の SFTP または FTP サーバにトレースファイルをダウンロードします。「トレース収集のスケジュール」を参照してください。

• ネットワークに接続されている 1 つ以上のサーバのクラッシュダンプファイルを収集します。「クラッシュダンプの収集」を参照してください。

• 収集したトレースファイルを表示します。「Local Browse の使用方法」を参照してください。

• サーバ上のトレースファイルをすべて表示します。「Remote Browse の使用方法」を参照してください。

• アプリケーションごとに、サーバに書き込まれている現在のトレースファイルを表示します。トレースファイルに検索文字列が存在する場合には、指定した操作を実行できます。「Real-Time Trace の使用方法」を参照してください。

追加情報

• 「関連項目」を参照してください。

トレースファイルの収集

Trace and Log Central の [Collect Files] オプションを使用して、クラスタ内の 1 つ以上のサーバ上のサービス、アプリケーション、およびシステムログのトレースを収集します。トレースを収集する日付/時間の範囲、トレースファイルのダウンロード先ディレクトリ、収集されたファイルをサーバから削除するかどうかなどを指定します。Trace and Log Central 機能を使用してトレースを収集するには、次の手順を実行します。

（注）アクティブにしなかったサービスも表示されるため、それらのサービスのトレースを収集できます。

指定する検索条件を含むトレースファイルを収集する場合、または再使用できるように保存したトレース収集条件を使用する場合は、「Query Wizard の使用方法」を参照してください。

RTMT の Trace and Log Central のディスク I/O と CPU スロットリング

RTMT は、Trace and Log Central の重要な処理およびジョブが、オンデマンド、スケジュール、自動のどの方法で実行されている場合でも、スロットリングをサポートします。スロットリングは、コール処理用の I/O 使用の需要が高い場合に処理を遅らせて、コール処理が優先されるようにします。

コール処理ノードで多数の I/O が実行されている状態でオンデマンド処理を要求すると、警告が表示され、処理の中断を選択できます。警告を表示するタイミングを制御する I/O レートのしきい値は、次のサービスパラメータで設定可能です（Cisco RIS Data Collector サービス）。

• TLC Throttling CPU Goal

• TLC Throttling IOWait Goal

これらのパラメータの値が実際のシステムの CPU と IOWait の値と比較されます。目的値（サービスパラメータの値）が実際の値より低い場合は、警告が表示されます。

トレース圧縮サポート

この機能を使用すると、ROS（Recoverable Outstream）ライブラリでトレースファイルの圧縮出力をサポートできます。トレースファイルは生成時に圧縮されます。トレースファイルの圧縮には次の利点があります。

• トレースファイルの保存に必要な容量が削減される。

• ディスクヘッドの移動が減少するため、コールの負荷が大幅に削減される。事実上、トレースファイルの需要によって CPU がブロックされることはなくなります。

トレースの圧縮を有効または無効にするには、エンタープライズパラメータ Trace Compression を使用します。このパラメータのデフォルト値は Disabled に指定されています。エンタープライズパラメータの値の設定方法については、『 Cisco Unified Communications Manager アドミニストレーションガイド 』を参照してください。

圧縮されたファイルの拡張子は .gz です（ファイルの書き込み中は .gzo）。圧縮されたファイルを開くには、ファイル名をダブルクリックします。拡張子に関連付けられたビューアがある場合、ファイルはそのビューアで開かれます。拡張子にビューアが関連付けられていない場合は、［ファイルを開くプログラムの選択］ダイアログボックスが表示されます。使用するビューアを選択し、以降このビューア選択プロセスを省略する場合は［このファイルを開くときは、常にこのプログラムを使用する］チェックボックスをオンにします。

始める前に

次のタスクを 1 つ以上実行します。

• Cisco Unified Serviceability の [Trace Configuration] ウィンドウで、さまざまなサービスのトレースファイルに含める情報を設定します。詳細については、『 Cisco Unified Serviceability アドミニストレーションガイド 』を参照してください。

• トレースファイルにアラームが送信されるようにするには、Cisco Unified Serviceability の
[Alarm Configuration] ウィンドウで、SDI または SDL トレースファイルをアラーム宛先として選択します。詳細については、『 Cisco Unified Serviceability アドミニストレーションガイド 』を参照してください。

• TLC Throttling CPU Goal および TLC Throttling IOWait Goal サービスパラメータ（Cisco RIS Data Collector サービス）の値を設定して、Trace and Log Central の重要な処理とジョブのスロットリングを設定します。サービスパラメータの設定方法の詳細については、『 Cisco Unified Communications Manager アドミニストレーションガイド 』を参照してください。

• オプションで、Trace Compression エンタープライズパラメータの値を Enabled に設定して、トレースの圧縮を有効にします。エンタープライズパラメータの設定方法の詳細については、『 Cisco Unified Communications Manager アドミニストレーションガイド 』を参照してください。

手順

ステップ 1 「RTMT の Trace and Log Central オプションの表示」の説明に従って、Trace and Log Central のオプションを表示します。

ステップ 2 Trace & Log Central ツリー階層で、 [Collect Files] をダブルクリックします。

トレース収集ウィザードが表示されます。

（注）アクティブにしなかったサービスも表示されるため、それらのサービスのトレースを収集できます。

（注）クラスタ内に使用できないサーバがある場合は、使用できないサーバを特定するメッセージがダイアログボックスに表示されます。使用できないサーバは、Trace and Log Central のウィンドウには表示されません。

（注）リストされている一部のサービス/アプリケーションは、クラスタ内の特定のノードにのみインストールできます。これらのサービス/アプリケーションのトレースを収集する場合、必ず、サービス/アプリケーションをアクティブにしたサーバからトレースを収集してください。

ステップ 3 [Select CCM Services/Applications] タブで、次のいずれかのタスクを実行します。

（注） [Select all Services on all Servers] チェックボックスをオンにすると、Trace and Log Central でクラスタ内のすべてのサーバからトレースが収集されます。

• すべてのサーバのサービスとアプリケーションのトレースをすべて収集するには、 [Select all Services on all Servers] チェックボックスをオンにします。

• 特定サーバのすべてのサービスとアプリケーションのトレースを収集するには、そのサーバの横にあるチェックボックスをオンにします。

• 特定サーバの特定のサービスやアプリケーションのトレースを収集するには、該当するチェックボックスをオンにします。

• サービスやアプリケーションのトレースを収集せずにトレース収集ウィザードでの設定を続行するには、ステップ 4 に進みます。

ステップ 4 [Next] をクリックします。

ステップ 5 [Select System Services/Application] タブで、次のいずれかのタスクを実行します。

• すべてのサーバのシステムログをすべて収集するには、 [Select all Services on all Servers] チェックボックスをオンにします。

• 特定サーバのすべてのシステムログのトレースを収集するには、そのサーバの横にあるチェックボックスをオンにします。

• 特定サーバの特定システムログのトレースを収集するには、該当するチェックボックスをオンにします。

• システムログのトレースを収集せずにトレース収集ウィザードでの設定を続行するには、ステップ 6 に進みます。

ステップ 6 [Next] をクリックします。

ステップ 7 [Collection Time] グループボックスで、トレースを収集する時間範囲を指定します。次のいずれかのオプションを選択します。

• Absolute Range ：トレースを収集するサーバのタイムゾーンと時間範囲（開始および終了の日時）を指定します。

クライアントマシンのタイムゾーンが [Select Reference Server Time Zone] フィールドのデフォルト設定になります。Daylight Saving が設定されているすべてのタイムゾーンの別々のエントリセットとともに、すべての標準タイムゾーンが [Select Time Zone] ドロップダウンリストボックスに表示されます。

Trace and Log Central により、[Selected Reference Server Time Zone] フィールドに基づいた時間範囲のファイルがダウンロードされます。クラスタ内のサーバ間でタイムゾーンが異なる場合、TLC は時差を調整して同じ期間のファイルを取得します。たとえば、午前 9:00 ～午前 10:00 のファイルを指定し、2 番目のサーバ（サーバ x）が 1 時間早いタイムゾーンにある場合、TLC は午前 10:00 ～午前 11:00 のファイルをサーバ x からダウンロードします。

トレースを収集する日付範囲を設定するには、[From Date/Time] フィールドと [To Date/Time] フィールドのドロップダウンリストボックスを選択します。

• Relative Range ：トレースの収集範囲となる現在時刻までの時間（分、時、日、週、または月単位）を指定します。

[Download File Options] グループボックスで、トレースをダウンロードするときに適用するオプションを指定します。

ステップ 8 [Select Partition] ドロップダウンリストボックスで、トレースの収集対象となるログが記録されているパーティションを選択します。

Cisco Unified Serviceability では、ユーザがログインしたアプリケーションのバージョンのログをアクティブパーティションに保存し、他のバージョンがインストールされている場合には、そのバージョンのログを非アクティブディレクトリに保存します。

そのため、Linux プラットフォームで実行されている Cisco Unified Communications Manager のバージョンを別のバージョンにアップグレードし、新しいバージョンでサーバを再起動すると、Cisco Unified Serviceability は、前のバージョンのログを非アクティブパーティションに移動し、新しいバージョンのログをアクティブパーティションに保存します。古いバージョンの Cisco Unified Communications Manager にもう一度ログインすると、Cisco Unified Serviceability は、新しいバージョンの Cisco Unified Communications Manager のログを非アクティブパーティションに移動し、古いバージョンのログをアクティブディレクトリに保存します。

（注） Cisco Unified Serviceability は、Windows プラットフォームで実行された Cisco Unified Communications Manager バージョンのログを保持しません。

ステップ 9 トレースファイルのダウンロード先ディレクトリを指定するには、[Download File Directory] フィールドの横にある [Browse] ボタンをクリックし、ディレクトリまでナビゲートして、 [Open] をクリックします。デフォルトでは、<rtmt_install_directory>\<サーバ名またはサーバ IP アドレス>\<ダウンロード時刻> と指定されます。<rtmt_install_directory> には、RTMT のインストール先ディレクトリが指定されます。

ステップ 10 収集するトレースファイルの zip ファイルを作成するには、 [Zip File] オプションボタンをクリックします。zip ファイルに圧縮せずにトレースファイルをダウンロードするには、 [Do Not Zip Files] オプションボタンをクリックします。

ステップ 11 収集されたログファイルをサーバから削除するには、 [Delete Collected Log Files from the server] チェックボックスをオンにします。

ステップ 12 [Finish] をクリックします。

ウィンドウにトレース収集の経過が表示されます。トレース収集を停止する場合は、 [Cancel] をクリックします。

トレース収集プロセスが完了すると、ウィンドウの下部に [Completed downloading for node <サーバ名または IP アドレス>] というメッセージが表示されます。

ステップ 13 収集したトレースファイルを表示するには、トレース収集機能の [Local Browse] オプションを使用できます。詳細については、「Local Browse の使用方法」を参照してください。

（注）サービスパラメータの値が超過するか、システムが Code Yellow 状態に入るとエラーメッセージが表示されます。

追加情報

• サービスパラメータの値の設定方法については、『 Cisco Unified Communications Manager アドミニストレーションガイド 』の「サービスパラメータの設定」の章を参照してください。

• 「関連項目」も参照してください。

インストールログの収集

Trace and Log Central でインストールログおよびアップグレードログを収集する方法は次のとおりです。

手順

ステップ 1 次のいずれかのタスクを実行します。

• Quick Launch Channel で

– [System] をクリックします。

– [Trace & Log Central] アイコンをクリックします。

• [Tools] > [Trace] > [Trace & Log Central] を選択します。

[Trace & Log Central] ウィンドウが表示されます。

ステップ 2 Trace & Log Central ツリー階層で、 [Collect Install Logs] をダブルクリックします。

Collect Install Logs ウィザードが表示されます。

ステップ 3 [Select Servers Options] ボックスで、インストールログを収集するサーバを指定します。特定サーバのインストールログを収集するには、そのサーバの横にあるチェックボックスをオンにします。すべてのサーバのインストールログを収集するには、[Select All Servers] チェックボックスをオンにします。

ステップ 4 [Download File Options] で、ログファイルのダウンロード先ディレクトリを指定します。ログファイルのダウンロード先ディレクトリを指定するには、[Download File Directory] フィールドの横にある [Browse] ボタンをクリックし、ディレクトリまでナビゲートして、 [Open] をクリックします。デフォルトの指定は <rtmt_install_directory> です。<rtmt_install_directory> は RTMT がインストールされたディレクトリを示します。

ステップ 5 [Finish] をクリックします。

Query Wizard の使用方法

トレース収集 Query Wizard を使用して、指定する検索条件を含むトレースファイルを収集およびダウンロードして、再使用できるようにトレース収集条件を保存することができます。トレース収集 Query Wizard を使用するには、次の手順を実行します。

（注） Trace and Log Central 内では、最大で 5 個のファイルを同時に開いて表示できます。ファイルを開くと、Query Wizard、Local Browse、および Remote Browse 機能を使用できます。

始める前に

次のタスクを 1 つ以上実行します。

• トレースファイルにアラームが送信されるようにするには、[Alarm Configuration] ウィンドウで、SDI または SDL トレースファイルをアラーム宛先として選択します。詳細については、『 Cisco Unified Serviceability アドミニストレーションガイド 』を参照してください。

手順

ステップ 1 「RTMT の Trace and Log Central オプションの表示」の説明に従って、Trace and Log Central のオプションを表示します。

ステップ 2 Trace & Log Central ツリー階層で、 [Query Wizard] をダブルクリックします。

Query Wizard が表示されます。

ステップ 3 [Query Wizard Options] ウィンドウで、次のいずれかのオプションボタンをクリックします。

• Saved Query

[Browse] ボタンをクリックし、使用するクエリーまでナビゲートします。クエリーを選択し、 [Open] をクリックします。

[Generic Query] の [Single Node Query] を選択した場合は、RTMT の接続先のノードが [Browse] ボタンの横にチェックマーク付きで表示されます。追加のノードに関するクエリーを実行するには、該当するサーバの横にチェックマークを入れます。

[Generic Query] の [All Node Query] を選択した場合は、すべてのノードが [Browse] ボタンの横にチェックマーク付きで表示されます。クエリーを実行する対象に含まれないサーバがある場合は、そのチェックマークを外すことができます。

[Regular Query] を選択した場合は、クエリーを保存するときに選択したすべてのノードがチェックマーク付きで表示されます。リストに表示される任意のサーバについて、チェックを入れるか外すことができます。新しいサーバを選択する場合は、ウィザードを使用してそのノードのサービスを選択する必要があります。

変更なしでクエリーを実行するには、 [Run Query] をクリックし、ステップ 20 に進みます。クエリーを変更するには、ステップ 4 に進みます。

• Create Query

ステップ 4 [Next] をクリックします。

ステップ 5 [Saved Query] オプションボタンをクリックしてクエリーを選択した場合は、そのクエリーで指定した基準が表示されます。必要に応じて、トレースを収集する対象のサービス/アプリケーションのリストを変更します。[Create Query] オプションボタンをクリックした場合は、トレースを収集する対象のサービス/アプリケーションをすべて選択する必要があります。

ヒント クラスタ内のすべてのサーバのサービスとアプリケーションのトレースをすべて収集するには、[Select all Services on all Servers] チェックボックスをオンにします。特定のサーバで実行されるすべてのサービスとアプリケーションのトレースを収集するには、サーバ名またはサーバ IP アドレスの横にあるチェックボックスをオンにします。

（注）アクティブにしなかったサービスも表示されるため、それらのサービスのトレースを収集できます。

ステップ 6 [Select CallManager Services/Applications] タブで、該当するすべてのチェックボックスをオンにして、目的のサービスログとアプリケーションログを選択します。

ステップ 7 [Next] をクリックします。

ステップ 8 [Select System Logs] タブで、該当するすべてのチェックボックスをオンにして、目的のログを選択します。

ステップ 9 [Next] をクリックします。

ステップ 10 [Query Time Options] ボックスで、トレースを収集するときの時間範囲を指定します。次のいずれかのオプションを選択します。

• All Available Traces ：選択したサービスのサーバ上にあるトレースをすべて収集する場合は、このオプションを選択します。

• Absolute Range ：トレースを収集するサーバのタイムゾーンと時間範囲（開始および終了の日時）を指定します。

トレースを収集する日付範囲を設定するには、[From Date/Time] フィールドと [To Date/Time] フィールドのドロップダウンリストボックスを選択します。

• Relative Range ：トレースの収集範囲となる現在時刻までの時間（分、時、日、週、または月単位）を指定します。

ステップ 11 トレースファイル内のフレーズや単語を基準にして検索するには、[Search String] フィールドに単語またはフレーズを入力します。入力した単語またはフレーズの完全一致を検索する場合は、[Case Sensitive] チェックボックスをオンにします。

ステップ 12 [Call Processing Impact Options] ボックスで、文字列検索アクティビティがコール処理に与える影響のレベルを指定します。[Select Impact Level] ドロップダウンリストボックスで、[Low]、[Medium]、または [High] を選択します。[Low] レベルにすると、コール処理への影響は最小限に抑えられますが、検索に時間がかかります。[High] レベルにすると、コール処理への影響が大きくなりますが、検索は高速で実行されます。

ステップ 13 [Next] をクリックします。

ステップ 14 [Action Options] ウィンドウで、次のいずれかのアクションを選択します。

• Trace Browse

• On Demand Trace Collection

–トレースファイルおよび結果ファイルのダウンロード先ディレクトリを指定するには、[Download selected files] フィールドの横にある [Browse] ボタンをクリックし、ディレクトリまでナビゲートして、 [Open] をクリックします。デフォルトでは、
<rtmt_install_directory>\<サーバ名またはサーバ IP アドレス>\<ダウンロード時刻> と指定されます。<rtmt_install_directory> には、RTMT のインストール先ディレクトリが指定されます。

–収集するトレースファイルの zip ファイルを作成するには、 [Zip File] チェックボックスをオンにします。

–収集されたログファイルをサーバから削除するには、 [Delete Collected Log Files from Server] チェックボックスをオンにします。

• Schedule Download

開始日時と終了日時を指定します。トレースサーバを設定するには、[Configure Trace Server] チェックボックスをオンにします。[SFTP Parameters] ダイアログボックスが表示されます。このダイアログボックスでは、次のパラメータを設定できます。

–Host IP Address

–User Name

–Password

–Port

–Download Directory Path

ステップ 15 次のいずれかのオプションを選択します。

• クエリーを実行するには、 [Run Query] をクリックします。このオプションは、[Action Options] ウィンドウで [Trace Browse] を選択した場合にのみ使用可能です。

[Query Results] フォルダが表示されます。クエリーが完了すると、クエリーの実行が完了したことを示すダイアログボックスが表示されます。 [Close] をクリックし、ステップ 20 に進みます。

• クエリーを保存するには、 [Save Query] ボタンをクリックし、ステップ 16 に進みます。

• トレースをダウンロードするには、 [Download Trace] ボタンをクリックします。このオプションは、[Action Options] ウィンドウで [On Demand Trace Collection] または [Schedule Download] を選択した場合にのみ使用可能です。

ヒント トレースファイルをダウンロードしたら、Trace and Log Central 機能の [Local Browse] オプションを使用して表示できます。詳細については、「Local Browse の使用方法」を参照してください。

ステップ 16 作成するタイプのクエリーの横にあるチェックボックスをオンにします。

• Generic Query ：クエリーを作成したときとは別のノードでも実行できるクエリーを作成する場合は、このオプションを選択します。選択したサービスが 1 つのサーバに存在する場合は、汎用クエリーのみを作成できます。複数のノードでサービスを選択すると、メッセージが表示されます。

次に、[Single Node Query] オプションまたは [All Node Query] オプションのどちらかを選択します。[Single Node Query] を選択すると、クエリーを実行するときに、そのクエリーが作成されたサーバがトレース収集ツールによってデフォルトで選択されます。[All Node Query] オプションを選択すると、クエリーを実行するときに、クラスタ内のすべてのサーバがトレース収集ツールによってデフォルトで選択されます。

（注）クエリーを実行する前に、デフォルト以外のサーバを選択できます。

• Regular Query ：クエリーを作成したときのノードまたはクラスタのみでクエリーを実行する場合は、このオプションを選択します。

ステップ 17 [Finish] をクリックします。

ステップ 18 クエリーを保存する場所を参照し、[File Name] フィールドにクエリーの名前を入力して、 [Save] をクリックします。

ステップ 19 次のいずれかのタスクを実行します。

• 保存したクエリーを実行するには、 [Run Query] をクリックし、ステップ 20 に進みます。

• 作成したクエリーを実行せずに Query Wizard を終了するには、 [Cancel] をクリックします。

ステップ 20 クエリーの実行が完了したら、次のタスクを 1 つ以上実行します。

• 収集したファイルを表示するには、[Query Results] をダブルクリックし、<ノード> フォルダ（<ノード> はウィザードで指定したサーバの IP アドレスまたはホスト名）をダブルクリックし、さらに表示するファイルが格納されているフォルダをダブルクリックして、ファイルの場所までナビゲートします。

ファイルの場所を指定したら、マウスを右クリックしてファイルの表示に使用するプログラムのタイプを選択するか、またはファイルをダブルクリックしてデフォルトのビューアでファイルを表示することができます。Real-Time Monitoring Tool のファイルタイプに応じた適切なビューアに、ファイルが表示されます。他に適切なビューアがない場合には、Real-Time Monitoring Tool の Generic Log Viewer でファイルが開きます。

（注）ファイルに Q931 メッセージが含まれている場合は、「Q931 Translator の使用方法」を参照して Q931 メッセージを表示します。Quality Report Tool（QRT）で生成されるレポートを表示するには、「QRT レポート情報の表示」を参照してください。

• トレースファイルと、クエリーで収集したトレースファイルのリストが書き込まれた結果ファイルをダウンロードします。ファイルをダウンロードするには、対象のファイルを選択し、 [Download] ボタン をクリックし、ダウンロードの基準を指定して、 [Finish] をクリックします。

–収集するトレースファイルの zip ファイルを作成するには、 [Zip File] チェックボックスをオンにします。

–収集されたログファイルをサーバから削除するには、 [Delete Collected Log Files from Server] チェックボックスをオンにします。

• クエリーを保存するには、[Save Query] ボタンをクリックし、ステップ 16 ～ステップ 18 を実行します。

（注）サービスパラメータの値が超過するか、システムが Code Yellow 状態に入るとエラーメッセージが表示されます。

追加情報

「関連項目」を参照してください。

トレース収集のスケジュール

Trace and Log Central 機能の [Schedule Collection] オプションを使用して、最大 6 件の同時トレース収集をスケジュールし、トレースファイルをネットワーク上の SFTP または FTP サーバにダウンロードしたり、別の保存されたクエリーを実行したり、SysLog ファイルを生成したりすることができます。スケジュールされた収集イベントをシステムに入力した後で変更する場合、スケジュールされた収集イベントを削除して、新しい収集イベントを追加する必要があります。トレース収集をスケジュールするには、次の手順を実行します。

（注）最大で 10 件のトレース収集ジョブをスケジュールできますが、同時に実行可能なトレース収集ジョブは 6 件です。つまり、同時に実行状態にすることができるジョブは 6 件だけです。

始める前に

次のタスクを 1 つ以上実行します。

手順

ステップ 1 「RTMT の Trace and Log Central オプションの表示」の説明に従って、Trace and Log Central のオプションを表示します。

ステップ 2 Trace & Log Central ツリー階層で、 [Schedule Collection] をダブルクリックします。

Schedule Collection ウィザードが表示されます。

（注）アクティブにしなかったサービスも表示されるため、それらのサービスのトレースを収集できます。

ステップ 3 [Select CCM Services/Applications] タブで、次のいずれかのタスクを実行します。

• 特定サーバのすべてのサービスとアプリケーションのトレースを収集するには、そのサーバの横にあるチェックボックスをオンにします。

• 特定サーバの特定のサービスやアプリケーションのトレースを収集するには、該当するチェックボックスをオンにします。

• サービスやアプリケーションのトレースを収集せずに Schedule Collection ウィザードでの設定を続行するには、ステップ 4 に進みます。

ステップ 4 [Next] をクリックします。

ステップ 5 [Select System Services/Application] タブで、次のいずれかのタスクを実行します。

• すべてのサーバのシステムログをすべて収集するには、 [Select all Services on all Servers] チェックボックスをオンにします。

• 特定サーバのすべてのシステムログのトレースを収集するには、そのサーバの横にあるチェックボックスをオンにします。

• 特定サーバの特定システムログのトレースを収集するには、該当するチェックボックスをオンにします。

• システムログのトレースを収集せずに Schedule Collection ウィザードでの設定を続行するには、ステップ 6 に進みます。

ステップ 6 [Next] をクリックします。

ステップ 7 トレースを収集するサーバのタイムゾーンと時間範囲を指定します。

ステップ 8 トレース収集を開始する日時を指定するには、[Schedule Start Date/Time] フィールドの横にある下向き矢印をクリックします。[Date] タブで、適切な日付を選択します。[Time] タブで、適切な時刻を選択します。

ステップ 9 トレース収集を終了する日時を指定するには、[Schedule End Date/Time] フィールドの横にある下向き矢印をクリックします。[Date] タブで、適切な日付を選択します。[Time] タブで、適切な時刻を選択します。

（注）トレース収集は、設定された終了時刻を過ぎても完了しますが、Trace and Log Central 機能によってその収集はスケジュールから削除されます。

ステップ 10 [Scheduler Frequency] ドロップダウンリストボックスで、設定されたトレース収集の実行頻度を選択します。

ステップ 11 [Collect Files generated in the last] ドロップダウンリストボックスで、トレースの収集範囲となる現在時刻までの時間（分、時、日、週、または月単位）を指定します。

ステップ 12 トレースファイル内のフレーズや単語を基準にして検索するには、 [Search String] フィールドに単語またはフレーズを入力します。ツールにより、入力した単語またはフレーズに一致する項目が検索され、検索条件に一致するそれらのファイルが収集されます。入力した単語またはフレーズの完全一致を検索する場合は、[Case Sensitive] チェックボックスをオンにします。

ステップ 13 収集するトレースファイルの zip ファイルを作成するには、 [Zip File] チェックボックスをオンにします。

ステップ 14 収集されたログファイルをサーバから削除するには、 [Delete Collected Log Files from the Server] チェックボックスをオンにします。

ステップ 15 次の操作を 1 つ以上選択します。

• Download Files：[Download Files] または [Run Another Query] を選択した場合は、ステップ 16 に進みます。

• Run Another Query

• Generate Syslog：[Generate Syslog] を選択した場合は、ステップ 18 に進みます。

ステップ 16 [SFTP/FTP Server Parameters] グループボックスで、Trace and Log Central 機能で結果をダウンロードするサーバのサーバクレデンシャルを入力し、 [Test Connection] をクリックします。Trace and Log Central 機能で SFTP または FTP サーバへの接続の検証が終了したら、 [OK] をクリックします。

（注） [Download Directory Path] フィールドで、収集されたファイルを Trace and Log Central 機能によって保存するときのディレクトリを指定します。デフォルトでは、トレース収集によって、SFTP または FTP のパラメータフィールドで指定するユーザ ID を持つユーザのホームディレクトリ（/home/<user>/Trace）にファイルが保存されます。

ステップ 17 [Run Another Query] オプションを選択した場合は、 [Browse] ボタンをクリックして実行するクエリーの場所を指定し、 [OK] をクリックします。

（注） Trace and Log Central 機能は、最初のクエリーが結果を生成した場合にのみ、指定されたクエリーを実行します。

ステップ 18 [Finish] をクリックします。

スケジュールされたトレースが正常に追加されたことを示すメッセージが表示されます。

（注） Real-Time Monitoring Tool が SFTP または FTP サーバにアクセスできない場合は、メッセージが表示されます。その場合、入力した IP アドレス、ユーザ名、およびパスワードが正しいことを確認してください。

ステップ 19 [OK] をクリックします。

ステップ 20 スケジュールされた収集のリストを表示するには、Quick Launch Channel の Trace 部分で、 [Job Status] アイコンをクリックします。

ヒント スケジュールされた収集を削除するには、対象の収集イベントを選択して、[Delete] をクリックします。確認メッセージが表示されます。[OK] をクリックします。

追加情報

「関連項目」を参照してください。

トレース収集ステータスの表示とスケジュールされた収集の削除

トレース収集イベントのステータスを表示し、スケジュールされたトレース収集を削除するには、次の手順を実行します。

手順

ステップ 1 「RTMT の Trace and Log Central オプションの表示」の説明に従って、Trace & Log Central ツリー階層を表示します。

ステップ 2 [Job Status] をダブルクリックします。

[Job Status] ウィンドウが表示されます。

ステップ 3 [Select a Node] ドロップダウンリストボックスで、表示または削除するトレース収集イベントの対象サーバを選択します。

スケジュールされたトレース収集のリストが表示されます。

ジョブタイプには、Scheduled Job、OnDemand、RealTimeFileMon、および RealTimeFileSearch があります。

ステータスには、Pending、Running、Cancel、および Terminated があります。

ステップ 4 スケジュールされた収集を削除するには、削除するイベントを選択して、 [Delete] をクリックします。

（注）削除できるのは、ステータスが「Pending」または「Running」で、ジョブタイプが「Schedule Task」または「RealTimeFileSearch」のジョブです。

追加情報

「関連項目」を参照してください。

クラッシュダンプの収集

トレースファイルのコアダンプを収集するには、次の手順を実行します。

手順

ステップ 1 「RTMT の Trace and Log Central オプションの表示」の説明に従って、Trace & Log Central ツリー階層を表示します。

ステップ 2 [Collect Crash Dump] をダブルクリックします。

Collect Crash Dump ウィザードが表示されます。

（注）アクティブにしなかったサービスも表示されるため、それらのサービスのトレースを収集できます。

ステップ 3 [Select CCM Services/Applications] タブで、次のいずれかのタスクを実行します。

• 特定サーバのすべてのサービスとアプリケーションのトレースを収集するには、そのサーバの横にあるチェックボックスをオンにします。

• 特定サーバの特定のサービスやアプリケーションのトレースを収集するには、該当するチェックボックスをオンにします。

• サービスやアプリケーションのトレースを収集せずに Collect Crash Dump ウィザードでの設定を続行するには、ステップ 4 に進みます。

ステップ 4 [Next] をクリックします。

ステップ 5 [Select System Services/Application] タブで、次のいずれかのタスクを実行します。

• すべてのサーバのシステムログをすべて収集するには、 [Select all Services on all Servers] チェックボックスをオンにします。

• 特定サーバのすべてのシステムログのトレースを収集するには、そのサーバの横にあるチェックボックスをオンにします。

• 特定サーバの特定システムログのトレースを収集するには、該当するチェックボックスをオンにします。

• システムログのトレースを収集せずに Collect Crash Dump ウィザードでの設定を続行するには、ステップ 6 に進みます。

ステップ 6 [Next] をクリックします。

ステップ 7 [Collection Time] グループボックスで、トレースを収集する時間範囲を指定します。次のいずれかのオプションを選択します。

• Absolute Range ：トレースを収集するサーバのタイムゾーンと時間範囲（開始および終了の日時）を指定します。

クラッシュファイルを収集する日付範囲を設定するには、[From Date/Time] フィールドと [To Date/Time] フィールドのドロップダウンリストボックスを選択します。

• Relative Range ：クラッシュファイルの収集範囲となる現在時刻までの時間（分、時、日、週、または月単位）を指定します。

ステップ 8 [Select Partition] ドロップダウンリストボックスで、トレースの収集対象となるログが記録されているパーティションを選択します。

そのため、Linux プラットフォームで実行されている Cisco Unified Communications Manager のバージョンを別のバージョンにアップグレードし、新しいバージョンでサーバを再起動すると、Cisco Unified Serviceability は、前のバージョンのログを非アクティブパーティションに移動し、新しいバージョンのログをアクティブパーティションに保存します。古いバージョンの Cisco Unified Communications Manager にログインすると、Cisco Unified Serviceability は、新しいバージョンの Cisco Unified Communications Manager のログを非アクティブパーティションに移動し、古いバージョンのログをアクティブディレクトリに保存します。

（注） Cisco Unified Serviceability は、Windows プラットフォームで実行された Cisco Unified Communications Manager バージョンのログを保持しません。

ステップ 10 収集するクラッシュダンプファイルの zip ファイルを作成するには、 [Zip File] オプションボタンをクリックします。zip ファイルに圧縮せずにクラッシュダンプファイルをダウンロードするには、 [Do Not Zip Files] オプションボタンをクリックします。

（注）クラッシュダンプファイルの zip ファイルが 2 GB を超える場合、そのファイルはダウンロードできません。

ステップ 11 収集されたクラッシュダンプファイルをサーバから削除するには、 [Delete Collected Log Files from Server] チェックボックスをオンにします。

ステップ 12 [Finish] をクリックします。

コアダンプを収集しようとしていることを示すメッセージが表示されます。続行するには、 [Yes] をクリックします。

（注） [Zip File] オプションボタンをクリックした場合にクラッシュダンプファイルのサイズが 2 GB を超えると、[Zip File] オプションボタンをクリックした状態ではそのサイズのクラッシュダンプファイルを収集できないことを示すメッセージが表示されます。[Do Not Zip Files] オプションボタンをクリックして、もう一度収集を行ってください。

追加情報

「関連項目」を参照してください。

Local Browse の使用方法

トレースファイルを収集して PC にダウンロードしたら、UNIX 系の行末記号を処理できる WordPad などのテキストエディタを使用して PC に表示するか、または Real-Time Monitoring Tool 内のビューアを使用して表示できます。

（注）収集されたトレースファイルを NotePad で表示しないでください。

次の手順を実行し、Trace and Log Central 機能によって収集したログファイルを表示します。PC にダウンロードしたときにトレースファイルを zip ファイルに圧縮した場合は、それらのファイルを解凍してから Real-Time Monitoring Tool 内のビューアを使用して表示する必要があります。

（注） Trace & Log Central 内では、最大で 5 個のファイルを同時に開いて表示できます。ファイルを開くと、Query Wizard、Local Browse、および Remote Browse 機能を使用できます。

始める前に

次のいずれかの項の説明に従って、トレースファイルを収集します。

手順

ステップ 1 「RTMT の Trace and Log Central オプションの表示」の説明に従って、Trace and Log Central のオプションを表示します。

ステップ 2 [Local Browse] をダブルクリックします。

ステップ 3 ログファイルを保存したディレクトリを参照し、表示するファイルを選択します。

ステップ 4 結果を表示するには、そのファイルをダブルクリックします。

ステップ 5 ファイルタイプにすでにビューアが関連付けられている場合、そのビューアでファイルが開かれます。関連付けられていない場合は、［ファイルを開くプログラムの選択］ダイアログボックスが表示されます。ファイルを表示するために使用するプログラム（ビューア）をクリックします。目的のプログラムがリストにない場合は、［その他］ボタンをクリックして別のプログラムを選択します。

このプログラムをデフォルトのビューアとして使用する場合は、［このファイルを開くときは、常にこのプログラムを使用する］チェックボックスをオンにします。

Real-Time Monitoring Tool のファイルタイプに応じた適切なビューアに、ファイルが表示されます。他に適切なビューアがない場合には、Real-Time Monitoring Tool の Generic Log Viewer でファイルが開きます。QRT Viewer の使用方法の詳細については、「QRT レポート情報の表示」を参照してください。QRT Translator の詳細については、「Q931 Translator の使用方法」を参照してください。

追加情報

「関連項目」を参照してください。

Remote Browse の使用方法

トレースファイルを生成したら、Real-Time Monitoring Tool 内のビューアを使用し、サーバにそれらのファイルを表示できます。また、Remote Browse 機能を使用して PC にトレースをダウンロードすることもできます。

次の手順を実行し、Trace and Log Central 機能でログファイルをサーバで表示またはダウンロードします。

始める前に

次のいずれかの項の説明に従って、トレースファイルを収集します。

手順

ステップ 1 「RTMT の Trace and Log Central オプションの表示」の説明に従って、Trace and Log Central のオプションを表示します。

ステップ 2 [Remote Browse] をダブルクリックします。

ステップ 3 適切なオプションボタンをクリックし、 [Next] をクリックします。[Trace Files] を選択する場合は、ステップ 4 に進みます。[Crash Dump] を選択する場合は、ステップ 10 に進みます。

（注）アクティブにしなかったサービスも表示されるため、それらのサービスのトレースを選択できます。

（注） [Crash Dump] を選択すると、ウィザードにはクラッシュダンプを引き起こすサービスのみが表示されます。目的のサービスが表示されない場合は、[Back] をクリックして [Trace Files] を選択してください。

（注）リストされている一部のサービス/アプリケーションは、クラスタ内の特定のノードにのみインストールできます。これらのサービス/アプリケーションのトレースを選択する場合、必ず、サービス/アプリケーションをアクティブにしたサーバからトレースを選択してください。

ステップ 4 [Select CCM Services/Applications] タブで、次のいずれかのタスクを実行します。

• すべてのサーバのサービスとアプリケーションのトレースをすべて収集するには、[Select all Services on all Servers] チェックボックスをオンにします。

• 特定サーバのすべてのサービスとアプリケーションのトレースを収集するには、そのサーバの横にあるチェックボックスをオンにします。

• 特定サーバの特定のサービスやアプリケーションのトレースを収集するには、該当するチェックボックスをオンにします。

• サービスやアプリケーションのトレースを収集せずに Remote Browse ウィザードでの設定を続行するには、ステップ 5 に進みます。

ステップ 5 [Next] をクリックします。

ステップ 6 [Select System Services/Application] タブで、次のいずれかのタスクを実行します。

• すべてのサーバのシステムログをすべて収集するには、 [Select all Services on all Servers] チェックボックスをオンにします。

• 特定サーバのすべてのシステムログのトレースを収集するには、そのサーバの横にあるチェックボックスをオンにします。

• 特定サーバの特定システムログのトレースを収集するには、該当するチェックボックスをオンにします。

• システムログのトレースを収集せずに Remote Browse ウィザードでの設定を続行するには、ステップ 10 に進みます。

ステップ 7 [Select CCM Services/Applications] タブで、次のいずれかのタスクを実行します。

• すべてのサーバのサービスとアプリケーションのクラッシュダンプファイルをすべて選択するには、[Select all Services on all Servers] チェックボックスをオンにします。

• 特定サーバのすべてのサービスとアプリケーションのクラッシュダンプファイルを選択するには、そのサーバの横にあるチェックボックスをオンにします。

• 特定サーバの特定のサービスやアプリケーションのクラッシュダンプファイルを選択するには、該当するチェックボックスをオンにします。

• クラッシュダンプファイルを収集せずに Remote Browse ウィザードでの設定を続行するには、ステップ 8 に進みます。

ステップ 8 [Next] をクリックします。

ステップ 9 [Select System Services/Application] タブで、次のいずれかのタスクを実行します。

• すべてのサーバのクラッシュダンプファイルを選択するには、 [Select all Services on all Servers] チェックボックスをオンにします。

• 特定サーバのすべてのシステムログのクラッシュダンプファイルを選択するには、そのサーバの横にあるチェックボックスをオンにします。

• 特定サーバの特定のシステムログのクラッシュダンプファイルを選択するには、該当するチェックボックスをオンにします。

• クラッシュダンプファイルを収集せずに Remote Browse ウィザードでの設定を続行するには、ステップ 10 に進みます。

ステップ 10 [Finish] をクリックします。

ステップ 11 トレースが使用可能になると、メッセージが表示されます。 [Close] をクリックします。

ステップ 12 次のいずれかのタスクを実行します。

• 結果を表示するには、ツリー階層をたどってファイルまでナビゲートします。ウィンドウの右側のペインにログファイル名が表示されたら、マウスを右クリックしてファイルの表示に使用するプログラムのタイプを選択するか、ファイルをダブルクリックしてデフォルトのビューアでファイルを表示することができます。

ヒント ペインに表示されるファイルをソートするには、列見出しをクリックします。たとえば名前でファイルをソートする場合は、列見出し [Name] をクリックします。

• トレースファイルをダウンロードするには、ダウンロードするファイルを選択して [Download] をクリックし、ダウンロードの基準を指定して、 [Finish] をクリックします。

–トレースファイルのダウンロード先ディレクトリを指定するには、[Download all files] フィールドの横にある [Browse] ボタンをクリックし、ディレクトリまでナビゲートして、 [Open] をクリックします。デフォルトでは、<rtmt_install_directory>\<サーバ名またはサーバ IP アドレス>\<ダウンロード時刻> と指定されます。<rtmt_install_directory> には、RTMT のインストール先ディレクトリが指定されます。

–収集するトレースファイルの zip ファイルを作成するには、 [Zip File] チェックボックスをオンにします。

–収集したログファイルをサーバから削除するには、 [Delete Files on server] チェックボックスをオンにします。

• サーバからトレースファイルを削除するには、ウィンドウの右側のペインに表示されるファイルをクリックしてから、 [Delete] ボタンをクリックします。

• 特定のサービスまたはノードを更新するには、サーバ名またはサービスをクリックしてから、 [Refresh] ボタンをクリックします。リモート参照の準備ができたことを示すメッセージが表示されたら、 [Close] をクリックします。

• ツリー階層に表示されるすべてのサービスとノードを更新するには、 [Refresh All] ボタンをクリックします。リモート参照の準備ができたことを示すメッセージが表示されたら、 [Close] をクリックします。

追加情報

「関連項目」を参照してください。

Q931 Translator の使用方法

Cisco Unified Communications Manager では、ISDN トレースファイルを生成し、Cisco Unified Communications Manager インストレーションの接続に関する問題の診断とトラブルシューティングに役立てています。このログファイルには、Q.931 タイプのメッセージ（ISDN レイヤ 3 プロトコル）が含まれています。

メッセージ変換の機能は、Cisco Unified Communications Manager の System Diagnostic Interface（SDI; システム診断インターフェイス）ログファイルからの入力データをフィルタリングし、解析して Cisco IOS と同等のメッセージに変換することです。メッセージ変換では、XML とテキストファイルをサポートしています。

シスコサポートエンジニアは、メッセージ変換ツールを使用して、お客様から寄せられたデバッグ情報を Cisco IOS と同等の分かりやすいメッセージに変換します。

始める前に

次のいずれかの項の説明に従って、トレースファイルを収集します。

手順

ステップ 1 「Query Wizard の使用方法」の説明に従って Query Wizard を使用するか、「Local Browse の使用方法」の説明に従って Trace and Log Central 機能の [Local Browse] オプションを使用することにより、ログファイルエントリを表示します。

（注） CTIManager および Cisco Unified Communications Manager SDI トレースファイルには、Q931 メッセージを含めることができます。

ステップ 2 Q931 メッセージの変換を行うログエントリをクリックします。

ステップ 3 [Translate Q931 Messages] をクリックします。

選択したトレースファイルに ISDN メッセージが含まれていない場合、「No ISDN Messages in the File」というメッセージが表示されます。

選択したトレースファイルに ISDN メッセージが含まれている場合、[Q931 Translator] ダイアログボックスには、メッセージのリストが表示されます。

ステップ 4 次のいずれかのタスクを実行します。

• 特定のメッセージの詳細を表示するには、リストからそのメッセージを選択します。[Detailed Message] グループボックスに詳細が表示されます。

• 結果をフィルタリングするには、リストから Q931 メッセージを選択し、ドロップダウンリストボックスからオプション（[filter by gateway] など）を選択するか、[Filter by Search String] フィールドにテキストを入力します。フィルタを削除するには、[Clear Filter] をクリックします。フィルタをクリアすると、すべてのログが表示されます。

• [Q931 Translator] ダイアログボックスを閉じるには、 [Close] ボタンをクリックします。

追加情報

「関連項目」を参照してください。

QRT レポート情報の表示

Quality Report Tool（QRT）によって生成される IP Phone の問題に関するレポートは、QRT Viewer を使用して表示できます。QRT は、Cisco Unified IP Phone に関する音質および一般的な問題のレポートツールです。QRT ログファイルを収集した後、次の手順に従い、QRT Viewer を使用して Cisco Unified Communications Manager の IP Phone の問題に関するレポートを一覧表示できます。QRT Viewer では、生成される IP Phone の問題に関するレポートのフィルタリング、フォーマット、および表示を実行できます。QRT を設定および使用する方法の詳細については、『 Cisco Unified Communications Manager 機能およびサービスガイド 』を参照してください。

始める前に

QRT ログファイルを表示するには、サーバ上でファイルを表示するか、ご使用のコンピュータにファイルをダウンロードします。

次のいずれかの項の説明に従って、QRT ログファイルを収集または表示します。