診断署名(DS)は、IOS XE ベースのローカル ゲートウェイでよく発生する問題をプロアクティブに検出し、イベントに関するメール、syslog、またはターミナルメッセージ通知を生成します。 さらに、DS をインストールして診断データ収集を自動化し、収集したデータを Cisco TAC ケースに転送して解決時間を短縮することもできます。

診断署名（DS）は、問題のトリガーイベントと問題を通知、トラブルシューティング、および修正するために取られるアクションに関する情報を含む XML ファイルです。 syslog メッセージ、SNMP イベント、および特定の show コマンド出力の定期的なモニタリングを使用して、問題検出ロジックを定義できます。

アクション タイプには、次の show コマンド出力の収集が含まれます。

• 統合ログファイルを生成する

• HTTPS、SCP、FTP サーバなどのユーザー提供のネットワークロケーションにファイルをアップロードします。

TAC エンジニアは DS ファイルを作成し、整合性保護のためデジタル署名します。 各 DS ファイルには、システムによって割り当てられた固有の数値 ID があります。 Diagnostic Signatures Lookup ツール（DSLT）は、さまざまな問題の監視とトラブルシューティングに適切な署名を見つけるための単一の情報源です。

開始する前に:

• ダウンロードした DS ファイルは編集しないでください。 DSLTを選択します。 変更したファイルは、整合性チェックエラーのためインストールに失敗します。

• ローカル ゲートウェイがメール通知を送信するために必要な Simple Mail Transfer Protocol (SMTP) サーバー。

• メール通知にセキュアなSMTPサーバーを使用する場合は、ローカルゲートウェイで IOS XE 17.6.1 以上が実行されていることを確認してください。

前提条件

IOS XE 17.6.1a 以降を実行しているローカル ゲートウェイ

1. 診断署名はデフォルトで有効になっています。

2. デバイスが Cisco IOS XE 17.6.1a 以降を実行している場合、プロアクティブな通知を送信するために使用する、セキュアな電子メールサーバを設定します。

   configure terminal 
   call-home  
   mail-server <username>:<pwd>@<email server> priority 1 secure tls 
   end 

3. 環境変数を構成しますds_emailを通知する管理者のメールアドレスを入力します。

   configure terminal 
   call-home  
   diagnostic-signature 
   environment ds_email <email address> 
   end 

以下は、Cisco IOS XE 17.6.1a 以降で実行されているローカル ゲートウェイの設定例で、プロアクティブな通知をtacfaststart@gmail.com 安全なSMTPサーバーとしてGmailを使用:

Cisco IOS XE Bengaluru 17.6.x 以降のバージョンを使用することをお勧めします。

call-home  
mail-server tacfaststart:password@smtp.gmail.com priority 1 secure tls 
diagnostic-signature 
environment ds_email "tacfaststart@gmail.com" 

Cisco IOS XE ソフトウェアで実行されるローカルゲートウェイは OAuth をサポートする一般的な Web ベースの Gmail クライアントではないため、専用の Gmail アカウント設定を構成し、デバイスからのメールを適切に処理するための専用権限を指定する必要があります。

1. に移動 Googleアカウントの管理 > セキュリティを選択し、[安全性の低いアプリアクセス]設定をオンにします。

2. 「Google 以外のアプリを使って第三者があなたのアカウントにサインインすることができなくなりました」というメールが Gmail から送られてきたら、「はい、それは私です」と回答します。

プロアクティブ モニタリングのための診断署名をインストールする

高いCPU使用率の監視

この DS は、SNMP OID 1.3.6.1.4.1.9.2.1.56 を使用して、CPU 使用率を 5 秒間追跡します。 使用率が 75% 以上に達すると、すべてのデバッグが無効になり、ローカルゲートウェイにインストールされている診断署名がすべてアンインストールされます。 下記の手順を実行して署名をインストールします。

1. を使用する SNMPを表示 コマンドで SNMP を有効にします。 有効にしない場合は、snmpサーバーマネージャ コマンド

   show snmp 
   %SNMP agent not enabled 
   
   config t 
   snmp-server manager 
   end 
   
   show snmp 
   Chassis: ABCDEFGHIGK 
   149655 SNMP packets input 
       0 Bad SNMP version errors 
       1 Unknown community name 
       0 Illegal operation for community name supplied 
       0 Encoding errors 
       37763 Number of requested variables 
       2 Number of altered variables 
       34560 Get-request PDUs 
       138 Get-next PDUs 
       2 Set-request PDUs 
       0 Input queue packet drops (Maximum queue size 1000) 
   158277 SNMP packets output 
       0 Too big errors (Maximum packet size 1500) 
       20 No such name errors 
       0 Bad values errors 
       0 General errors 
       7998 Response PDUs 
       10280 Trap PDUs 
   Packets currently in SNMP process input queue: 0 
   SNMP global trap: enabled 
   

2. Diagnostic Signatures Lookup Tool の以下のドロップダウンオプションを使用して、DS 64224 をダウンロードします。

   フィールド名	フィールド値
   プラットフォーム	Cisco 4300、4400 ISR シリーズ、または Cisco CSR 1000V シリーズ
   製品	Webex Calling ソリューションの CUBE Enterprise
   問題の範囲	パフォーマンス
   問題の種類	メール通知での高CPU使用率。

3. DS XML ファイルをローカルゲートウェイフラッシュにコピーします。

   LocalGateway# copy ftp://username:password@<server name or ip>/DS_64224.xml bootflash: 

   次の例は、 FTPサーバーからローカルゲートウェイにファイルをコピーする方法を示しています。

   copy ftp://user:pwd@192.0.2.12/DS_64224.xml bootflash: 
   Accessing ftp://*:*@ 192.0.2.12/DS_64224.xml...! 
   [OK - 3571/4096 bytes] 
   3571 bytes copied in 0.064 secs (55797 bytes/sec) 
   

4. ローカルゲートウェイに DS XML ファイルをインストールします。

   call-home diagnostic-signature load DS_64224.xml 
   Load file DS_64224.xml success 

5. イベント、登録者、出席者にすばやくアクセスするため、 call-home 診断署名の表示を実行して、署名が正常にインストールされたことを確認します。 ステータス列の値が「registered」になっているはずです。

   show call-home diagnostic-signature  
   Current diagnostic-signature settings: 
   Diagnostic-signature: enabled 
   Profile: CiscoTAC-1 (status: ACTIVE) 
   Downloading  URL(s):  https://tools.cisco.com/its/service/oddce/services/DDCEService 
   Environment variable: 
   ds_email: username@gmail.com 

   DSes をダウンロード：

   DS ID	DS 名	リビジョン	ステータス	最終更新日時（GMT+00:00）
   64224	DS_LGW_CPU_MON75	0.0.10	登録済み	2020-11-07 22:05:33

   トリガーされると、この署名によって、この署名そのものを含む実行中のすべての DS がアンインストールされます。 必要に応じて、DS 64224 を再インストールして、ローカル ゲートウェイでの高い CPU 使用率の監視を継続します。

SIP トランク登録のモニタリング

この DS は、 Webex Callingクラウドをもつローカルゲートウェイ SIP トランクの登録解除を 60 秒ごとにチェックします。 登録解除イベントが検出されると、メールと syslog 通知が生成され、登録解除が 2 回発生した後に DS 自体がアンインストールされます。 署名をインストールするには、以下の手順を使用します。

1. Diagnostic Signatures Lookup Tool の以下のドロップダウンオプションを使用して、DS 64117 をダウンロードします。

   フィールド名	フィールド値
   プラットフォーム	Cisco 4300、4400 ISR シリーズ、または Cisco CSR 1000V シリーズ
   製品	Webex Calling ソリューションの CUBE Enterprise
   問題の範囲	SIP-SIP
   問題の種類	メール通知による SIP トランクの登録解除。

2. DS XML ファイルをローカルゲートウェイにコピーします。

   copy ftp://username:password@<server name or ip>/DS_64117.xml bootflash: 

3. ローカルゲートウェイに DS XML ファイルをインストールします。

   call-home diagnostic-signature load DS_64117.xml 
   Load file DS_64117.xml success 
   LocalGateway#  

4. イベント、登録者、出席者にすばやくアクセスするため、 call-home 診断署名の表示を実行して、署名が正常にインストールされたことを確認します。 ステータス列の値が「registered」になっている必要があります。

異常な通話切断の監視

この DS は、10 分おきに SNMP ポーリングを使用して、SIP エラー 403、488、503 の異常な通話切断を検出します。  エラーカウントが前回の投票から 5 以上増えている場合、syslog とメール通知が生成されます。 下記の手順を実行して、署名をインストールしてください。

1. を使用する SNMPを表示 コマンドを使用して、SNMP が有効になっているかどうかを確認します。 有効になっていない場合は、snmpサーバーマネージャ コマンド

   show snmp 
   %SNMP agent not enabled 
    
   
   config t 
   snmp-server manager 
   end 
   
   show snmp 
   Chassis: ABCDEFGHIGK 
   149655 SNMP packets input 
       0 Bad SNMP version errors 
       1 Unknown community name 
       0 Illegal operation for community name supplied 
       0 Encoding errors 
       37763 Number of requested variables 
       2 Number of altered variables 
       34560 Get-request PDUs 
       138 Get-next PDUs 
       2 Set-request PDUs 
       0 Input queue packet drops (Maximum queue size 1000) 
   158277 SNMP packets output 
       0 Too big errors (Maximum packet size 1500) 
       20 No such name errors 
       0 Bad values errors 
       0 General errors 
       7998 Response PDUs 
       10280 Trap PDUs 
   Packets currently in SNMP process input queue: 0 
   SNMP global trap: enabled 
   

2. Diagnostic Signatures Lookup Tool の以下のオプションを使用して、DS 65221 をダウンロードします。

   フィールド名	フィールド値
   プラットフォーム	Cisco 4300、4400 ISR シリーズ、または Cisco CSR 1000V シリーズ
   製品	Webex Calling ソリューションの CUBE Enterprise
   問題の範囲	パフォーマンス
   問題の種類	メールおよび Syslog 通知による SIP の異常な通話切断の検出

3. DS XML ファイルをローカルゲートウェイにコピーします。

   copy ftp://username:password@<server name or ip>/DS_65221.xml bootflash:

4. ローカルゲートウェイに DS XML ファイルをインストールします。

   call-home diagnostic-signature load DS_65221.xml 
   Load file DS_65221.xml success 
   

5. イベント、登録者、出席者にすばやくアクセスするため、 call-home 診断署名の表示を実行して、署名が正常にインストールされたことを確認します。 ステータス列の値が「registered」になっている必要があります。

問題をトラブルシューティングするための診断署名をインストールする

診断署名（DS）を使用して、問題を迅速に解決します。 特定の問題のトラブルシューティング、問題発生の検出、診断データの適切なセットの収集、およびCisco TACケースへのデータの自動転送に必要なデバッグを可能にする複数の署名をCisco TACエンジニアが作成しました。 診断署名（DS）は、問題の発生を手動で確認する必要性を排除し、断続的および一時的な問題のトラブルシューティングをはるかに容易にします。

また、 Diagnostic Signatures Lookup ツール特定の問題を自分で解決するために、適切な署名を見つけ、インストールするか、サポート契約の一部として TAC エンジニアによって推奨される署名をインストールできます。

以下の例は、「%VOICE_IEC-3-GW: CCAPI: Internal Error (call spike threshold): IEC=1.1.181.1.29.0」の syslog 発生を検出し、以下のステップを使用して診断データ収集を自動化します。

1. 追加の DS 環境変数を構成しますds_fsurl_prefix収集された診断データがアップロードされるCisco TACファイルサーバーパス (cxd.cisco.com) です。 ファイルパス内のユーザ名はケース番号で、パスワードはファイル アップロード トークンです。これはサポートケースマネージャーを次のコマンドで実行できます。 必要に応じて、サポートケースマネージャの [添付] セクションでファイルアップロードトークンを生成できます。

   configure terminal 
   call-home  
   diagnostic-signature 
   LocalGateway(cfg-call-home-diag-sign)environment ds_fsurl_prefix "scp://<case number>:<file upload token>@cxd.cisco.com"  
   end 

   例:

   call-home  
   diagnostic-signature 
   environment ds_fsurl_prefix " environment ds_fsurl_prefix "scp://612345678:abcdefghijklmnop@cxd.cisco.com"  

2. SNMP がSNMPを表示 コマンド 有効になっていない場合は、snmpサーバーマネージャ コマンド

   show snmp 
   %SNMP agent not enabled 
    
    
   config t 
   snmp-server manager 
   end 

3. CPU使用率が高い期間中のすべてのデバッグと診断署名を無効にする予防策として、高CPUモニタリング DS 64224 をインストールしてください。 Diagnostic Signatures Lookup Tool の以下のオプションを使用して、DS 64224 をダウンロードします。

   フィールド名	フィールド値
   プラットフォーム	Cisco 4300、4400 ISR シリーズ、または Cisco CSR 1000V シリーズ
   製品	Webex Calling ソリューションの CUBE Enterprise
   問題の範囲	パフォーマンス
   問題の種類	メール通知での高CPU使用率。

4. Diagnostic Signatures Lookup Tool の以下のオプションを使用して、DS 65095 をダウンロードします。

   フィールド名	フィールド値
   プラットフォーム	Cisco 4300、4400 ISR シリーズ、または Cisco CSR 1000V シリーズ
   製品	Webex Calling ソリューションの CUBE Enterprise
   問題の範囲	Syslog
   問題の種類	Syslog - %VOICE_IEC-3-GW: CCAPI: Internal Error (Call spike threshold): IEC=1.1.181.1.29.0

5. DS XML ファイルをローカルゲートウェイにコピーします。

   copy ftp://username:password@<server name or ip>/DS_64224.xml bootflash: 
   copy ftp://username:password@<server name or ip>/DS_65095.xml bootflash: 

6. ローカルゲートウェイに、高 CPU モニタリング DS 64224、DS 65095 XML ファイルの順にインストールします。

   call-home diagnostic-signature load DS_64224.xml 
   Load file DS_64224.xml success 
    
   call-home diagnostic-signature load DS_65095.xml 
   Load file DS_65095.xml success 
   

7. 署名が正常にインストールされたことを確認してください。 call-home 診断署名の表示します。 ステータス列の値が「registered」になっている必要があります。

   show call-home diagnostic-signature  
   Current diagnostic-signature settings: 
   Diagnostic-signature: enabled 
   Profile: CiscoTAC-1 (status: ACTIVE) 
   Downloading  URL(s):  https://tools.cisco.com/its/service/oddce/services/DDCEService 
   Environment variable: 
              ds_email: username@gmail.com 
              ds_fsurl_prefix: scp://612345678:abcdefghijklmnop@cxd.cisco.com 

   ダウンロードされた DSes：

   DS ID	DS 名	リビジョン	ステータス	最終更新日時（GMT+00:00）
   64224 00:07:45	DS_LGW_CPU_MON75	0.0.10	登録済み	2020 年 11 月 08 日
   65095 00:12:53	DS_LGW_IEC_Call_spike_threshold	0.0.12	登録済み	2020 年 11 月 08 日

診断署名の実行を確認する

次のコマンドでは、[状態] 列のcall-home 診断署名の表示ローカル ゲートウェイが署名内で定義されたアクションを実行している間、コマンドは「実行中」に変わります。 出力は次のとおりですCall-home 診断署名統計の表示は、診断署名が対象イベントを検出してアクションを実行するかどうかを検証するための最適な方法です。 [Triggered/Max/Deinstall] 列には、指定した署名がイベントをトリガーした回数、定義済みのイベント最大検出回数、トリガーされたイベントの検出後に署名がアンインストールされるかどうかが表示されます。

show call-home diagnostic-signature  
Current diagnostic-signature settings: 
Diagnostic-signature: enabled 
Profile: CiscoTAC-1 (status: ACTIVE) 
Downloading  URL(s):  https://tools.cisco.com/its/service/oddce/services/DDCEService 
Environment variable: 
           ds_email: carunach@cisco.com 
           ds_fsurl_prefix: scp://612345678:abcdefghijklmnop@cxd.cisco.com 

ダウンロードされた DSes：

Call-home 診断署名統計の表示

診断署名の実行中に送信される通知メールには、問題の種類、デバイスの詳細、ソフトウェアバージョン、実行中の構成、特定の問題のトラブルシューティングに関連する show コマンド出力などの重要な情報が含まれています。

診断署名をアンインストールする

トラブルシューティング目的で診断署名を使用する場合、通常、診断署名はいくつかの問題の発生が検出された後にアンインストールするように定義されます。 署名を手動でアンインストールする場合は、コールホーム診断署名を表示コマンドを実行し、次のコマンドを実行します。

call-home diagnostic-signature deinstall <DS ID> 

例:

call-home diagnostic-signature deinstall 64224 

展開でよく見られる問題に基づいて、Diagnostics Signatures Lookup Tool に新しい署名が定期的に追加されます。 TAC では現在、新しいカスタム署名の作成リクエストをサポートしていません。

Cisco IOS XE ゲートウェイの管理を改善するため、コントロールハブを通じてゲートウェイを登録し、管理することを推奨します。 これはオプションの設定です。 登録すると、コントロール ハブの設定検証オプションを使用して、ローカル ゲートウェイ構成を検証し、構成の問題を特定することができます。 現在、この機能をサポートしているのは登録ベースのトランクだけです。

詳細については、以下を参照してください。

• Cisco IOS マネージド ゲートウェイを Webex Cloud に登録する

• マネージド ゲートウェイにサービスを割り当てる

• Ciscoローカル ゲートウェイ設定の検証