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 de show tech/registros:

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 via TacOutput.	Se os APICs forem divergentes e a coleta do suporte técnico sob demanda falhar, colete o suporte técnico 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 a partir do nó dst (onde o dstendpoint está conectado). Falhas, eventos e auditorias adicionais via TacOutput.
Perda total de conectividade	Suporte técnico sob demanda a partir das folhas (src e dst). Suporte técnico sob demanda de spines. Suporte técnico sob demanda dos APICs Falhas, eventos e auditorias adicionais via 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 via TacOutput.	Se os APICs forem divergentes e a coleta do suporte técnico sob demanda falhar, colete o suporte técnico local.
Problemas de roteamento	Suporte técnico sob demanda de nós com problema de roteamento. Falhas, eventos e auditorias adicionais via 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 via 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 solicitada na Intersight pelo APIC: Aplicativo do conector de nuvem do Nexus Insights.

1. Navegue até: APIC > Aplicativos > Aplicativos instalados > Abra o aplicativo NICC > TAC Assist > Clique em Iniciar
2. Selecione o(s) nó(s) e clique em Coletar logs.
3. Quando o Status da tarefa estiver CONCLUÍDO, clique em Exibir detalhes.
4. Na página Detalhes da tarefa, na tabela Logs, em Arquivo, localize a 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 painel do Nexus: Informações do painel do Nexus.

1. Navegue até: Nexus Dashboard > Admin Console > Services > Abra o Nexus Dashboard Insights > Solucione problemas > Coletor de logs.
2. Clique em Nova coleção de logs.
   1. Adicione um nome à coleção de logs.
   2. Selecione um site. 
   3. Ative a caixa de seleção para Auto Upload Log Files.
   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 foram carregados no Intersight. 
4. O engenheiro do TAC pode mover os arquivos da Intersight 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

Note: Não especifique um intervalo de tempo de 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 TechSupport for fornecido, ele corta os logs com base no carimbo de data/hora da última modificação de arquivo e NÃO com base nos carimbos de data/hora 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 > Criar suporte técnico sob demanda.
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 download dos suportes técnicos gerados é feito por meio da guia Operacional da GUI depois que eles são 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 TechSupport.
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 > Expanda On-Demand TechSupport Folder > Clique com o botão direito do mouse na política a ser usada > Coletar suportes técnicos.
   
   • Ou clique com o botão esquerdo do mouse em On-Demand Tech Support Policy para exibi-la no painel principal; em seguida, clique no ícone de Chave inglesa/martelo e escolha Coletar suportes técnicos.
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 TechSupport, o Destino de exportação (Local remoto) pode ser verificado para todos os arquivos do TechSupport.
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 Operational (Operacional) da On-Demand Tech Support Policy (Política de suporte técnico sob demanda). Cada arquivo tem um link para download via http/https. Cada nó tem três links, um link vinculado a cada arquivo.

Note: Se a versão for anterior à 2.2, você deverá usar a conta de usuário administrador local para fazer o download do TechSupports 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 de TechSupports pela interface do usuário. Em vez disso, eles podem usar o sftp ou outro método para extrair os arquivos do TechSupport do diretório /data/techsupport/ nos APICs correspondentes.

Note:  O número na URL do pacote do TechSupport indica em qual APIC o arquivo reside. Por exemplo, files/2/techsupport.tgz indica que esse pacote específico é encontrado no diretório /data/techsupport/ do APIC 2.

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

Se os arquivos TechSupports tiverem sido gerados com a opção Exportar para controlador, a GUI mostrará três URLs por nó ACI (nó APIC ou nó Switch). Cada URL é um tipo de arquivo de registro diferente e contém informações exclusivas. O TAC normalmente exige que todos os três arquivos sejam carregados por nó para receber todo o registro para uma análise completa.

Cada URL mapeia 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

Note:  Se um Destino de exportação tiver sido selecionado em vez de Exportar para controlador, o Local remoto definido criará 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, portanto, é importante verificar se cada APIC contém os arquivos de suporte técnico coletados.

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

3. 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

O suporte técnico sob demanda é sempre preferível a um suporte técnico local, pois um suporte técnico sob demanda oferece 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 locais do TechSupport:

• O APIC não é totalmente adequado.
• O switch ACI ainda não foi descoberto pelo APIC.
• O switch da ACI perdeu a comunicação com o APIC.
• O processo interno não está funcionando corretamente, o que está impedindo que o suporte técnico sob demanda funcione completamente (raro).

Acionar usando a CLI do APIC

1. Abra uma sessão SSH com o APIC com credenciais de administrador.
   • 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: Baixe o arquivo de suporte técnico usando o SCP:
     • WinSCP ou pscp.exe (Usuários do Windows).
     • Cliente SCP nativo (Usuários MAC).
   • Opção B: Baixe o arquivo de suporte técnico usando o 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 com credenciais de administrador.
     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 ACI com credenciais de administrador.
   • 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: Baixe o arquivo de suporte técnico do switch da ACI usando o SCP:
  • WinSCP ou pscp.exe (Usuários do Windows).
  • Cliente SCP nativo (Usuários MAC).
• Opção B: Baixe o arquivo de suporte técnico usando o HTTPS usando o 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 com credenciais de administrador.
  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

Consulte alguns dos principais campos dos comandos show tech:

Arquivo/local do TechSupport	Descrição
var/	Contém logs detalhados e um status de todos os serviços monitorados. Ele tem arquivos de informações de serviço, como as configurações de 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ções não voláteis 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	Obtenha informações básicas sobre o estado do CIMC.
rede	Receber informações atuais de configuração de rede e soquete.
obfl	Obtenha obfl (On-Board Failure Logs, Registros de falhas on-board) em tempo real.
mensagens	Receber 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 resultados básicos adicionais, como falhas, eventos e auditorias, que geralmente são necessários para a RCA.

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

Note: A partir da versão 5.2(1g), você pode usar o comando CLI trigger tacoutput 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 - versões 5.2/5.3/6.0(3d) e posteriores

Para Estruturas ACI executando a versão 5.2/5.3/6.0(3d) e versões posteriores, a saída de acionador fornece uma interface de coleta simplificada para eventos, falhas, auditorias 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:///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 pré-5.2/5.3/6.0(3d), há um Script Collect TacOutput disponível no repositório aci-tac-scripts, que serve uma interface semelhante à do 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 ACI e o APIC têm vários processos que controlam vários 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 trava 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:

Histórico de revisões

Revisão	Data de publicação	Comentários
9.0	08-Jun-2026	Ortografia, gramática, estrutura de frases, texto alternativo editado e espaçamento atualizados.
8.0	06-May-2024	PII, Título, Tradução Automática, Contêineres de Anotações e Formatação Atualizados.
7.0	23-Apr-2024	Atualização de formato e links para o guia do conector de dispositivo para APIC e ND
5.0	27-May-2022	A geração e o upload do suporte técnico para a Intersight via APIC/ND foram atualizados.
4.0	16-Mar-2022	Caminho adicionado ao script TacOutput no GIT.
3.0	22-Feb-2022	Atualização secundária.
2.0	17-Dec-2021	A CLI do APIC "acionador de saída" foi adicionada ao documento.
1.0	06-Sep-2021	Versão inicial