Raccogli i log del connettore - Webex Calling

Introduzione

In questo documento viene descritto il processo di raccolta dei log del connettore gateway gestito di Cisco IOS in modalità di debug.

Prerequisiti

Requisiti

Accesso all'hub di controllo con autorizzazioni di amministratore completo.

Accesso alla CLI (Command Line Interface) del gateway locale.

Accedere a Connector GuestShell.

Componenti usati

Le informazioni fornite in questo documento si basano sulle seguenti versioni software e hardware:

• Applicazione Connector (GuestShell)
• Versione software Cisco IOS XE: 17.15.01a
• Versione script: 3.1.1

Le informazioni discusse in questo documento fanno riferimento a dispositivi usati in uno specifico ambiente di emulazione. Su tutti i dispositivi menzionati nel documento la configurazione è stata ripristinata ai valori predefiniti. Se la rete è operativa, valutare attentamente eventuali conseguenze derivanti dall'uso dei comandi.

Premesse

I connettori gateway sono piccole applicazioni installate ed in esecuzione sul contenitore Cisco IOS XE GuestShell che consentono di mantenere una connessione protetta all'hub di controllo, coordinare gli eventi e raccogliere informazioni sullo stato.

Nota: Per ulteriori informazioni sui connettori del gateway, consultare il documento: Registra i gateway gestiti da Cisco IOS su Webex Cloud

Se si verifica un problema con il connettore, per risolvere il problema è necessario accedere al livello di debug del connettore.

Passaggi per raccogliere i log del connettore gateway nel livello di debug

Passaggio 1. Accedere al gateway utilizzando una console o una connessione SSH, copiare e incollare il comando successivo al prompt dei comandi di router exec:

tclsh https://binaries.webex.com/ManagedGatewayScriptProdStable/gateway_onboarding.tcl  

Nota: È possibile avviare o riavviare lo script TCL direttamente utilizzando tclsh bootflash:gateway_connector/gateway_onboarding.tcl o tclsh https://binaries.webex.com/ManagedGatewayScriptProdStable/gateway_onboarding.tcl in qualsiasi momento.

Passaggio 2. Viene visualizzato il menu principale del connettore:

        ===============================================================
                        Webex Managed Gateway Connector
        ===============================================================
             Options
               s :  Display Status Page
               v :  View and Modify Cloud Connector Settings
               e :  Enable Guestshell
               d :  Disable Guestshell
               l :  Collect Logs
               r :  Clear Logs
               u :  Uninstall Connector
               p :  Apply Patch
               q :  Quit

        ===============================================================
                        Select an option from the menu:

Premere v per selezionare l'opzione View and Modify Cloud Connector Settings (Visualizza e modifica impostazioni connettore cloud).

Passaggio 3. Dal menu successivo, premere l per modificare il livello di log per Cloud Connector.

        ===============================================================
                        Webex Managed Gateway Connector
        ===============================================================
                Script Version         : 3.1.1
                Hostname/IP Addr       : X.X.X.X
                DNS Server(s)          : X.X.X.X 8.8.8.8
                                         X.X.X.X
                Gateway Username       : doctorx
                External Interface     : GigabitEthernet2
        ===============================================================
             Options
               c :  Update Gateway Credentials
               e :  Update External Interface
               p :  Update Proxy Details
               n :  Update DNS Server
               k :  Update Connector Package Verification Key
               l :  Modify log level for Cloud Connector
               h :  Go to home menu
               q :  Quit

        ===============================================================
                        Select an option from the menu:

Passaggio 4. Dal menu successivo, scegliere il livello di log per il connettore cloud.

         ===============================================
                  Number      Log Level
         ===============================================
                    1           DEBUG
                    2           INFO
                    3           WARNING
                    4           ERROR
                    5           CRITICAL
         ===============================================

Passaggio 5. Premere 1 per impostare il livello di log su DEBUG.

        ===============================================================
                        Webex Managed Gateway Connector
        ===============================================================


                    Cloud Connector log level is set to : 1

                ===============================================
                            Number        Log Level
                ===============================================
                                1           DEBUG
                ===============================================
        ===============================================================
                  Select option h for home menu or q to quit:

Passaggio 6. Premere h per andare al menu Home.

        ===============================================================
                        Webex Managed Gateway Connector
        ===============================================================
             Options
               s :  Display Status Page
               v :  View and Modify Cloud Connector Settings
               e :  Enable Guestshell
               d :  Disable Guestshell
               l :  Collect Logs
               r :  Clear Logs
               u :  Uninstall Connector
               p :  Apply Patch
               q :  Quit

        ===============================================================
                        Select an option from the menu:

Passaggio 7. Replicare il problema, quindi selezionare l per ottenere i registri dei connettori. Al termine, la riga di comando visualizza:

        ===============================================================
                        Webex Managed Gateway Connector
        ===============================================================

                Log files are collected and stored at location

            bootflash:/guest-share/gateway_webex_cloud_logs_2025025014034.tar.gz
        ===============================================================
                  Select option h for home menu or q to quit:

Passaggio 8. Copiare l'URL di avvio e premere q per uscire da GuestShell.

Nota: È possibile riavviare lo script TCL direttamente dalla memoria bootflash utilizzando tclsh bootflash:gateway_connector/gateway_onboarding.tcl per impedire al gateway di scaricare lo script ogni volta che viene eseguito il comando.

Esportazione dei registri dei connettori

I registri dei connettori vengono salvati nella directory bootflash. È possibile utilizzare FTP, SCP, TFTP, SFTP e altri protocolli di rete per il trasferimento di file, a seconda delle preferenze.

L'esempio presuppone che venga utilizzato un server TFTP per trasferire il log del connettore e modificarlo in base alle esigenze.

Passaggio 1. Aggiungere il comando successivo nella CLI del gateway.

Router#copy bootflash:/guest-share/gateway_webex_cloud_logs_2025025014034.tar.gz tftp:///.tar.gz

Passaggio 2. Immettere l'indirizzo del server TFTP.

Address or name of remote host []? 

Passaggio 3. Confermare il nome del file, quindi premere Invio.

Destination filename [gateway_webex_cloud_logs_2025025014034.tar.gz]?
!!
32137 bytes copied in 4.714 secs (6817 bytes/sec)
Router#

Passaggio 4. Caricare il file .tar nella richiesta Cisco TAC.