トラブルシューティングでのトレースログの使用
トレースを使用して IM and Presence Service および機能に関するシステムの問題をトラブルシューティングします。さまざまなサービス、機能、およびシステムコンポーネントに対して自動システム トレースを設定することができます。結果は、Cisco Unified Real-Time Monitoring Tool を使用して参照および表示ができるシステム ログに保存されます。また、コマンドライン インターフェイスを使用して、システム ログ ファイルのサブセットを取得し、自分の PC またはラップトップにアップロードして詳細な分析を行うことも可能です。
トレースを使用するには、まずシステムをトレース用に設定する必要があります。トレースを設定する方法の詳細については、Cisco Unified Serviceability 管理ガイドの「トレース」の章を参照してください。
トレースの設定後、以下の 2 つの方法のいずれかを使用して、トレース ファイルの内容を表示することができます。
-
Real-Time Monitoring Tool:Real-Time Monitoring Tool を使用して、システム トレースの結果として作成された個々のログ ファイルを参照および表示することができます。Real-Time Monitoring Tool の使用法の詳細については、『Cisco Unified Real-Time Monitoring Tool アドミニストレーション ガイド』を参照してください。
-
コマンドライン インターフェイス(CLI):システム トレースが設定されている場合は、CLI を使用してシステム ログからカスタマイズされたトレースを作成します。CLI を使用すると、カスタマイズされたトレース ファイルに含める特定の日付の指定が可能です。CLI はシステムから関連付けられたトレース ファイルを取得して、圧縮 zip ファイルに保存して、後で分析するために、PC またはらっぷトップにコピーすることができるため、システムによってログが上書きされることはありません。
このセクションの以降の表およびタスクでは、IM and Presence Service のトレース ログ ファイルを作成するための CLI コマンドの使用方法について説明します。
トレースを使用した一般的な IM and Presence の問題
以下の表では、IM and Presence Service に関する一般的な問題および、問題をトラブルシューティングするために実行することができるトレースの一覧が説明されています。
問題個所 ... |
これらのサービスのトレースの表示 |
追加手順 |
||
---|---|---|---|---|
ログイン認証 |
Client Profile Agent Cisco XCP Connection Manager Cisco XCP Router Cisco XCP Authentication Service Cisco Tomcat Security Logs |
ログおよび出力場所を作成するための CLI コマンドは、CLIを介した共通トレースを参照してください。 |
||
アベイラビリティ ステータス |
Cisco XCP Connection Manager Cisco XCP Router Cisco Presence Engine |
ログおよび出力場所を作成するための CLI コマンドは、CLIを介した共通トレースを参照してください。 |
||
IM の送受信 |
Cisco XCP Connection Manager Cisco XCP Router |
ログおよび出力場所を作成するための CLI コマンドは、CLIを介した共通トレースを参照してください。 |
||
連絡先リスト |
Cisco XCP Connection Manager Cisco XCP Router Cisco Presence Engine |
ログおよび出力場所を作成するための CLI コマンドは、CLIを介した共通トレースを参照してください。 |
||
チャット ルーム |
Cisco XCP Connection Manager Cisco XCP Router Cisco XCP Text Conferencing Manager |
ログおよび出力場所を作成するための CLI コマンドは、CLIを介した共通トレースを参照してください。 |
||
パーティション イントラドメイン フェデレーション |
Cisco XCP Router Cisco XCP SIP Federation Connection Manager Cisco SIP Proxy Cisco Presence Engine |
ログおよび出力場所を作成するための CLI コマンドは、CLIを介した共通トレースを参照してください。
|
||
XMPP ベースのドメイン間フェデレーション連絡先のアベイラビリティおよび IM の問題のトレース |
Cisco XCP Connection Manager Cisco XCP Router Cisco Presence Engine Cisco XCP XMPP Federation Connection Manager |
ログおよび出力場所を作成するための CLI コマンドは、CLIを介した共通トレースを参照してください。 XMPP フェデレーションが有効な各 IM and Presence Service ノードで、このトレースを実行する |
||
SIP ドメイン間フェデレーション連絡先のアベイラビリティおよび IM の問題のトレース |
Cisco XCP Connection Manager Cisco XCP Router Cisco Presence Engine Cisco SIP Proxy Cisco XCP SIP Federation Connection Manager |
ログおよび出力場所を作成するための CLI コマンドは、CLIを介した共通トレースを参照してください。 |
||
カレンダー トレース |
Cisco Presence Engine |
ログおよび出力場所を作成するための CLI コマンドは、CLIを介した共通トレースを参照してください。 |
||
クラスタ間同期トレースおよびクラスタ間トラブルシューティング |
Cisco Intercluster Sync Agent Cisco AXL Web Service Cisco Tomcat Security Log Cisco Syslog Agent |
クラスタ間のエラーを確認するには、 で、システムトラブルシューティングを実行します。 |
||
SIP フェデレーション トレース |
Cisco SIP Proxy Cisco XCP Router Cisco XCP SIP Federation Connection Manager |
ログおよび出力場所を作成するための CLI コマンドは、CLIを介した共通トレースを参照してください。 |
||
XMPP フェデレーション トレース |
Cisco XCP Router Cisco XCP XMPP Federation Connection Manager |
ログおよび出力場所を作成するための CLI コマンドは、CLIを介した共通トレースを参照してください。 |
||
高 CPU と低 VM のアラートのトラブルシューティング |
Cisco XCP Router Cisco XCP SIP Federation Connection Manager Cisco SIP Proxy Cisco Presence Engine Cisco Tomcat Security Log Cisco Syslog Agent |
その他のトラブルシューティングを行うには、以下の CLI コマンドを実行します。
以下の CLI を実行して、RIS(Real-Time Information Servic)データを取得します。
また、Cisco Unified IM and Presence Serviceability のアラームを設定することで、実行時のステータスとシステムの状態に関する情報をローカル システムのログに提供できます。 |
CLIを介した共通トレース
コマンドライン インタフェースを使用して、システムのトラブルシューティングを行うためのトレース ログ ファイルを作成します。CLI を使用して、トレースを実行するコンポーネントを選択して、<duration>を指定することができます。これは、ログ ファイルに含める、その日から過去にさかのぼる日数です。
以下の 2 つの表に、トレース ログ ファイルおよびログ出力場所の作成に使用できる CLI コマンドが提示されています。
-
IM and Presence Service
-
IM and Presence 機能
(注) |
CLI は、Cisco Unified Real-Time Monitoring Tool(RTMT)で表示可能であるのと同じ個々のトレース ファイルのサブセットを取得し、グループ化して単一の圧縮 zip ファイルに格納します。RTMT トレースの詳細は、RTMT を介した共通トレースを参照してください。 |
サービス |
ログを作成するための CLI |
CLI 出力ファイル |
---|---|---|
Cisco 監査ログ |
file build log cisco_audit_logs <duration> |
/epas/trace/log_cisco_audit_logs_*.tar.gz |
Cisco Client Profile Agent |
file build log cisco_client_profile_agent <duration> |
/epas/trace/log_cisco_client_profile_agent_*.tar.gz |
Cisco Cluster Manager |
file build log cisco_config_agent <duration> |
/epas/trace/log_cisco_cluster_manager_*.tar.gz |
Cisco Config Agent |
file build log cisco_config_agent<duration> |
/epas/trace/log_cisco_config_agent_*.tar.gz |
Cisco Database Layer Monitor |
file build log cisco_database_layer_monitor <duration> |
/epas/trace/log_cisco_database_layer_monitor_*.tar.gz |
Cisco Intercluster Sync Agent |
file build log cisco_inter_cluster_sync_agent <duration> |
/epas/trace/log_cisco_inter_cluster_sync_agent_*.tar.gz |
Cisco OAM Agent |
file build log cisco_oam_agent <duration> |
/epas/trace/log_cisco_oam_agent_*.gz |
Cisco Presence Engine |
file build log cisco_presence_engine <duration> |
/epas/trace/log_cisco_presence_engine_*.tar.gz |
Cisco RIS(Real-time Information Service)データ コレクタ |
file build log cisco_ris_data_collector <duration> |
/epas/trace/log_cisco_ris_data_collector_*.tar.gz |
Cisco サービス管理(CSM) |
file build log cisco_service_management <duration> |
/epas/trace/log_cisco_service_management_*.tar.gz |
Cisco SIP Proxy |
file build log cisco_sip_proxy <duration> |
/epas/trace/log_cisco_sip_proxy_*.tar.gz |
Cisco Sync Agent |
file build log cisco_sync_agent <duration> |
/epas/trace/log_cisco_sync_agent_*.tar.gz |
Cisco XCP Config Manager |
file build log cisco_xcp_config_mgr <duration> |
/epas/trace/log_cisco_xcp_config_mgr_*.tar.gz |
Cisco XCP Router |
file build log cisco_xcp_router <duration> |
/epas/trace/log_cisco_xcp_router_*.tar.gz |
機能名 |
ログを作成するための CLI |
CLI 出力ファイル |
---|---|---|
管理 GUI |
file build log admin_ui <duration> |
/epas/trace/log_admin_ui_*.tar.gz |
一括管理 |
file build log bat <duration> |
/epas/trace/log_bat_*.tar.gz |
同期 HTTP 上の Bidirectional-streams |
file build log bosh <duration> |
/epas/trace/log_bosh_*.tar.gz |
証明書 |
file build log certificates <duration> |
/epas/trace/log_certificates_ * gz |
設定 エージェント コア |
file build log cfg_agent_core <duration> |
/epas/trace/log_cfg_agent_core_*.tar.gz |
Customer Voice Portal |
file build log cvp <duration> |
/epas/trace/log_cvp_*.tar.gz |
ディレクトリ グループ |
file build log directory_groups <duration> |
/epas/trace/log_directory_groups_*.tar.gz |
ディザスタ リカバリ |
file build log disaster_recovery <duration> |
/epas/trace/log_disaster_recovery_*.tar.gz |
柔軟なIM アドレス |
file build log flexable_im_address <duration> |
/epas/trace/log_flexible_im_address_*.tar.gz |
汎用コア |
file build log general_core <duration> |
/epas/trace/log_general_core_*.tar.gz |
高可用性 |
file build log ha <duration> |
/epas/trace/log_ha_*.tar.gz |
高いCPU使用率 |
file build log high_cpu <duration> |
/epas/trace/log_high_cpu_*.tar.gz |
ハイ メモリ |
file build log high_memory <duration> |
/epas/trace/log_high_memory_*.tar.gz |
インスタント メッセージング データベース コア |
file build log imdb <duration> |
/epas/trace/log_imdb_core_*.tar.gz |
クラスタ間ピアリング |
file build log inter_cluster <duration> |
/epas/trace/log_inter_cluster_*.tar.gz |
マネージド ファイル転送 |
ファイルビルドのログ managed_file_transfer < 期間 > |
/epas/trace/log_managed_file_transfer_*.tar.gz |
Microsoft Exchange |
file build log msft_exchange <duration> |
/epas/trace/log_msft_exchange_ * gz |
メッセージ アーカイバ |
file build log msg_archiver <duration> |
/epas/trace/log_msg_archiver_*.tar.gz |
プレゼンス エンジン コア |
file build log pe_core <duration> |
/epas/trace/log_pe_core_*.tar.gz |
Presence and IM メッセージ交換 |
file build log presence_im_exchange <duration> |
/epas/trace/log_presence_im_exchange_*.tar.gz |
SIP ログインの問題 |
file build log pws <duration> |
/epas/trace/log_pws_*.tar.gz |
Remote Call Control(リモート呼制御) |
file build log remote_call_control <duration> |
/epas/trace/log_remote_call_control_*.tar.gz |
セキュリティの脆弱性 |
file build log sec_vulnerability <duration> |
/epas/trace/log_sec_vulnerability_*.tar.gz |
サービスアビリティの GUI |
ファイルビルドのログ serviceability_ui < 期間 > |
/epas/trace/log_serviceability_ui_*.tar.gz |
SIP ドメイン間フェデレーション |
file build log sip_inter_federation <duration> |
/epas/trace/log_sip_inter_federation_ * tar.gz |
SIP パーティション ドメイン間 フェデレーション |
file build log sip_partitioned_federation <duration> |
/epas/trace/log_sip_partitioned_federation_ *.tar.gz |
SIP プロキシ コア |
file build log sipd_core <duration> |
/epas/trace/log_sipd_core_*.tar.gz |
常設チャットの高可用性 |
file build log tc_ha <duration> |
/epas/trace/log_tc_ha_*.tar.gz |
常設チャット |
file build log text_conference <duration> |
/epas/trace/log_text_conference_*.tar.gz |
アップグレードの問題 |
file build log upgrade_issues <duration> |
/epas/trace/log_upgrade_issues_*.tar.gz |
ユーザ接続 |
file build log user_connectivity <duration> |
/epas/trace/log_user_connectivity_*.tar.gz |
名簿 |
file build log user_rosters <duration> |
/epas/trace/log_user_rosters_*.tar.gz |
XCP ルータ コア |
file build log xcp_core <duration> |
/epas/trace/log_xcp_core_*.tar.gz |
XMPP ドメイン間フェデレーション |
file build log xmpp_inter_federation <duration> |
/epas/trace/log_xmpp_inter_federation_*.tar.gz |
展開情報 |
file build log deployment_info <duration> |
/epas/trace/log_deployment_info_*.tar.gz |
CLI 経由のトレースの実行
CLI(コマンドライン インターフェイス)を介してカスタマイズしたトレース ファイルを作成するには、次の手順を使用します。CLI で duration パラメータを使用して、トレースに含める過去にさかのぼる日数を指定することができます。CLI は、システム ログのサブセットを取得します。
(注) |
SFTP サーバは、ファイル転送にのみに使用してください。 |
始める前に
システムにトレースが設定されている必要があります。トレースを設定する方法の詳細は、Cisco Unified Serviceability 管理ガイド の「Traces」の章を参照してください。
実行可能なトレースのリストを CLIを介した共通トレース で確認します。
手順
ステップ 1 |
コマンドライン インターフェイスにログインします。 |
ステップ 2 |
ログを作成するには、 たとえば、 |
ステップ 3 |
ログを取得するには、 たとえば、file get activelog epas/trace/log_cisco_cluster_manager__2016-09-30-09h41m37s.tar.gzとなります。 |
ステップ 4 |
システムの安定性を維持するために、取得後にログは削除します。ログを削除するには、 たとえば、 |
RTMT を介した共通トレース
次の表に、IM and Presence Service ノードと結果のログ ファイルで実行できる共通トレースを示します。Real-Time Monitoring Tool(RTMT)を使用してトレース ログ ファイルを表示することができます。
(注) |
CLI を使用すると、RTMT で表示可能であるのと同じ個々のトレース ファイルのサブセットを取得することができ、単一の圧縮 zip ファイルにまとめて保存することが可能です。CLI トレースの詳細は、CLIを介した共通トレースを参照してください。 |
サービス |
トレース ログのファイル名 |
---|---|
Cisco AXL Web サービス |
/tomcat/logs/axl/log4j/axl*.log |
Cisco Intercluster Sync Agent |
/epas/trace/cupicsa/log4j/icSyncAgent*.log |
Cisco Presence Engine |
/epas/trace/epe/sdi/epe*.txt.gz |
Cisco SIP Proxy |
/epas/trace/esp/sdi/esp*.txt.gz |
Cisco Syslog Agent |
/cm/trace/syslogmib/sdi/syslogmib*.txt |
Cisco Tomcat Security Log |
/tomcat/logs/security/log4/security*.log |
Cisco XCP Authentication Service |
/epas/trace/xcp/log/auth-svc-1*.log.gz |
Cisco XCP Config Manager |
/epas/trace/xcpconfigmgr/log4j/xcpconfigmgr*.log |
Cisco XCP Connection Manager |
/epas/trace/xcp/log/client-cm-1*.log.gz |
Cisco XCP Router |
/epas/trace/xcp/log/rtr-jsm-1*.log.gz |
Cisco XCP SIP Federation Connection Manager |
/epas/trace/xcp/log/sip-cm-3*.log |
Cisco XCP Text Conferencing Manager |
/epas/trace/xcp/log/txt-conf-1*.log.gz |
Cisco XCP XMPP Federation Connection Manager |
/epas/trace/xcp/log/xmpp-cm-4*.log |
Cluster Manager |
/platform/log/clustermgr*.log |
Cisco Client Profile Agent(CPA) |
/tomcat/logs/epassoap/log4j/EPASSoap*.log |
dbmon |
/cm/trace/dbl/sdi/dbmon*.txt |