Les signatures de diagnostic (DS) détectent de manière proactive les problèmes fréquemment observés dans la passerelle locale IOS XE et génèrent une notification par courrier électronique, syslog ou message de terminal de l'événement. Vous pouvez également installer DS pour automatiser la collecte des données de diagnostic et transférer les données collectées au Service d’assistance technique Cisco (CAT) pour accélérer le temps de résolution.

Les signatures de diagnostic (DS) sont des fichiers XML qui contiennent des informations sur les événements déclencheurs de problèmes et les actions à prendre pour informer, dépanner et résoudre le problème. Vous pouvez définir la logique de détection des problèmes à l'aide des messages syslog, des événements SNMP et par la surveillance périodique des sorties de commandes spécifiques.

Les types d'action incluent la collecte des sorties de la commande show :

• Génération d'un fichier journal consolidé

• Télécharger le fichier vers un emplacement réseau fourni par l'utilisateur tel que HTTPS, SCP et serveur FTP.

Les ingénieurs TAC créent les fichiers DS et les signent numériquement pour la protection de l'intégrité. Chaque fichier DS possède un identifiant numérique unique attribué par le système. Outil de recherche de signatures de diagnostic (DSLT) est une source unique pour trouver les signatures applicables pour la surveillance et le dépannage de divers problèmes.

Avant de commencer :

• Ne modifiez pas le fichier DS que vous téléchargez à partir de DSLT . Les fichiers que vous modifiez échouent à l'installation en raison de l'erreur de vérification d'intégrité.

• Un serveur SMTP (Simple Mail Transfer Protocol) dont vous avez besoin pour que la passerelle locale envoie des notifications par courrier électronique.

• Assurez-vous que la passerelle locale exécute IOS XE 17.6.1 ou version ultérieure si vous souhaitez utiliser le serveur SMTP sécurisé pour les notifications par courrier électronique.

Conditions requises

Passerelle locale exécutant IOS XE 17.6.1a ou une version plus récente

1. Les signatures de diagnostic sont activées par défaut.

2. Configurez le serveur de messagerie électronique sécurisé à utiliser pour envoyer une notification proactive si le périphérique exécute Cisco IOS XE 17.6.1a ou une version plus récente.

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

3. Configurer la variable d'environnementds_email avec l'adresse électronique de l'administrateur pour vous avertir.

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

Ce qui suit montre un exemple de configuration d'une passerelle locale exécutée sur Cisco IOS XE 17.6.1a ou une version plus récente pour envoyer les notifications proactives à tacfaststart@gmail.com en utilisant Gmail comme serveur SMTP sécurisé :

Nous vous recommandons d'utiliser Cisco IOS XE Bengaluru 17.6.x ou versions ultérieures.

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

Une passerelle locale exécutée sur le logiciel Cisco IOS XE n'est pas un client Gmail Web typique qui prend en charge OAuth, nous devons donc configurer un paramètre de compte Gmail spécifique et fournir une autorisation spécifique pour que le courrier électronique du périphérique soit traité correctement :

1. Aller à Gérer le compte Google > Sécurité et activer le paramètre Accès moins sécurisé à l’application.

2. Répondez « Oui, c'était moi » lorsque vous recevez un e-mail de Gmail indiquant « Google a empêché quelqu'un de se connecter à votre compte à l'aide d'une application autre que Google ».

Installer des signatures de diagnostic pour une surveillance proactive

Surveillance de l’utilisation élevée du processeur

Cette DS suit l’utilisation du processeur pendant cinq secondes à l’aide de l’OID SNMP 1.3.6.1.4.1.9.2.1.56. Lorsque l'utilisation atteint 75 % ou plus, il désactive tous les débogages et désinstalle toutes les signatures de diagnostic qui sont installées dans la passerelle locale. Suivez les étapes ci-dessous pour installer la signature.

1. Utiliser le afficher snmp pour activer SNMP. Si vous ne l'activez pas, configurez le gestionnaire snmp-serveur commande.

   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. Téléchargez le DS 64224 en utilisant les options déroulantes suivantes dans Outil de recherche de signatures de diagnostic :

   Nom du champ	Valeur du champ
   Plateforme	Cisco séries 4300, 4400 ISR, ou Cisco série CSR 1000V
   Produit	CUBE Enterprise dans la solution Webex Calling
   Problématique	Performances
   Type de problème	Utilisation élevée du processeur avec notification par courrier électronique.

3. Copiez le fichier DS XML sur le flash de la passerelle locale.

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

   L'exemple suivant montre la copie du fichier à partir d'un serveur FTP vers la passerelle locale.

   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. Installez le fichier DS XML dans la passerelle locale.

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

5. Utilisez le afficher la signature de diagnostic de l'appel vers le centre pour vérifier que la signature est correctement installée. La colonne d’état doit avoir une valeur « enregistré ».

   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 

   Télécharger les SD :

   ID de la SD	Nom de la SD	Révision	Statut	Dernière mise à jour (GMT+00:00)
   64224	DS_LGW_CPU_MON75	0.0.10	Inscrit(s)	2020-11-07 22:05:33

   Lorsqu’elle est déclenchée, cette signature désinstalle toutes les SD en cours d’exécution, y compris elle-même. Si nécessaire, réinstallez DS 64224 pour continuer à surveiller l’utilisation élevée du CPU sur la passerelle locale.

Surveillance de l'enregistrement des trunk SIP

Ce DS vérifie la désinscription d'une jonction SIP de passerelle locale avec le cloud Webex Calling toutes les 60 secondes. Une fois que l'événement de désinscription est détecté, il génère un courrier électronique et une notification syslog et se désinstalle après deux occurrences de désinscription. Suivez les étapes ci-dessous pour installer la signature :

1. Téléchargez DS 64117 en utilisant les options déroulantes suivantes dans L’outil de recherche de signatures de diagnostic :

   Nom du champ	Valeur du champ
   Plateforme	Cisco séries 4300, 4400 ISR ou Cisco série CSR 1000V Produit
   Produit	CUBE Enterprise dans la solution Webex Calling
   Problématique	SIP-SIP
   Type de problème	Annulation de l'enregistrement de la ligne réseau SIP avec notification par courrier électronique.

2. Copiez le fichier DS XML sur la passerelle locale.

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

3. Installez le fichier DS XML dans la passerelle locale.

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

4. Utilisez le afficher la signature de diagnostic de l'appel vers le centre pour vérifier que la signature est correctement installée. La colonne d'état doit avoir une valeur « enregistrée ».

Surveillance des déconnexions anormales des appels

Cette SD utilise l’interrogation SNMP toutes les 10 minutes pour détecter les déconnexions d’appel anormales avec les erreurs SIP 403, 488 et 503.  Si l'incrément du nombre d'erreurs est supérieur ou égal à 5 à partir du dernier sondage, il génère un journal système et une notification par courrier électronique. Veuillez suivre les étapes ci-dessous pour installer la signature.

1. Utiliser le afficher snmp pour vérifier si SNMP est activé. S'il n'est pas activé, configurez le gestionnaire snmp-serveur commande.

   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. Téléchargez le DS 65221 en utilisant les options suivantes dans l’outil de recherche des signatures de diagnostic :

   Nom du champ	Valeur du champ
   Plateforme	Cisco séries 4300, 4400 ISR ou Cisco série CSR 1000V Produit
   Produit	CUBE Enterprise dans la solution Webex Calling
   Problématique	Performances
   Type de problème	Détection de déconnexion d'appel anormale SIP avec notification par courrier électronique et Syslog.

3. Copiez le fichier DS XML sur la passerelle locale.

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

4. Installez le fichier DS XML dans la passerelle locale.

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

5. Utilisez le afficher la signature de diagnostic de l'appel vers le centre pour vérifier que la signature est correctement installée. La colonne d'état doit avoir une valeur « enregistrée ».

Installer des signatures de diagnostic pour résoudre un problème

Utilisez les signatures de diagnostic (DS) pour résoudre les problèmes rapidement. Les ingénieurs Cisco TAC ont créé plusieurs signatures qui permettent les débogages nécessaires pour résoudre un problème donné, détecter l'occurrence du problème, collecter le bon ensemble de données de diagnostic et transférer les données automatiquement vers le boîtier Cisco TAC . Les signatures de diagnostic (DS) éliminent la nécessité de vérifier manuellement l’occurrence du problème et facilitent grandement le dépannage des problèmes intermittents et transitoires.

Vous pouvez utiliser le Outil de recherche de signatures de diagnostic pour trouver les signatures applicables et les installer pour résoudre automatiquement un problème donné ou vous pouvez installer la signature qui est recommandée par l'ingénieur TAC dans le cadre de l'engagement de support.

Voici un exemple de la manière de trouver et d’installer un DS pour détecter l’occurrence "%VOICE_IEC-3-GW : CCAPI : Erreur interne (seuil de pointe d’appel) : IEC=1.1.181.1.29.0" syslog et automatisez la collecte des données de diagnostic en procédant comme suit :

1. Configurer une variable d'environnement DS supplémentaireds_fsurl_prefix qui est le chemin du serveur de fichiers Cisco TAC (cxd.cisco.com) vers lequel les données de diagnostic collectées sont téléchargées. Le nom d'utilisateur dans le chemin du fichier est le numéro de dossier et le mot de passe est le jeton de téléchargement de fichier qui peut être récupéré à partir de Gestionnaire de cas d'assistance dans la commande suivante. Le jeton de téléchargement de fichier peut être généré dans la section Pièces jointes du gestionnaire de cas de support, selon les besoins.

   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 

   Exemple :

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

2. Assurez-vous que SNMP est activé à l'aide du afficher snmp commande. S'il n'est pas activé, configurez le gestionnaire snmp-serveur commande.

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

3. Assurez-vous d'installer le DS 64224 de surveillance élevée du processeur en tant que mesure proactive pour désactiver toutes les signatures de débogage et de diagnostic pendant la période d'utilisation élevée du processeur. Téléchargez DS 64224 en utilisant les options suivantes dans L’outil de recherche de signatures de diagnostic :

   Nom du champ	Valeur du champ
   Plateforme	Cisco séries 4300, 4400 ISR, ou Cisco série CSR 1000V
   Produit	CUBE Enterprise dans la solution Webex Calling
   Problématique	Performances
   Type de problème	Utilisation élevée du processeur avec notification par courrier électronique.

4. Téléchargez DS 65095 en utilisant les options suivantes dans L’outil de recherche de signatures de diagnostic :

   Nom du champ	Valeur du champ
   Plateforme	Cisco séries 4300, 4400 ISR, ou Cisco série CSR 1000V
   Produit	CUBE Enterprise dans la solution Webex Calling
   Problématique	Journaux du système (Syslogs)
   Type de problème	Syslog - %VOICE_IEC-3-GW : CCAPI : Erreur interne (seuil de pointe d’appel) : IEC=1.1.181.1.29.0

5. Copier les fichiers XML DS sur la passerelle locale.

   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. Installez le fichier XML de surveillance de l’unité centrale haute DS 64224 puis DS 65095 dans la passerelle locale.

   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. Vérifiez que la signature est installée avec succès à l'aide du afficher la signature de diagnostic de l'appel vers le centre commande. La colonne d'état doit avoir une valeur « enregistrée ».

   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 

   SD téléchargées :

   ID de la SD	Nom de la SD	Révision	Statut	Dernière mise à jour (GMT+00:00)
   64224 00:07:45	DS_LGW_CPU_MON75	0.0.10	Inscrit(s)	08-11-2020
   65095 00:12:53	DS_LGW_IEC_Call_spike_threshold	0.0.12	Inscrit(s)	08-11-2020

Vérifier l'exécution des signatures de diagnostic

Dans la commande suivante, la colonne « Statut » du afficher la signature de diagnostic de l'appel vers le centre La commande passe à « en cours d'exécution » pendant que la passerelle locale exécute l'action définie dans la signature. La sortie de afficher les statistiques de signature de diagnostic d'appel vers le bas est le meilleur moyen de vérifier si une signature de diagnostic détecte un événement d'intérêt et exécute l'action. La colonne « Déclenché/Max/Désinstaller » indique le nombre de fois où la signature donnée a déclenché un événement, le nombre maximum de fois où elle est définie pour détecter un événement et si la signature se désinstalle d'elle-même après avoir détecté le nombre maximum d'événements déclenchés.

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 

SD téléchargées :

afficher les statistiques de signature de diagnostic d'appel vers le bas

Le message électronique de notification qui est envoyé pendant l'exécution de la signature de diagnostic contient des informations clés telles que le type de problème, les détails du périphérique, la version du logiciel, la configuration en cours et les sorties de la commande show qui sont pertinentes pour résoudre le problème donné.

Désinstaller les signatures de diagnostic

Utiliser les signatures de diagnostic à des fins de dépannage sont généralement définies pour être désinstallées après la détection de certains problèmes. Si vous souhaitez désinstaller une signature manuellement, récupérez le DS ID à partir de la sortie du afficher la signature de diagnostic d'appel à domicile et exécuter la commande suivante :

call-home diagnostic-signature deinstall <DS ID> 

Exemple :

call-home diagnostic-signature deinstall 64224 

De nouvelles signatures sont ajoutées à l'outil de recherche de signatures de diagnostics périodiquement, en fonction des problèmes couramment observés dans les déploiements. Le CAT ne prend actuellement pas en charge les nouvelles demandes de création de signatures personnalisées.

Pour une meilleure gestion des passerelles Cisco IOS XE, nous vous recommandons d'inscrire et de gérer les passerelles via le Control Hub. Il s'agit d'une configuration facultative. Une fois inscrit, vous pouvez utiliser l'option de validation de la configuration dans le Control Hub pour valider la configuration de votre passerelle locale et identifier les problèmes de configuration. Actuellement, seules les lignes de réseau basées sur l'enregistrement prennent en charge cette fonctionnalité.

Pour plus d’informations, reportez-vous aux sections suivantes :

• Inscription des passerelles gérées par Cisco IOS à Webex Cloud

• Attribuer les services aux passerelles gérées

• Valider la configuration de la passerelle locale Cisco