Dell Networking SONiC – Como gerar e coletar o arquivo de suporte técnico

Summary: Este artigo explica como gerar e coletar o arquivo de suporte técnico no Dell Networking SONiC versão 4.0 ou posterior.

This article applies to This article does not apply to This article is not tied to any specific product. Not all product versions are identified in this article.
Check out other resources

Instructions

Índice

O que é o arquivo de suporte técnico?
Sintaxe de comando
Como gerar o arquivo de suporte técnico no Dell SONiC
Como monitorar o status de geração do arquivo de suporte técnico
Como recuperar o arquivo de suporte técnico a partir do switch
      FTP
      HTTP
      USB
      Aplicativo client do SCP
Nome e formato do arquivo de suporte técnico
Como restringir as entradas antigas e reduzir o tamanho do arquivo de suporte técnico
Como excluir o arquivo antigo de suporte técnico para economizar espaço.

O que é o arquivo de suporte técnico

O arquivo de suporte técnico é um arquivo compactado, composto por informações sobre o estado do switch, como o Syslog, o estado do banco de dados, o dump de núcleo, entre outros. Os agentes de suporte técnico Dell precisam de um arquivo de suporte técnico para poderem fazer a análise detalhada de um evento.

  • O arquivo de suporte técnico é um arquivo compactado, salvo em /var/dump. O conteúdo dessa pasta pode ser visualizado usando o comando: 
    dir tech-support:/
  • O arquivo de suporte técnico tem a extensão .tar.gz
  • A geração do arquivo de suporte técnico pode levar de 15 a 30 minutos.
  • O tamanho do arquivo varia de acordo com os dados e o período de tempo das amostras de log. Para reduzir o tamanho, podemos usar a opção "since"
  • Se possível, tente gerar um arquivo de suporte técnico no estado do problema
Nota: Para obter uma versão mais antiga, consulte Dell Networking SONiC OS – Como gerar um arquivo de suporte técnico nas versões 3.X

Sintaxe de comando

COMANDO EXPLICAÇÃO
admin@sonic:~$ sonic-cli Entrar no Dell SONiC.
sonic# show tech-support Gerar um arquivo de suporte técnico.
sonic# show tech-support status Mostrar status de geração do arquivo de suporte técnico.
sonic# dir tech-support:/ Mostrar o conteúdo do diretório /var/dump, onde o arquivo de suporte técnico foi gerado.
sonic# copy tech-support://<filename> ftp/home/http/scp/usb://<filename> Copiar um arquivo de suporte técnico para um local remoto usando um diretório base, usb ou protocolo ftp, http ou scp

Opcional

COMANDO EXPLICAÇÃO
sonic# show tech-support since <date/time> Gerar um arquivo de suporte técnico a partir de uma data e hora. Clique aqui para obter mais informações.
sonic# delete tech-support:/ <filename> Excluir o arquivo antigo de suporte técnico. Isso economiza espaço em flash.

Como gerar o arquivo de suporte técnico no Dell SONiC

Use o comando "show tech-support" para gerar um arquivo de suporte técnico.

Exemplo

admin@DELLSONiC:~$ sonic-cli
DELLSONiC# 
DELLSONiC# show tech-support 
%Info: Tech-support process started, please check "show tech-support status" for tech-support progress
DELLSONiC#

Como monitorar o status de geração do arquivo de suporte técnico

Use o comando "show tech-support status" para monitorar o status de geração do arquivo de suporte técnico. O resultado mostra o "Status: Completed" quando a geração do arquivo é concluída.
Use o comando "dir tech-support:/" para ver o conteúdo da pasta /var/tmp. O arquivo de suporte técnico é gerado nessa pasta.

Veja abaixo um exemplo de saída de "show tech-support status" e "dir tech-support:/"

Durante a geração do arquivo de suporte técnico:

DELLSONiC# show tech-support status 
Status: In Progress (Collecting Counters-1) Total items collected: 12
DELLSONiC# dir tech-support:/
-------------------------------------------------------------------------
Date(Last Modified)      Size(Bytes)    Type      Filename                        
-------------------------------------------------------------------------                
2023-04-15 20:21         4096           d         sonic_dump_DELLSONiC_20230415_202048
2023-04-15 20:22         11100160       -         sonic_dump_DELLSONiC_20230415_202048.tar

Depois de a geração do arquivo de suporte técnico ser concluída com sucesso.

DELLSONiC# show tech-support status
Status: Completed
File Name: /var/dump/sonic_dump_DELLSONiC_20230415_202048.tar.gz
DELLSONiC# dir tech-support:/ 
-------------------------------------------------------------------------
Date(Last Modified)      Size(Bytes)    Type      Filename                        
-------------------------------------------------------------------------                
2023-04-15 20:27         252932846      -         sonic_dump_DELLSONiC_20230415_202048.tar.gz

Como recuperar o arquivo de suporte técnico a partir do switch

Use o comando "copy tech-support://<tech-support filename> <destination>//<filename>" para copiar o arquivo de suporte técnico para o diretório base, usb ou servidor ftp/http/scp remoto.

Veja abaixo as opções de destino disponíveis e os respectivos usos.

  • ftp: Copiar para o servidor FTP remoto (ftp://userid:passwd@hostip/filepath)
  • home: Copiar para o diretório base (home://filename)
  • http: Copiar para o servidor HTTP remoto (http://hostip/filepath)
  • scp: Copiar para o servidor SCP remoto (scp://userid:passwd@hostip/filepath)
  • usb: Copiar para o diretório de mídia USB (usb://filename)
Nota: O comando "tech-support://" em "copy" não é preenchido automaticamente. Portanto, digite o caminho completo manualmente.

Explicaremos as opções abaixo com um exemplo.

FTP
Para copiar um arquivo para um servidor FTP remoto, use a seguinte sintaxe.

copy techsupport://<techsupport file.tag.gz> ftp://userid:passwd@hostip/filepath

Considere que estamos copiando o arquivo de suporte técnico para um servidor FTP remoto com IP 10.0.0.1, nome de usuário: TEST e senha PASS

Exemplo de saída

DELLSONiC# copy tech-support://sonic_dump_DELLSONiC_20230415_202048.tar.gz ftp://TEST:PASS@10.0.0.1/sonic_dump_DELLSONiC_20230415_202048.tar.gz

HTTP
Para copiar um arquivo para um servidor HTTP remoto, use a seguinte sintaxe.

copy techsupport://<techsupport file.tag.gz> http://hostip/filepath

Considere que estamos copiando o arquivo de suporte técnico para um servidor HTTP remoto com IP 10.0.0.1.

Exemplo de saída

DELLSONiC# copy tech-support://sonic_dump_DELLSONiC_20230415_202048.tar.gz http://10.0.0.1/sonic_dump_DELLSONiC_20230415_202048.tar.gz

USB
Para usar USB no DELL SONiC, em um switch de rede, devemos garantir que o comando "usb enable" esteja configurado. Por padrão, o USB fica desativado.
Execute o comando "usb mount" depois de inserir o USB no switch.

Dell Networking SONiC – Como montar e desmontar um USB

Exemplo de saída

sonic#
sonic# configure terminal
sonic(config)# usb enable
sonic(config)# exit
sonic# usb mount
DELLSONiC# copy tech-support://sonic_dump_DELLSONiC_20230415_202048.tar.gz usb://sonic_dump_DELLSONiC_20230415_202048.tar.gz

Aplicativo client SCP
Você pode usar qualquer aplicativo client SCP para extrair o arquivo de suporte técnico no switch.
Use as credenciais de login do switch no aplicativo client SCP para fazer login no switch. O arquivo de suporte técnico fica localizado no diretório /var/dump/.
Alguns aplicativos client SCP têm uma interface gráfica que torna ainda mais fácil copiar um arquivo do switch /var/dump/ para uma pasta em sua máquina local.

Nome e formato do arquivo de suporte técnico

O arquivo de suporte técnico tem um nome no formato "sonic_dump_<Hostname>_ _YYYYMMDD_HHMMSS.tar.gz"
*YYYYMMDD_HHMMSS refere-se a Ano Mês Dia_Hora Minuto Segundo. Este é o momento da geração do arquivo de suporte técnico.

Por exemplo, "sonic_dump_DELLSONiC_20230415_202048.tar.gz" é o arquivo de suporte técnico gerado. Aqui, YYYYMMDD_HHMMSS é 20230415_202048, e DELLSONiC é o nome do host do switch.

Como restringir as entradas antigas e reduzir o tamanho do arquivo de suporte técnico

O arquivo de suporte técnico pode ser um arquivo grande, conforme o tempo de funcionamento do switch. No Dell SONiC, podemos reduzir o tamanho do arquivo limitando a duração do log.

Use o comando "show tech-support since <date/time>" para capturar o arquivo de suporte técnico de um período específico.

Exemplo de saída

DELLSONiC# show tech-support since "2023-04-14T12:30:30Z"
%Info: Tech-support process started, please check "show tech-support status" for tech-support progress

Recomenda-se capturar até a hora 0 do dia anterior para verificar qualquer possível ação precedente ao evento.

Exemplo de saída

DELLSONiC# show tech-support since "2023-04-14T00:00:00Z"
%Info: Tech-support process started, please check "show tech-support status" for tech-support progress

Sintaxe de comando

Comando Explicação
sonic# show tech-support since <date/time> Veja abaixo o formato de data/hora.

 "YYYY-MM-DDTHH:MM:SS[.ddd…]Z" ou
 "YYYY-MM-DDTHH:MM:SS[.ddd…]+hh:mm" ou
 "YYYY-MM-DDTHH:MM:SS[.ddd…]-hh:mm". Em que:

 AAAA = ano, MM = mês, DD = dia,
 T (obrigatório antes do tempo),
 HH = horas, MM = minutos, SS = segundos,
 (opcional) .ddd... = fração decimal de um segundo (por exemplo, ".323")
 Z indica um desvio de zero da hora local.
 +/- hh:mm indica um desvio de hora:minuto da hora local.

Como excluir o arquivo antigo de suporte técnico para economizar espaço

Podemos excluir com segurança o arquivo de suporte técnico na pasta dump depois de extrair o arquivo do switch.

Use o comando "delete tech-support:/ <techsupport file.tar.gz>" para excluir o arquivo de suporte técnico.

Exemplo de saída

DELLSONiC# delete tech-support:/ sonic_dump_DELLSONiC_20230415_202048.tar.gz
Proceed to delete tech-support:/sonic_dump_DELLSONiC_20230415_202048.tar.gz? [y/N]:y

Use o comando "dir tech-support:/" para verificar se o arquivo foi excluído.

Exemplo de saída

DELLSONiC# dir tech-support:/ 
-------------------------------------------------------------------------
Date(Last Modified)      Size(Bytes)    Type      Filename                        
-------------------------------------------------------------------------

 

Affected Products

Enterprise SONiC Distribution, PowerSwitch E3200-ON Series, Dell EMC Networking N3200-ON, PowerSwitch S5212F-ON, PowerSwitch S5224F-ON, PowerSwitch S5232F-ON, PowerSwitch S5248F-ON, PowerSwitch S5296F-ON, PowerSwitch Z9100-ON, PowerSwitch Z9264F-ON , PowerSwitch Z9332F-ON, PowerSwitch Z9432F-ON ...
Article Properties
Article Number: 000212428
Article Type: How To
Last Modified: 25 Feb 2025
Version:  5
Find answers to your questions from other Dell users
Support Services
Check if your device is covered by Support Services.