Diagnostic Signatures (DS) detecteert proactief veelvoorkomende problemen in de op IOS XE gebaseerde lokale gateway en genereert e-mail-, syslog- of terminalberichtmeldingen van de gebeurtenis. U kunt de DS ook installeren om het verzamelen van diagnostische gegevens te automatiseren en verzamelde gegevens over te dragen aan de Cisco TAC-case om de probleemoplossingstijd te reduceren.

Diagnostic Signatures (DS) zijn XML-bestanden die informatie bevatten over gebeurtenissen die problemen veroorzaken en acties die moeten worden ondernomen om het probleem te informeren, op te lossen en op te lossen. U kunt de probleemdetectielogica definiëren met behulp van syslog-berichten, SNMP-gebeurtenissen en door periodieke bewaking van specifieke weergavecommandooutputs.

De actietypen omvatten het verzamelen van uitvoer van de opdracht Show:

• Een geconsolideerd logbestand

• Het bestand uploaden naar een door de gebruiker geleverde netwerklocatie, zoals HTTPS, SCP, FTP-server.

TAC-technici schrijven de DS-bestanden en ondertekenen deze digitaal voor integriteitsbescherming. Elk DS-bestand heeft een unieke numerieke id die door het systeem is toegewezen. Hulpprogramma voor het opzoeken van diagnostische handtekeningen (DSLT) is een enkele bron voor het vinden van toepasselijke handtekeningen voor het bewaken en oplossen van verschillende problemen.

Voordat u begint:

• Bewerk het DS-bestand niet waarvan u downloadt DSLT . De bestanden die u wijzigt, kunnen niet worden geïnstalleerd vanwege de fout bij de integriteitscontrole.

• Een SMTP-server (Simple Mail Transfer Protocol) die u nodig hebt voor de lokale gateway om e-mailmeldingen te verzenden.

• Zorg ervoor dat op de lokale gateway IOS XE 17.6.1 of hoger wordt uitgevoerd als u de beveiligde SMTP-server wilt gebruiken voor e-mailmeldingen.

Voorwaarden

Lokale gateway met IOS XE 17.6.1a of hoger

1. Diagnostic Signatures is standaard ingeschakeld.

2. Configureer de beveiligde e-mailserver die moet worden gebruikt om proactieve meldingen te verzenden als op het apparaat Cisco IOS XE 17.6.1a of hoger wordt uitgevoerd.

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

3. De omgevingsvariabele configurerends_email met het e-mailadres van de beheerder om u op de hoogte te stellen.

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

Hieronder ziet u een voorbeeld van een configuratie van een lokale gateway die wordt uitgevoerd op Cisco IOS XE 17.6.1a of hoger om de proactieve meldingen te verzenden naar tacfaststart@gmail.com met Gmail als beveiligde SMTP-server:

We raden u aan de Cisco IOS XE Bengaluru 17.6.x of nieuwere versies te gebruiken.

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

Een lokale gateway die wordt uitgevoerd op Cisco IOS XE-software is geen typische webgebaseerde Gmail-client die OAuth ondersteunt. We moeten dus een specifieke Gmail-accountinstelling configureren en specifieke toestemming geven om de e-mail van het apparaat correct te laten verwerken:

1. Ga naar Google-account beheren > Beveiliging en de instelling Minder beveiligde app-toegang inschakelen.

2. Antwoord 'Ja, ik was het' wanneer u een e-mail van Gmail ontvangt met de melding 'Google heeft voorkomen dat iemand zich bij uw account aanmeldt met een niet-Google-app'.

Diagnostische handtekeningen installeren voor proactieve bewaking

Hoog CPU gebruik controleren

Deze DS houdt het CPU-gebruik gedurende vijf seconden bij met behulp van de SNMP OID 1.3.6.1.4.1.9.2.1.56. Wanneer het gebruik 75% of meer bereikt, worden alle foutopsporingen uitgeschakeld en worden alle diagnostische handtekeningen verwijderd die zijn geïnstalleerd in de lokale gateway. Gebruik de onderstaande stappen om de handtekening te installeren.

1. Gebruik de toon snmp opdracht om SNMP in te schakelen. Als u dit niet inschakelt, configureert u de snmp-serverbeheerder commando.

   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. Download DS 64224 met de volgende vervolgkeuzeopties in Diagnostic Signatures Lookup Tool:

   Veldnaam	Veldwaarde
   Platform	Cisco 4300-, 4400 ISR-serie of Cisco CSR 1000V-serie
   Product	CUBE Enterprise in Webex Calling-oplossing
   Probleembereik	Prestaties
   Probleemtype	Hoog CPU gebruik met E-mail -mailmelding.

3. Kopieer het DS XML-bestand naar de flash van de lokale gateway.

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

   In het volgende voorbeeld ziet u hoe u het bestand van een FTP -server naar de lokale gateway kopieert.

   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. Installeer het DS XML-bestand in de lokale gateway.

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

5. Gebruik de diagnostische handtekening voor bellen naar huis weergeven opdracht om te controleren of de handtekening is geïnstalleerd. De statuskolom moet een 'geregistreerde' waarde hebben.

   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's downloaden:

   DS-id	DS-naam	Revisie	Status	Laatste update (GMT+00:00)
   64224	DS_LGW_CPU_MON75	0.0.10	Geregistreerd	2020-11-07 22:05:33

   Wanneer deze handtekening wordt geactiveerd, worden alle actieve DS's verwijderd, inclusief de eigen DS. Installeer indien nodig DS 64224 opnieuw om het hoge CPU-gebruik op de lokale gateway te blijven controleren.

SIP trunk bewaken

Deze DS controleert elke 60 seconden of de registratie van een lokale gateway SIP -trunk met Webex Calling cloud ongedaan is gemaakt. Zodra de gebeurtenis voor het ongedaan maken van de registratie is gedetecteerd, wordt er een e-mail en een syslog-melding gegenereerd en wordt zichzelf na twee keer ongedaan maken van de registratie verwijderd. Gebruik de onderstaande stappen om de handtekening te installeren:

1. Download DS 64117 met de volgende vervolgkeuzeopties in Diagnostic Signatures Lookup Tool:

   Veldnaam	Veldwaarde
   Platform	Cisco 4300-, 4400 ISR-serie of Cisco CSR 1000V-serie
   Product	CUBE Enterprise in Webex Calling-oplossing
   Probleembereik	SIP-SIP
   Probleemtype	Afmelding van SIP -trunk met E-mail -mailmelding.

2. Kopieer het DS XML-bestand naar de lokale gateway.

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

3. Installeer het DS XML-bestand in de lokale gateway.

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

4. Gebruik de diagnostische handtekening voor bellen naar huis weergeven opdracht om te controleren of de handtekening is geïnstalleerd. De statuskolom moet de waarde 'geregistreerd' hebben.

Abnormale gespreksverbrekingen controleren

Deze DS gebruikt elke 10 minuten SNMP-enquêtes om abnormaal verbroken gespreksverbindingen te detecteren met SIP-fouten 403, 488 en 503.  Als de toename van het aantal fouten groter is dan of gelijk is aan 5 vanaf de laatste peiling, wordt er een syslog- en e-mailmelding gegenereerd. Gebruik de onderstaande stappen om de handtekening te installeren.

1. Gebruik de toon snmp opdracht om te controleren of SNMP is ingeschakeld. Als dit niet is ingeschakeld, configureert u de snmp-serverbeheerder commando.

   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. Download DS 65221 met de volgende opties in de Diagnostic Signatures Lookup Tool:

   Veldnaam	Veldwaarde
   Platform	Cisco 4300-, 4400 ISR-serie of Cisco CSR 1000V-serie
   Product	CUBE Enterprise in Webex Calling-oplossing
   Probleembereik	Prestaties
   Probleemtype	Detectie van abnormale SIP -verbinding verbroken met e- E-mail en Syslog-melding.

3. Kopieer het DS XML-bestand naar de lokale gateway.

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

4. Installeer het DS XML-bestand in de lokale gateway.

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

5. Gebruik de diagnostische handtekening voor bellen naar huis weergeven opdracht om te controleren of de handtekening is geïnstalleerd. De statuskolom moet de waarde 'geregistreerd' hebben.

Diagnostische handtekeningen installeren om een probleem op te lossen

Gebruik Diagnostic Signatures (DS) om problemen snel op te lossen. Cisco TAC -technici hebben verschillende handtekeningen opgesteld die de nodige debugs mogelijk maken die nodig zijn om een bepaald probleem op te lossen, het probleem te detecteren, de juiste set diagnostische gegevens te verzamelen en de gegevens automatisch over te dragen naar de Cisco TAC -case. Diagnostic Signatures (DS) elimineren de noodzaak om handmatig te controleren op het optreden van het probleem en maakt het oplossen van problemen met tussenpozen en tijdelijke problemen een stuk gemakkelijker.

U kunt de Hulpprogramma voor het opzoeken van diagnostische handtekeningen om de toepasselijke handtekeningen te vinden en deze te installeren om een bepaald probleem zelf op te lossen, of u kunt de handtekening installeren die wordt aanbevolen door de TAC-technicus als onderdeel van de ondersteuningsopdracht.

Hier ziet u een voorbeeld van hoe u een DS kunt vinden en installeren om de syslog '%VOICE_IEC-3-GW: CCAPI: Internal Error (call spike threshold): IEC=1.1.181.1.29.0" syslog en het verzamelen van diagnostische gegevens automatiseren met behulp van de volgende stappen:

1. Een extra DS-omgevingsvariabele configurerends_fsurl_prefix Dit is het Cisco TAC bestandsserver (cxd.cisco.com) waarnaar de verzamelde diagnostische gegevens worden geüpload. De gebruikersnaam in het bestandspad is het casenummer en het wachtwoord is het token voor het bestand uploaden dat kan worden opgehaald uit Ondersteuningscasemanager in de volgende opdracht. De bestandsuploadtoken kan indien nodig worden gegenereerd in het gedeelte Bijlagen van de Support Case Manager.

   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 

   Voorbeeld:

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

2. Zorg ervoor dat SNMP is ingeschakeld met de toon snmp commando. Als dit niet is ingeschakeld, configureert u de snmp-serverbeheerder commando.

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

3. Zorg ervoor dat u de DS 64224 voor hoge CPU bewaking installeert als een proactieve maatregel om alle foutopsporings- en diagnostische handtekeningen uit te schakelen tijdens een hoog CPU gebruik. Download DS 64224 met de volgende opties in de Diagnostic Signatures Lookup Tool:

   Veldnaam	Veldwaarde
   Platform	Cisco 4300-, 4400 ISR-serie of Cisco CSR 1000V-serie
   Product	CUBE Enterprise in Webex Calling-oplossing
   Probleembereik	Prestaties
   Probleemtype	Hoog CPU gebruik met E-mail -mailmelding.

4. Download DS 65095 met de volgende opties in de Diagnostic Signatures Lookup Tool:

   Veldnaam	Veldwaarde
   Platform	Cisco 4300-, 4400 ISR-serie of Cisco CSR 1000V-serie
   Product	CUBE Enterprise in Webex Calling-oplossing
   Probleembereik	Syslogs
   Probleemtype	Syslog - %VOICE_IEC-3-GW: CCAPI: Internal Error (Call spike threshold): IEC=1.1.181.1.29.0

5. Kopieer de DS XML-bestanden naar de lokale gateway.

   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. Installeer DS 64224 voor bewaking van hoge CPU en vervolgens het XML-bestand DS 65095 in de lokale gateway.

   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. Controleer of de handtekening is geïnstalleerd met behulp van de diagnostische handtekening voor bellen naar huis weergeven opdracht. De statuskolom moet de waarde 'geregistreerd' hebben.

   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 

   Gedownloade DS's:

   DS-id	DS-naam	Revisie	Status	Laatste update (GMT+00:00)
   64224 00:07:45	DS_LGW_CPU_MON75	0.0.10	Geregistreerd	2020-11-08
   65095 00:12:53	DS_LGW_IEC_Call_spike_threshold	0.0.12	Geregistreerd	2020-11-08

Uitvoering van diagnostische handtekeningen verifiëren

In de volgende opdracht wordt de kolom 'Status' van de diagnostische handtekening voor bellen naar huis weergeven opdracht verandert in "running" terwijl de lokale gateway de actie uitvoert die in de handtekening is gedefinieerd. De uitvoer van Statistieken voor diagnose-handtekening voor thuisgebruik weergeven is de beste manier om te controleren of een diagnostische handtekening een gebeurtenis van belang detecteert en de actie uitvoert. De kolom 'Geactiveerd/Max./Deïnstalleren' geeft het aantal keren aan dat de opgegeven handtekening een gebeurtenis heeft geactiveerd, het maximumaantal keren dat het is gedefinieerd om een gebeurtenis te detecteren en of de handtekening zichzelf verwijdert nadat het maximumaantal geactiveerde gebeurtenissen is gedetecteerd.

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 

Gedownloade DS's:

Statistieken voor diagnose-handtekening voor thuisgebruik weergeven

De e-mailmelding die wordt verzonden tijdens het uitvoeren van diagnostische handtekeningen, bevat belangrijke informatie, zoals het probleemtype, de apparaatgegevens, de softwareversie, de actieve configuratie en de uitvoer van opdrachten die relevant zijn voor het oplossen van het gegeven probleem.

Diagnostische handtekeningen verwijderen

Diagnostische handtekeningen gebruiken voor het oplossen van problemen worden doorgaans gedefinieerd om de installatie ongedaan te maken nadat bepaalde probleemgevallen zijn gedetecteerd. Wil je een handtekening manueel verwijderen, haal dan de DS ID op uit de output van de toon diagnosehandtekening call-home command en voer de volgende opdracht uit:

call-home diagnostic-signature deinstall <DS ID> 

Voorbeeld:

call-home diagnostic-signature deinstall 64224 

Er worden regelmatig nieuwe handtekeningen toegevoegd aan het hulpprogramma voor het opzoeken van handtekeningen voor diagnostische gegevens, op basis van problemen die vaak worden waargenomen bij implementaties. TAC ondersteunt momenteel geen aanvragen voor het maken van nieuwe aangepaste handtekeningen.

Voor een beter beheer van Cisco IOS XE-gateways raden we u aan de gateways in te schrijven en te beheren via de Control Hub. Het is een optionele configuratie. Wanneer u bent ingeschreven, kunt u de configuratievalidatieoptie in Control Hub gebruiken om uw lokale gatewayconfiguratie te valideren en eventuele configuratieproblemen te identificeren. Momenteel ondersteunen alleen trunks op basis van registratie deze functionaliteit.

Raadpleeg het volgende voor meer informatie:

• Door Cisco IOS beheerde gateways inschrijven voor Webex Cloud

• Services toewijzen aan beheerde gateways

• Cisco Local Gateway-configuratie valideren