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

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

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

• 統合ログファイルの生成

• HTTPS、SCP、FTP サーバーなどのユーザー指定のネットワークの場所にファイルをアップロードします。

TAC エンジニアは DS ファイルの作成者であり、整合性保護のためにデジタル署名します。各 DS ファイルには、システムによって割り当てられた固有の数値 ID があります。診断シグネチャ検索ツール (DSLT) は、さまざまな問題を監視およびトラブルシューティングするための適用可能なシグネチャを見つけるための単一のソースです。

開始する前に:

• DSLT からダウンロードした DS ファイルは 編集していない。変更するファイルは、整合性チェックエラーのためインストールに失敗します。

• ローカル ゲートウェイがメール通知を送信するために必要な簡易メール転送プロトコル (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 :@ priority 1 secure tls 
   end 

3. 通知する管理者のメールアドレスを環境変数 ds_email に設定します。

   configure terminal 
   call-home  
   diagnostic-signature 
   environment ds_email  
   end 

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

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

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

2. 「はい、はい、それは私です」と答えます。Gmail から「Google は、Google 以外のアプリを使用してアカウントにサインインするユーザーを防ぎました」というメールを受け取ります。

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

CPU 使用率の監視

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

1. SNMP を有効にするには、 show snmp コマンドを使用します。有効にしない場合は、 snmp-server manager コマンドを設定します。

   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@/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. show call-home diagnostic-signature コマンドを使用 して、署名が正常にインストールされたことを確認します。ステータス列の値が「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 は、60 秒ごとにクラウドにSIP トランクするローカル Webex Calling登録解除をチェックします。登録解除イベントが検出されると、メールとSyslog通知が生成され、登録解除が2回発生すると自動的にアンインストールされます。シグネチャをインストールするには、以下の手順に従ってください。

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@/DS_64117.xml bootflash: 

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

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

4. show call-home diagnostic-signature コマンドを使用 して、署名が正常にインストールされたことを確認します。状態の列には「登録済み」の値が必要です。

異常な通話切断の監視

このDSは、10分ごとにSNMPポーリングを行い、SIPエラー403、488、503による異常な通話切断を検出します。前回のポーリングからエラーカウントの増分が5以上になった場合、Syslogとメール通知が生成されます。シグネチャをインストールするには、以下の手順に従ってください。

1. SNMP が有効になっているかどうかを確認するには、 show snmp コマンドを使用します。有効になっていない場合は、 snmp-server manager コマンドを設定します。

   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@/DS_65221.xml bootflash:

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

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

5. show call-home diagnostic-signature コマンドを使用 して、署名が正常にインストールされたことを確認します。状態の列には「登録済み」の値が必要です。

診断署名をインストールして問題のトラブルシューティングを行う

診断署名 (DS) を使用して、問題を迅速に解決します。Cisco TAC エンジニアは、特定の問題のトラブルシューティング、問題の発生を検出、診断データの正しいセットを収集し、データを Cisco TAC ケースに自動的に転送するために必要なデバッグを可能にするための署名を作成しました。診断シグネチャ (DS) により、問題の発生を手動で確認する必要がなくなり、断続的および一時的な問題のトラブルシューティングが大幅に容易になります。

診断署名ルックアップ ツールを使用して、適用可能な署名を見つけ、自己解決するためにインストールすることができます。または、サポート エンゲージメントの一部として、TAC エンジニアが推奨する署名をインストールできます。

以下の例は、「%VOICE_IEC-3-GW: CCAPI: Internal Error (call spike threshold): SYSLOG=1.1.181.1.29.0" syslog を使用して、以下の手順を使用して、診断データの収集を自動化します。

1. 追加のDS環境変数 ds_fsurl_prefixを設定します。これは、収集された診断データがアップロードされるCisco TACファイルサーバ（cxd.cisco.com）のパスです。ファイルパス内のユーザー名はケース番号、パスワードはファイルアップロードトークンです。これらのトークンは、次のコマンドで Support Case Manager から取得できます。ファイルアップロードトークンは、必要に応じてSupport Case Managerの Attachments セクションで生成できます。

   configure terminal 
   call-home  
   diagnostic-signature 
   LocalGateway(cfg-call-home-diag-sign)environment ds_fsurl_prefix "scp://:@cxd.cisco.com"  
   end 

   例:

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

2. show snmp コマンドを使用して、SNMP が有効になっていることを確認します。有効になっていない場合は、 snmp-server manager コマンドを設定します。

   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@/DS_64224.xml bootflash: 
   copy ftp://username:password@/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. show call-home diagnostic-signature コマンドを使用して、署名が正常にインストールされたことを確認します。状態の列には「登録済み」の値が必要です。

   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

診断署名の実行を確認します

次のコマンドでは、ローカル ゲートウェイがシグニチャ内で定義されたアクションを実行している間、 show call-home diagnostic-signature コマンドの「ステータス」列が「実行中」に変わります。show call-home 診断署名 統計の出力は、診断署名が関心のあるイベントを検出してアクションを実行したかどうかを検証するための最適な方法です。「トリガーされた/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：

コール ホーム診断署名統計を表示する

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

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

トラブルシューティングのために診断署名を使用は、一般的に、いくつかの問題が発生した場合の検出後にアンインストールするために定義されます。署名を手動でアンインストールする場合は、 show call-home diagnostic-signature コマンドの出力から DS ID を取得し、次のコマンドを実行します。

call-home diagnostic-signature deinstall  

例:

call-home diagnostic-signature deinstall 64224 

Cisco IOS XE ゲートウェイをより適切に管理するには、Control Hub を介してゲートウェイを登録および管理することをお勧めします。オプションの構成です。登録すると、コントロール ハブの構成検証オプションを使用して、ローカル ゲートウェイの構成を検証し、構成の問題を特定できます。現在、この機能をサポートしているのは登録ベースのトランクのみです。

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

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

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

• Cisco ローカル ゲートウェイ構成の検証