Colete os suportes técnicos da ACI e o guia de resultados solicitados pelo TAC

Introdução

Este documento descreve os vários registros e saídas necessários para a solução de problemas ao trabalhar com o TAC para ACI.

Informações de Apoio

Para obter uma referência rápida sobre quais dados devem ser coletados antes da abertura de um caso de TAC, consulte a Tabela 1.

Tabela 1: Matriz de coleta Logs/Show tech

Problemas	O que coletar	Notas
Problemas de atualização	Suporte técnico sob demanda de nós com problema de upgrade. Suporte técnico sob demanda de todos os APICs. Falhas, eventos e auditorias adicionais usando o TacOutput.	Se os APICs forem divergentes e a coleta de suporte técnico sob demanda falhar, colete Techsupport Local.
Problema de conectividade aleatória	Suporte técnico sob demanda do nó src (onde o endpoint src está conectado). Suporte técnico sob demanda do nó dst (onde o dstendpoint está conectado). Falhas, eventos e auditorias adicionais usando o TacOutput
Perda total de conectividade	Suporte técnico sob demanda de leaves (origem e destino) Suporte técnico sob demanda de spines Suporte técnico sob demanda dos APICs Falhas, eventos e auditorias adicionais usando o TacOutput	Para interrupções contínuas, entre em contato com o TAC para depuração ao vivo. Se for necessário reinicializar os nós por qualquer motivo, colete os registros antes de recarregar, caso o RCA seja solicitado.
Problemas de clustering	Suporte técnico sob demanda de todos os APICs Falhas, eventos e auditorias adicionais usando o TacOutput	Se os APICs forem divergentes e a coleta de suporte técnico sob demanda falhar, colete Techsupport Local.
Problemas de roteamento	Suporte técnico sob demanda de nós com problema de roteamento. Falhas, eventos e auditorias adicionais usando o TacOutput
Falha de nó/recarregamento inesperado	Suporte técnico sob demanda de nós com falha. Arquivos de falha/núcleo do(s) nó(s) com falha. Falhas, eventos e auditorias adicionais usando o TacOutput
Problema no aplicativo do APIC	Suporte técnico sob demanda de todos os APICs. Suporte técnico do aplicativo do APIC para o aplicativo afetado.

APIC e switch da ACI

Suporte técnico sob demanda

Ativação e upload para a Intersight via APIC - Aplicativo do conector de nuvem Nexus Insights

Para usar esse método, consulte A estrutura da ACI deve ser conectada e reivindicada na Intersight pelo aplicativo APIC: Nexus Insights Cloud Connector.

1. Navegue para: APIC > Aplicativos > Aplicativos instalados > abrir aplicativo NICC > TAC Assist > clique em Iniciar
2. Selecione o(s) nó(s) e clique em Coletar logs.
3. Quando o Status da tarefa for CONCLUÍDO, clique em Exibir detalhes.
4. Na página Detalhes da tarefa, na tabela Logs, você localiza Coluna de nuvem. 
5. Clique em Upload para o pacote de suporte técnico de cada dispositivo.

Disparar e fazer upload para a Intersight via ND - Nexus Dashboard Insights

Para usar esse método, consulte A estrutura da ACI deve ser conectada e reivindicada na Intersight pelo Nexus Dashboard: Nexus Dashboard Insights.

1. Navegue até: Nexus Dashboard > Admin Console > Services > Open Nexus Dashboard Insights > Troubleshoot > Log Collector.
2. Clique em Nova coleção de logs.
   1. Dê um nome à coleção de logs.
   2. Selecione um site. 
   3. Marque a caixa de seleção para Carregar arquivos de log automaticamente.
   4. Clique em Selecionar nós e escolha o nó/s.
   5. Clique em Start Collection.
   6. Os arquivos do TechSupport são carregados em intersight.com  
3. Quando o upload for concluído, notifique o TAC de que os arquivos serão carregados no Intersight. 
4. O engenheiro do TAC seria capaz de mover os arquivos da interceptação para o caso do TAC para análise. 

Acionar usando a interface do usuário do APIC

Criar uma política de suporte técnico sob demanda

Observação: não especifique um intervalo de tempo do suporte técnico, a menos que seja explicitamente solicitado pelo TAC. Se houver uma rotatividade de logs excessiva, isso poderá resultar em perda de logs. Isso afeta gravemente a capacidade do TAC de fornecer uma RCA em tempo hábil. Se um Intervalo de tempo do suporte técnico for fornecido, ele corta os logs com base no último timestamp de modificação de arquivo e NÃO com base nos timestamps dentro do próprio arquivo de log.

1. Na barra de menus, clique em Admin > Import/Export > Export Policies > Clique com o botão direito do mouse em On-demand TechSupport > Create On-demand TechSupport.
2. Insira os valores apropriados nos campos da caixa de diálogo Criar suporte técnico sob demanda.
   • Se um local remoto não estiver disponível, marque Exportar para o controlador. O Techsupported gerado pode então ser baixado por meio da guia Operacional da GUI depois que eles tiverem sido gerados.
   • Marque Incluir todos os controladores no suporte técnico para gerar os suportes técnicos do APIC.
   • O campo Nós de origem permite especificar nós de switch que geram um suporte técnico.
3. Clique em Enviar para criar a política de suporte técnico sob demanda.

Gere um suporte técnico sob demanda.

1. Navegue até uma política de suporte técnico sob demanda atual. As políticas criadas podem ser encontradas em: Admin > Import/Export > Export Policies > On-demand TechSupport > Expand On-demand TechSupport folder > clique com o botão direito do mouse na política a ser usada > Collect Tech Support.
   
   • Ou clique com o botão esquerdo do mouse em On-Demand Techsupport Policy para exibi-la no painel principal; em seguida, clique no ícone Wrench/Hammer e escolha Collect Tech Supports.
2. Escolha Sim para começar a coletar as informações de suporte técnico.

Colete o Techsupport gerado.

1. Se Exportar para controlador não foi habilitado durante a geração do suporte técnico, o Destino da exportação (Local remoto) pode ser verificado para todos os arquivos do suporte técnico.
2. Se a opção Exportar para o controlador foi ativada, navegue até a política de suporte técnico sob demanda para a qual os suportes técnicos foram gerados. As políticas criadas podem ser encontradas em Admin > Import/Export > Export Policies > On-demand TechSupport.
   • Os suportes técnicos gerados podem ser encontrados na guia Operacional da política de suporte técnico sob demanda. Cada arquivo tem um link para baixá-lo via http/https. Cada nó tem três links, um link vinculado a cada arquivo.

Nota: se a versão for anterior à 2.2, você deverá usar a conta de usuário administrador local para fazer o download do Techsupported pela interface do usuário. Caso contrário, use qualquer outra conta local que tenha privilégios de admin. Os usuários remotos não podem fazer o download do suporte técnico por meio da interface do usuário. Em vez disso, eles podem usar o sftp ou outro método para extrair os arquivos de suporte técnico do diretório /data/techsupport/ nos APICs correspondentes.

Observação: o número no URL do pacote de suporte técnico indica o APIC em que o arquivo está. Por exemplo, files/2/techsupport.tgz indica que esse pacote específico pode ser encontrado no diretório /data/techsupport/ do APIC 2.

Explicação dos arquivos de suporte técnico sob demanda

Se os suportes técnicos foram gerados com a opção Exportar para o controlador, a GUI mostrará três URLs por nó da ACI (nó do APIC ou nó do switch). Cada URL é um tipo de arquivo de registro diferente e contém informações exclusivas. Normalmente, o TAC exige que todos os três arquivos sejam carregados por nó, para obter todos os registros para uma análise completa.

Cada URL é mapeado para um dos três tipos de arquivo:

Categoria	Sufixo típico	Útil para:	Tamanho do arquivo
Exportar	_1of3.tgz	Registros de auditoria/falha	De pequeno e médio porte
Logs	_logs_3of3.tgz	Registros de processo	Maior
DB	_db_2of3.tgz	MO Dump	Pequeno

Nota: Se um Destino de exportação foi selecionado em vez de Exportar para controlador, o Local remoto definido cria uma pasta que contém os três arquivos por nó.

Se houver um problema ao fazer o download do suporte técnico usando o link do navegador, baixe diretamente os arquivos do armazenamento APIC usando um cliente scp ou sftp, como WinSCP ou FileZilla.

1. Conecte (sftp) a cada APIC. Os arquivos de suporte técnico coletados são armazenados em todos os APICs disponíveis, por isso é importante verificar se há arquivos de suporte técnico coletados em cada APIC.

2. Navegue até a pasta /data/techsupport no APIC conectado (repita esta etapa em todos os controladores APIC).

Procure os arquivos com um nome que contenha o nome da política de suporte técnico sob demanda (neste exemplo, é ABCTECH) e faça o download desses arquivos para o seu computador.

Suporte técnico local

Um suporte técnico sob demanda é sempre preferido em relação a um suporte técnico local, pois um suporte técnico sob demanda fornece uma imagem mais completa. No entanto, ele conta com um cluster do APIC totalmente adequado, pois a coleta é acionada usando a política.

Cenários de suporte técnico local

• O APIC não é totalmente adequado.
• O APIC ainda não descobriu o switch da ACI.
• O switch da ACI perdeu a comunicação com o APIC.
• Mau funcionamento interno do processo, impedindo a operação de suporte técnico sob demanda (raro).

Acionar usando a CLI do APIC

1. Abra uma sessão SSH com o APIC usando as credenciais de admin.
   • Se você não puder usar credenciais de administrador para fazer login, use o nome de usuário rescue-user. A senha pode ser igual à do usuário local admin.
2. Execute o comando bash -c "techsupport local".

   Using username "admin".
   Application Policy Infrastructure Controller
   
   apic1# bash -c "techsupport local"
   This command is being deprecated on APIC controller, please use NXOS-style equivalent command
   Running bash commands
   Completed 1 of 10 commands
   ...
   Completed 10 of 10 commands
   Starting data compression
   Techsupport collected at /data/techsupport/local_apic1_2018-05-29T08-17.tgz . Please remove the file once done.
   

3. Baixe o suporte técnico local.
   
   • Opção A: Faça download do arquivo de suporte técnico usando SCP:
     • WinSCP ou pscp.exe (usuários do Windows)
     • Cliente SCP nativo (usuários do MAC)
   • Opção B: Faça download do arquivo de suporte técnico usando HTTPS:
     1. Abra um navegador como o Chrome ou o Firefox.
     2. Navegue até: https://<aci.apic.ip.addr>/files/<apic#>/techsupport/<ts_filename>
        • Exemplo: https://a.p.i.c/files/1/techsupport/local_apic1_2018-05-29T08-17.tgz
     3. Faça login usando as credenciais de admin.
     4. Se solicitado, selecione Salvar arquivo no prompt de download do navegador.

Acionar usando a CLI do switch

1. Abra uma sessão SSH com o switch da ACI usando as credenciais de admin.
   • Se o switch ainda não for descoberto pelo APIC, use o nome de usuário admin.
2. Execute o comando: "techsupport local".

fab5-leaf1# techsupport local
Running bash commands
Completed 1 of 9 commands
...
Completed 9 of 9 commands
Starting data compression
Techsupport collected at /data/techsupport/local_fab5-leaf1_2018-05-29T08-16.tgz . Please remove the file once done

3. Faça o download do suporte técnico local.

• Opção A: Faça download do arquivo de suporte técnico do switch da ACI usando SCP:
  • WinSCP ou pscp.exe (usuários do Windows)
  • Cliente SCP nativo (usuários do MAC)
• Opção B: Faça download do arquivo de suporte técnico usando HTTPS via APIC:
  
  1. Faça login em uma CLI do APIC (observe qual APIC é usado na etapa 4).
  2. Transfira o arquivo de suporte técnico do switch da ACI para o APIC usando este comando:
     • scp <node-name>:/data/techsupport/<ts_filename> /data/techsupport
     • Exemplo: apic1# scp fab5-leaf1:/data/techsupport/local_fab5-leaf1_2018-05-29T08-16.tgz /data/techsupport
  3. Abra um navegador como o Chrome ou o Firefox.
  4. Navegue até: https://<aci.apic.ip.addr>/files/<apic#>/techsupport/<ts_filename>
     • Exemplo: https://a.p.i.c/files/1/techsupport/local_fab5-leaf1_2018-05-29T08-16.tgz
  5. Faça login usando as credenciais de admin.
  6. Se solicitado, selecione Salvar arquivo no prompt de download do navegador.

Suporte técnico do CIMC

Acionar usando a interface do usuário do CIMC

Um suporte técnico do CIMC do APIC pode ser coletado para revisar logs relacionados ao chassi do APICs. Um show tech do CIMC pode ser capturado localmente ou enviado para um local remoto na seção Utilities da guia CIMC Admin. 

Disparador via CLI do CIMC

Na CLI do CIMC do APIC, digite:

~ # scope cimc
~ /cimc # scope tech-support
~ /cimc/tech-support # set tftp-ip 192.168.1.1
~ /cimc/tech-support *# set path \techsupport\showtech
~ /cimc/tech-support *# commit
~ /cimc/tech-support *# start 

Analisando o suporte técnico do CIMC

Alguns dos principais campos do comando show tech são listados aqui.

Arquivo/Local Techsup	Descrição
var/	Contém logs detalhados e o status de todos os serviços monitorados. Também contém os arquivos de informações de serviços, como a configuração dos alarmes de sensor SOL e IPMI.
var/log	Contém as mensagens deslocáveis de log volátil.
obfl/	Contém as mensagens de log não voláteis deslocáveis.
met/	Configuração não volátil e SEL
mp/	Os arquivos de texto show tech-support, junto com os arquivos de texto do BIOS tech-support. Os arquivos de texto contêm todas as informações de processo, rede, sistema, mezanino e estado da BIOS.
mctool	Obtém informações básicas sobre o estado do CIMC.
rede	Obtém informações atuais de configuração de rede e soquete.
obfl	Obtém obfl ao vivo (Logs de falha na placa).
messeges	Obtém o arquivo /var/log/messages ao vivo.
alarmes	Lista os sensores nos estados de alarme.
sensores	Leituras atuais do sensor do IPMI.
alimentação	Estado de energia atual do x86.

Auditorias estendidas, eventos, falhas e muito mais (TacOutput)

O TAC pode solicitar saídas básicas adicionais, como falhas, eventos e auditorias, que geralmente são necessárias para o RCA.

A partir de hoje, os show techs já incluem um subconjunto desses objetos, mas apenas os últimos 10.000 registros. Em alguns casos, o TAC exige o conjunto completo de registros, que vai muito além de 10.000 registros.

Nota: começando com a versão 5.2(1g), você pode usar a saída de tacoutput do acionador do comando CLI do APIC para coletar esses objetos adicionais. No entanto, em versões anteriores à 5.3(x) e 6.0(3d), o script incorporado pode falhar ao coletar todas as páginas de registros.  Nesse caso, é recomendável usar a versão mais atualizada do script no repositório aci-tac-scripts descrito na próxima seção.

Trigger via Trigger Tacoutput - 5.3/6.0(3d) e versões posteriores

Para Estruturas ACI executando a versão 5.3/6.0(3d) e versões posteriores, a saída de disparador fornece uma interface de coleta simplificada para eventos, falhas, auditoria e outras saídas de solução de problemas):

apic1# trigger tacoutput
Select corresponding numbers of objects to collect. Separate numbers with commas. *Note, topSystem, fabricNode, and firmwareARunning are automatically included.
Ex: 1,2,3,4,5
1. faultInfo *collected unfiltered
2. faultRecord
3. eventRecord
4. aaaModLR *collected unfiltered
5. polDeploymentRecord
6. epRecord
7. healthRecord
8. healthInst *collected unfiltered
Enter selections: 1,2,3,4,5,6,7,8
Enter record start date (format: 2019-12-15T00:00:00) *default is one month prior to current date: 
Enter record end date (format: 2019-12-15T00:00:00) *default is current date: 

... collection runs...

2021-12-17T08:19:59 TacOutput collection completed.
2021-12-17T08:19:59 Verify files and file sizes at /tmp/TacOutput2021-12-17T08-16-19
2021-12-17T08:19:59 Compressing files...
2021-12-17T08:20:01 Compression completed
Logs available for SCP or SFTP download from /data/techsupport/TacOutput-2021-11-17T08:18:06-to-2021-12-17T08:18:06.tgz
To download through your web browser go to https://<apic address>/files/1/techsupport/TacOutput-2021-11-17T08:18:06-to-2021-12-17T08:18:06.tgz
Note: in the URL previous 1 denotes the APIC ID 1, if script was run on APIC-n, then n must be specified in the URL (n = APIC-ID).

To remove files when done run
rm -rf /tmp/TacOutput2021-12-17T08-16-19
rm -f /data/techsupport/TacOutput-2021-11-17T08:18:06-to-2021-12-17T08:18:06.tgz

Gatilho via Script Collect TacOutputs

Para Estruturas ACI que executam versões anteriores à 5.3/6.0(3d), há um Script Collect TacOutput disponível no repositório aci-tac-scripts que serve uma interface semelhante ao comando trigger tacoutput:

apic# /tmp/collectTacOutputs.sh
Select corresponding numbers of objects to collect. Separate numbers with commas. *Note, topSystem, fabricNode, and firmwareARunning are automatically included.
Ex: 1,2,3,4,5
1. faultInfo *collected unfiltered
2. faultRecord
3. eventRecord
4. aaaModLR
5. polDeploymentRecord
6. epRecord
7. healthRecord
8. healthInst *collected unfiltered
Enter selections: 1,2,3,4,5,6,7,8
Enter record start date (format: 2019-12-15T00:00:00) *default is one month prior to current date: 2019-12-25T00:00:00
Enter record end date (format: 2019-12-15T00:00:00) *default is current date: 2020-01-05T00:00:00

...script collection runs...

Compression completed
Logs available for SCP or SFTP download from /data/techsupport/TacOutput-2019-12-25T00:00:00-to-2020-01-05T00:00:00.tgz
To download through your web browser go to https:///files/1/techsupport/TacOutput-2019-12-25T00:00:00-to-2020-01-05T00:00:00.tgz

Arquivos de falha/núcleo

Coletar usando a interface do usuário do APIC

O nó do switch da ACI e o APIC têm vários processos que controlam muitos aspectos funcionais no sistema. Se o sistema tiver uma falha de software em um processo específico, um arquivo de núcleo será gerado e o processo será recarregado. Quando um processo falha e um arquivo de núcleo é gerado, uma falha e um evento são gerados. Quando o processo no switch/APIC falha, o arquivo núcleo é compactado e copiado para o APIC.

A GUI do APIC fornece um local central para coletar os arquivos de núcleo para os nós de estrutura.

Uma nova política de exportação pode ser criada em Admin > IMPORT/EXPORT em Políticas de exportação > Core.

Há uma política central padrão em que os arquivos podem ser baixados diretamente. Todos os arquivos de núcleo gerados tentam transferir para o controlador APIC quando gerados. Se obtiverem êxito, eles podem ser encontrados na política principal padrão.

Registros de auditoria independentes

Coleta usando a interface do usuário do NDO/MSO

Os logs de auditoria do MSC podem ser baixados em JSON no formato CSV.