IP Phone 78xx/88xx - 問題レポートツール (PRT: Problem Report Tool) ファイルの内容

Kenichi Ogami · ‎2020-03-28

はじめに
PRT ファイルの取得方法
PRT ファイルの内容
ファイルの種類
基本情報
設定ファイル
ログファイル
show コマンド実行結果
ログアーカイブ
backtraces / crash フォルダ
参考情報

はじめに

本ドキュメントは、Cisco IP Phone 7800/8800 シリーズにおいて、問題レポートツール (PRT: Problem Report Tool) で取得したファイルの内容について紹介します。PRT ファイルは多くの情報を含んでいるため、IP Phone のトラブルシューティング時には PRT ファイルを取得することを推奨します。

本ドキュメントは 2020/3/28 時点 (ファームウェアバージョン 12.7.1) の情報です。

PRT ファイルの取得方法

PRT ファイルの取得方法については、下記のドキュメントをご参照ください。IP Phone のボタン操作、IP Phone の Web GUI、Unified CM の Phone 設定画面 (Unified 12.5SU1 で実装予定) によって PRT ファイルを生成することができます。

Cisco Unified IP Phone 7800 / 8800 のログを問題レポートツール (PRT) で取得する方法

PRT ファイルの内容

ファイルの種類

PRT ファイルを生成すると、下記のフォーマットのファイル名でファイルが生成されます

prt-[YYYYMMDD]-[HHmmss]-[MAC Address].tar.gz

例：prt-20200328-173051-2834A2XXXYYY.tar.gz

PRT ファイルを解凍すると、下記のようなフォルダやファイルが展開されます（一部加工しています）。

基本情報 (例: description-20200328-173051.log) - IP Phone のモデル、MAC、シリアル番号、バージョン、ハードウェアリビジョンなど
設定ファイル (例: 2834A2XXXYYY.cnf.xml) - Unified CM からダウンロードした設定ファイル
ログファイル (例: logcat-20200328-173051.log) - コンソールログ (messages.xx を結合したもの)
show コマンド実行結果 (例: show-output-20200328-173051.log) - CPU、メモリ、アンレジスタ理由などを表示するための show コマンドの結果
ログアーカイブ (data/logsave/main フォルダ) - ログファイルのアーカイブ
バックトレース (data/logsave/backtraces フォルダ) - バックトレースが出力されている場合はこのフォルダに格納
クラッシュ (data/logsave/crash フォルダ) - クラッシュ時のアーカイブファイルを格納
以前のイメージ (data/logsave/lastimage フォルダ) - バージョンアップ前のログのアーカイブ

基本情報

基本情報として、description-[YYYYMMDD]-[HHmmss].log ファイルには、レポートが生成された日時、IP Phone のモデル、MAC、シリアル番号、バージョン、ハードウェアリビジョン、ユーザ ID、などの情報が含まれます。

description-20200328-173051.log

=============================================================
PRT Info
----------------------
Format version: 3.1
Sent to: 
User reported date: 02-28-2020
User reported time: 17:30
Firmware version: sip88xx.12-7-1-0001-393
Model number: CP-8861
Problem application: unknown
Power source: INLINE
User ID: tyamada
Device ID: SEP2834A2XXXYYY
Serial Number: FCH18XXXXXX
Phone web page: http://192.168.0.1/

=============================================================
Description
----------------------
PRT request from admin webpage

=============================================================
show inventory
----------------------

Class: phone 
PID: CP-8861 
DESCR: Cisco IP Phone 8861 
MAC: 2834A2XXXYYY
VID: V01
S/N: FCH18XXXXXX

=============================================================
show version
----------------------
Active Load Name: sip88xx.12-7-1-0001-393
Inactive Load Name: sip88xx.12-5-1SR3-74

設定ファイル

Unified CM からダウンロードした XML で記述された IP Phone の設定ファイルです。IP Phone および内線番号の設定などを確認することができます。

2834A2XXXYYY.cnf.xml

<?xml version="1.0" encoding="UTF-8"?>
<device xsi:type="axl:XIPPhone" ctiid="100" uuid="{b66cc242-3800-4339-9f1c-xxxxxxxxxxxx}">
<fullConfig>true</fullConfig>

省略

<organizationTopLevelDomain>ucapp.cisco.com</organizationTopLevelDomain>
<sipLines>
<line button="1" lineIndex="1">
<featureID>9</featureID>
<featureLabel>2001</featureLabel>
<proxy>USECALLMANAGER</proxy>
<port>5060</port>
<name>2001</name>
<displayName>CP8861</displayName>
<autoAnswer>
<autoAnswerEnabled>2</autoAnswerEnabled>
</autoAnswer>
<callWaiting>3</callWaiting>
<sharedLine>false</sharedLine>
<messageWaitingLampPolicy>3</messageWaitingLampPolicy>
<messageWaitingAMWI>0</messageWaitingAMWI>
<messagesNumber></messagesNumber>
<ringSettingIdle>4</ringSettingIdle>
<ringSettingActive>5</ringSettingActive>
<contact>71389181-b3e3-44cc-8593-xxxxxxxxxxxx</contact>
<forwardCallInfoDisplay>
<callerName>true</callerName>
<callerNumber>false</callerNumber>
<redirectedNumber>false</redirectedNumber>
<dialedNumber>true</dialedNumber>
</forwardCallInfoDisplay>
<maxNumCalls>4</maxNumCalls>
<busyTrigger>2</busyTrigger>
</line>
</sipLines>

省略

ログファイル

コンソールログ (messages.xxx を結合したファイル) を確認できます。デバッグログもこのファイルに含まれます。

logcat-20200328-173051.log

460 - Cisco Systems - Model=88xx Version=sip88xx.12-7-1-0001-393[TZ=JST-9:00] Sat Mar 28 17:30:01 2020
=============================================================[V01][HW ver: V01
][460]
3838 INF Mar 28 17:30:01.935698 syslogd forced rotation
3839 NOT Mar 28 17:30:01.974752 (5232-5232) sarch: -Archiving syslogs to /cisco/logsave/main max=999 
3840 NOT Mar 28 17:30:02.596509 (5269-5269) sarch: -dir size /cisco/logsave/main is 0 
3841 NOT Mar 28 17:30:03.051070 (5277-5277) sarch: -trying to remove oldest file 20200323_090002.tar.gz 
3842 NOT Mar 28 17:30:03.209921 (5291-5291) sarch: -dir size /cisco/logsave/main is 0 
3843 NOT Mar 28 17:30:03.669161 (5299-5299) sarch: -trying to remove oldest file 20200323_100001.tar.gz 
3844 NOT Mar 28 17:30:03.804774 (5314-5314) sarch: -dir size /cisco/logsave/main is 2072576 
3845 NOT Mar 28 17:30:04.340203 (5315-5315) sarch: -archiving /tmp/20200328_083002.tar.gz 
3846 NOT Mar 28 17:30:23.669436 (501-524) CDP-cdpRcvPkt(): deviceId is example.com
3847 DEB Mar 28 17:30:34.139104 (0-707) syslog-dbus_manager::Sleeping 60 seconds
3848 NOT Mar 28 17:30:44.304655 (30087-30315) JAVA-HTTP JNI| processRedirect: Redirecting to, /CGI/Java/Serviceability?adapter=device.statistics.device
3849 INF Mar 28 17:30:44.405628 (30087-30247) JAVA-MicroServletTask|cip.http.HttpMicroServletRequest:? - IN: getSession()
3850 INF Mar 28 17:30:44.616446 (30087-30247) JAVA-MicroServletTask|cip.http.HttpSession:? - IN: HttpSession()
3851 INF Mar 28 17:30:44.616902 (30087-30247) JAVA-MicroServletTask|cip.http.HttpSession:? - OUT: HttpSession()
3852 INF Mar 28 17:30:44.617075 (30087-30247) JAVA-MicroServletTask|MicroServletContainer:? - IN: insertSession()
3853 INF Mar 28 17:30:44.617183 (30087-30247) JAVA-MicroServletTask|MicroServletContainer:? - before session insertion
省略

show コマンド実行結果

問題レポートが生成されるタイミングで、下記の show コマンドが実行され、結果を show-output-[YYYYMMDD]-[HHmmss].log に出力します。

show cpu
show ice
show onboard status
show memory
show diskspace
show debug
show process
show socket
show driver
show accessories
show current time
show persistent time
show build time
show load detail
show load history
show sshAccess
show iprule
show ip link
show ip address
show dhcp
show cdp
show ipv6
show netsd
show route
show power
show dmesg
show vchiq_control 
show config network
show config security
show config power-save
show tech-sip
--------------- Show Tech Sip ----------------- 
------------- Show fsmdef -------------- 
------------- Show fsmxfr -------------- 
------------- Show fsmb2bcnf -------------- 
------------- Show fsmicom -------------- 
------------- Show fsmrelay -------------- 
------------- Show dcsm -------------- 
------------- Show fim -------------- 
------------- Show fsm -------------- 
------------- Show lsm -------------- 
------------- Show bulkreginfo -------------- 
------------- Show kpml -------------- 
------------- Show remote-cc -------------- 
------------- Show config-cache -------------- 
------------- Show sip-subscription-statistics -------------- 
------------- Show sip-subs-gsi -------------- 
------------- Show sip-publish-statistics -------------- 
------------- Show register -------------- 
------------- Show register-gsi -------------- 
------------- Show dialplan -------------- 
------------- Show adr -------------- 
------------- Show dnd-settings -------------- 
------------- Show cpr-memory -------------- 
------------- Show unreg-reason -------------- 
------------- Show edge-config -------------- 
------------- Show ti-connection -------------- 
------------- Show ice -------------- 
------------- Show hedge-info -------------- 
------------- Show crlf-keepalive -------------- 
show cpr-msgq
show cpr-memory statistics
show jvm lastoutofservice
show phone-information
show capabilities
Show Capabilities
show debug
show cast
show statistics network
show statistics access
show wifi info
show energy config
show energy status
show stream summary
show audio-path
show stream active all
show jvm ce
show vpn status
show vpn config
show vpn statistics
show contacts
show messages
show ringtones
show running-applications
show line all
show call summary all
show ui header
show ui window all
show ui softkey all
show timer
show applications
show feature all
show call-history grouped summary all

ログアーカイブ

ログファイルのアーカイブは [YYYYMMDD]_[HHmmss].tar.gz のファイル名で data/logsave/main フォルダに格納されます。

backtraces / crash フォルダ

クラッシュが発生した場合などに、これらのフォルダにファイルが格納されます。想定外の再起動が発生した場合はこのフォルダにバックトレースファイルやクラッシュ時のアーカイブファイルが残されていないか、残されている場合はファイルの生成日時を確認してください。