Coletar os registros do conector - Webex Calling

Introdução

Este documento descreve o processo para coletar logs do conector do gateway gerenciado do Cisco IOS no modo de depuração.

Pré-requisitos

Requisitos

Acesso ao Hub de Controle com permissões de Administrador Total.

Acesso à CLI (Command Line Interface, interface de linha de comando) do gateway local.

Acesso ao GuestShell do Conector.

Componentes Utilizados

As informações neste documento são baseadas nestas versões de software e hardware:

• Aplicativo Conector (GuestShell)
• Versão do software Cisco IOS XE: 17.15.01 bis
• Versão do script: 3.1.1

As informações neste documento foram criadas a partir de dispositivos em um ambiente de laboratório específico. Todos os dispositivos utilizados neste documento foram iniciados com uma configuração (padrão) inicial. Se a rede estiver ativa, certifique-se de que você entenda o impacto potencial de qualquer comando.

Informações de Apoio

Os conectores de gateway são pequenas aplicações instaladas e em execução no contêiner Cisco IOS XE GuestShell e ajudam a manter uma conexão segura com o Control Hub, coordenar eventos e coletar informações de status.

Note: Para obter mais informações sobre conectores de gateway, consulte o documento: Inscrever os gateways gerenciados do Cisco IOS no Webex Cloud

Quando você tiver um problema com o conector, os logs do conector no nível de depuração serão necessários para solucionar o problema.

Etapas para coletar logs do conector do gateway no nível de depuração

Etapa 1. Entre no gateway usando um console ou uma conexão SSH, copie e cole o próximo comando no prompt de comando exec do roteador:

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

Note: Você pode iniciar (ou reiniciar) o script TCL diretamente usando tclsh bootflash:gateway_connector/gateway_onboarding.tcl ou tclsh https://binaries.webex.com/ManagedGatewayScriptProdStable/gateway_onboarding.tcl em qualquer ponto determinado.

Etapa 2. O menu principal do conector é exibido:

        ===============================================================
                        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:

Pressione v para selecionar a opção Exibir e modificar configurações do conector de nuvem.

Etapa 3. No próximo menu, pressione l para Modificar o nível de log para o conector de nuvem.

        ===============================================================
                        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:

Etapa 4. No próximo menu, escolha o nível de log para o conector de nuvem.

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

Etapa 5. Pressione 1 para definir o nível de log como 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:

Etapa 6. Pressione h para ir para o menu inicial.

        ===============================================================
                        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:

Etapa 7. Replique o problema e selecione l para obter os logs do conector. Uma vez concluída, a linha de comando exibe:

        ===============================================================
                        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:

Etapa 8. Copie o URL do flash de inicialização e pressione q para sair do GuestShell.

Note: Você pode reiniciar o script TCL diretamente da memória do flash de inicialização usando tclsh bootflash:gateway_connector/gateway_onboarding.tcl, evitando que o gateway faça download do script sempre que o comando for executado.

Exportar os registros do conector

Os logs do conector são salvos no diretório bootflash. Você pode usar FTP, SCP, TFTP, SFTP e outro protocolo de rede de transferência de arquivos, isso depende da sua preferência.

Este exemplo pressupõe que um servidor TFTP seja usado para transferir o log do conector, modificá-lo conforme necessário.

Etapa 1. Adicione o próximo comando na CLI do gateway.

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

Etapa 2. Digite o endereço do servidor TFTP.

Address or name of remote host []? 

Etapa 3. Confirme o nome do arquivo e pressione Enter.

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

Etapa 4. Carregue o arquivo .tar no caso do Cisco TAC.