收集ACI技術支援和TAC請求輸出指南

簡介

本檔案介紹使用TAC for ACI進行故障排除所需的各種日誌和輸出。

背景資訊

有關在開啟TAC案例之前收集哪些資料的快速參考，請參閱表1。

表 1：記錄/顯示技術收集對照表:

問題	收集項目	備註
升級問題	具有升級問題的節點的隨選技術支援. 所有 APIC 的隨選技術支援. 通過TacOutput進行其他故障、事件和稽核。	如果APIC出現差異且按需技術支援收集失敗，請收集本地技術支援。
隨機連線問題	來自src節點（連線src端點的位置）的按需技術支援。 來自dst節點（dstendpoint連線的位置）的按需技術支援。 通過TacOutput進行其他故障、事件和稽核。
連線完全中斷	來自枝葉的按需技術支援（src和dst）。 骨幹的隨選技術支援. APIC 的隨選技術支援 通過TacOutput進行其他故障、事件和稽核。	如果持續中斷，請聯絡 TAC 尋求即時偵錯。如果節點因為任何原因而重新啟動，請在重新載入前收集記錄（如要求 RCA）。
叢集問題	所有 APIC 的隨選技術支援 通過TacOutput進行其他故障、事件和稽核。	如果APIC出現差異且按需技術支援收集失敗，請收集本地技術支援。
路由問題	具有路由問題的節點隨選技術支援. 通過TacOutput進行其他故障、事件和稽核。
節點損毀/非預期的重新載入	損毀節點的隨選技術支援. 崩潰節點的崩潰/核心檔案。 通過TacOutput進行其他故障、事件和稽核。
APIC 應用程式問題	所有 APIC 的隨選技術支援. 受影響之應用程式的 APIC 應用程式技術支援.

ACI APIC 和交換器

隨選技術支援

通過APIC觸發並上傳到Intersight - Nexus Insights雲聯結器應用

要使用此方法，請參閱必須通過APIC在Intersight上連線並宣告的ACI交換矩陣：Nexus Insights雲端聯結器應用程式。

1. 導覽至：APIC > Apps > Installed Apps >開啟NICC App > TAC Assist >按一下Begin
2. 選擇節點，然後按一下Collect Logs。
3. 作業狀態為COMPLETE後，按一下View Details。
4. 在作業詳細資訊頁中，在Logs表下，在File下，查詢Cloud列。 
5. 按一下「Upload」，獲取每個裝置的「TechSupport Bundle」。

通過ND觸發並上傳到Intersight - Nexus控制面板見解

要使用此方法，請參閱必須通過Nexus儀表板在Intersight上連線並宣告的ACI交換矩陣：Nexus儀表板見解。

1. 導覽至：Nexus Dashboard > Admin Console > Services > Open Nexus Dashboard Insights > Troubleshoot > Log Collector。
2. 按一下New Log Collection。
   1. 向日誌集合新增名稱。
   2. 選擇站點。 
   3. 啟用「自動上傳日誌檔案」覈取方塊。
   4. 按一下Select Nodes，然後選擇節點。
   5. 按一下Start Collection。
   6. 技術支援檔案上傳到intersight.com  
3. 上傳完成後，通知TAC在Intersight上傳檔案。 
4. TAC工程師可將檔案從Intersight移到TAC案例進行分析。 

透過 APIC UI 觸發

建立隨選技術支援原則

附註：除非 TAC 明確要求，否則請勿指定技術支援時間範圍。如果日誌變動過大，則這樣做可能會導致日誌丟失。這嚴重影響TAC提供及時RCA的能力。如果提供了「技術支援時間範圍」，它將根據上次檔案修改時間戳修剪日誌，而不是根據日誌檔案自身內的時間戳修剪日誌。

1. 在選單欄中，按一下Admin > Import/Export > Export Policies >按一下右鍵On-demand TechSupport>Create On-demand TechSupport。
2. 在「建立隨選技術支援」對話方塊的欄位中輸入正確的值。
   • 如果遠端位置無法使用，請按一下「匯出至控制器」。生成的技術支援一旦生成，即通過GUI的Operational頁籤下載。
   • 勾選「將所有控制器納入技術支援」以產生 APIC 技術支援。
   • Source Nodes欄位允許您指定生成技術支援的交換機節點。
3. 按一下「提交」以建立隨選技術支援原則。

生成按需技術支援。

1. 導覽至現有的隨選技術支援原則。建立的策略位於：管理>匯入/匯出>匯出策略>按需技術支援>展開按需技術支援資料夾>按一下右鍵要使用的策略>收集技術支援。
   
   • 或者左鍵點選按需技術支援策略，將其置於主窗格中；接著按一下「扳手/鐵鎚」圖示，然後選擇「收集技術支援」。
2. 選擇「是」以開始收集技術支援資訊。

收集生成的技術支援。

1. 如果在生成技術支援期間未啟用匯出到控制器，則可以檢查所有技術支援檔案的匯出目標（遠端位置）。
2. 如果「匯出至控制器」已啟用，請導覽至產生技術支援所憑藉的隨選技術支援原則。在Admin > Import/Export > Export Policies >On-Demand TechSupport上可以找到建立的策略。
   • 可在按需技術支援策略的「操作」頁籤中找到生成的技術支援。每個檔案都有一個可透過http/https下載的連結。每個節點有三個連結，每個檔案都繫結一個連結。

附註：如果版本低於2.2，則必須使用本地管理員使用者帳戶通過UI下載技術支援。 否則，請使用任何其他具有管理員權限的本機帳戶。遠端使用者無法通過UI下載技術支援。相反，它們可以使用sftp或其他方法從相應APIC上的/data/techsupport/目錄提取技術支援檔案。

附註： 技術支援捆綁包的URL中的編號指示檔案所在的APIC。例如，files/2/techsupport.tgz表示在APIC 2的/data/techsupport/目錄中找到此特定捆綁包。

隨選技術支援檔案說明

如果技術支援檔案是使用「匯出到控制器」選項生成的，則GUI會顯示每個ACI節點（APIC節點或交換機節點）的三個URL。 每個 URL 為不同的記錄檔案類型，且包含唯一資訊。TAC通常要求每個節點上傳所有三個檔案以接收所有日誌記錄，以便進行完整分析。

每個URL對映到以下三種檔案型別之一：

類別	一般尾碼	適用於：	檔案大小
匯出	_1of3.tgz	稽核/故障記錄	中小型
記錄檔	_logs_3of3.tgz	程序記錄	最大型
DB	_db_2of3.tgz	MO 傾印	小型

附註：  如果選擇了「匯出目標」而不是「匯出到控制器」，則定義的遠端位置會建立一個資料夾，其中包含每個節點三個檔案。

如果使用瀏覽器連結下載技術支援時出現問題，請使用scp或sftp客戶端（如WinSCP或FileZilla）直接從APIC儲存下載檔案。

1. 連線 (sftp) 至每個 APIC。收集的技術支援檔案儲存在所有可用的APIC中，因此，檢查每個APIC收集的技術支援檔案非常重要。

2. 導覽至連線之 APIC 中的 /data/techsupport 資料夾（在所有 APIC 控制器中重複此步驟）。

3.查詢名稱中包含按需技術支援策略名稱（在本例中為ABCTECH）的檔案，然後將這些檔案下載到您的電腦。

技術支援本機

相對於本地技術支援，按需技術支援始終是首選技術，因為按需技術支援可提供更完整的檢視。 但是，當收集透過原則觸發時，其仰賴完全合適的 APIC 叢集。

技術支援本地場景：

• APIC未完全安裝。
• APIC尚未發現ACI交換機。
• ACI交換機已失去與APIC的通訊。
• 內部進程發生故障，導致按需技術支援無法完全運行（極少）。

透過 APIC CLI 觸發

1. 使用具有管理員憑據的APIC開啟SSH會話。
   • 如果您無法使用管理員憑據登入，請使用使用者名稱rescue-user。密碼可以與admin local使用者相同。
2. 運行命令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. 下載本機技術支援。
   
   • 選項 A： 使用 SCP 下載技術支援檔案：
     • WinSCP或pscp.exe（Windows使用者）。
     • 本地SCP客戶端（MAC使用者）。
   • 選項 B： 使用 HTTPS 下載技術支援檔案：
     1. 開啟瀏覽器，例如Chrome或Firefox。
     2. 導覽至：https://<aci.apic.ip.addr>/files/<apic#>/techsupport/<ts_filename>
        • 範例：https://a.p.i.c/files/1/techsupport/local_apic1_2018-05-29T08-17.tgz
     3. 使用管理員憑據登入。
     4. 如果出現提示，請選取瀏覽器下載提示上的儲存檔案。

透過交換器 CLI 觸發

1. 使用管理員憑據開啟ACI交換機的SSH會話。
   • 如果APIC尚未發現交換機，請使用使用者名稱admin。
2. 運行命令:"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. 下載本機技術支援。

• 選項 A： 從使用 SCP 的 ACI 交換器下載技術支援檔案：
  • WinSCP或pscp.exe（Windows使用者）。
  • 本地SCP客戶端（MAC使用者）。
• 選項 B： 透過 APIC 使用 HTTPS 下載技術支援檔案：
  
  1. 登入到APIC CLI（注意步驟4中使用哪個APIC）。
  2. 使用以下命令將techsupport檔案從ACI交換機傳輸到APIC:
     • scp <node-name>:/data/techsupport/<ts_filename> /data/techsupport
     • 範例：apic1# scp fab5-leaf1:/data/techsupport/local_fab5-leaf1_2018-05-29T08-16.tgz /data/techsupport
  3. 開啟瀏覽器，例如Chrome或Firefox。
  4. 導覽至：https://<aci.apic.ip.addr>/files/<apic#>/techsupport/<ts_filename>
     • 範例：https://a.p.i.c/files/1/techsupport/local_fab5-leaf1_2018-05-29T08-16.tgz
  5. 使用管理員憑據登入。
  6. 如果出現提示，請選取瀏覽器下載提示上的儲存檔案。

CIMC 技術支援

透過 CIMC UI 觸發

可以從APIC CIMC收集技術支援來檢視與APIC機箱相關的日誌。CIMC show tech可以在本地捕獲，或從CIMC Admin頁籤的Utilities部分傳送到遠端位置。 

通過CIMC CLI觸發

在 APIC CIMC CLI 輸入：

~ # 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 

解析CIMC技術支援

請參閱show tech命令中的一些關鍵欄位：

技術支援檔案/位置	說明
var/	包含詳細日誌和所有受監控服務的狀態。它包含服務資訊檔案，例如SOL和IPMI感測器警報的配置。
var/log	包含循環的易失性日誌消息。
obfl/	包含滾動的非易失性日誌消息。
met/	非易失性配置和SEL。
mp/	show tech-support文本檔案以及BIOS技術支援文本檔案。該文字檔案包含所有程序、網路、系統、夾層及 BIOS 狀態資訊。
mctool	獲取有關CIMC狀態的基本資訊。
網路	接收當前網路配置和套接字資訊。
obfl	獲取即時日誌（板載故障日誌）。
消息	接收即時/var/log/messages檔案。
警報	列出處於警報狀態的感測器。
感測器	來自IPMI的當前感測器讀數。
強化	x86的當前電源狀態。

延伸稽核、事件及故障等 (TacOutput)

TAC可以請求額外的基本輸出，例如故障、事件和稽核，這些通常是RCA所必需的。

到今天為止，show techs已經包含了這些對象的子集，但是，只有最後的10,000條記錄。在某些情況下，TAC需要完整記錄集，超過10,000條記錄。

附註：從版本5.2(1g)開始，可以使用CLI命令觸發來自APIC的輸出來收集這些附加對象。但是，在5.3(x)和6.0(3d)之前的版本中，內建指令碼可能無法收集所有頁的記錄。在此案例中，建議使用下一部分中概述的aci-tac-scripts儲存庫中指令碼的最新版本。

通過觸發TACOoutput - 5.2/5.3/6.0(3d)和更新版本觸發

對於運行版本5.2/5.3/6.0(3d)和更新版本的ACI交換矩陣，觸發器計數為事件、故障、審計和其他故障排除輸出提供簡化的收集介面):

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

通過收集TACOutputs指令碼觸發

對於運行5.2/5.3/6.0(3d)之前版本的ACI交換矩陣，aci-tac-scripts儲存庫中提供Collect TacOutput指令碼，該指令碼充當類似於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

損毀/核心檔案

透過 APIC UI 收集

ACI交換機節點和APIC擁有許多控制系統各個功能方面的進程。 如果系統在特定程序中發生軟體故障，則會產生核心檔案，並重新載入程序。當進程崩潰並生成核心檔案時，將生成故障和事件。 當交換器/APIC 的程序損毀時，系統會壓縮核心檔案並複製到 APIC。

APIC GUI提供收集交換矩陣節點核心檔案的中心位置。可在Admin > IMPORT/EXPORT in Export Policies > Core中建立新匯出策略。

有一個預設核心策略，可以直接下載檔案。生成時，所有生成的核心轉儲檔案都會嘗試傳輸到APIC控制器。如果成功，則可以在預設核心策略下找到它們。

獨立稽核記錄

透過 NDO/MSO UI 收集

MSC審計日誌可以以CSV格式的JSON格式下載：

修訂記錄

修訂	發佈日期	意見
9.0	08-Jun-2026	更新的拼寫、語法、句子結構、編輯的替代文字和間距。
8.0	06-May-2024	更新的PII、標題、機器翻譯、附註容器和格式。
7.0	23-Apr-2024	APIC和ND裝置聯結器指南的格式更新和連結
5.0	27-May-2022	通過APIC/ND更新了技術支援生成和上傳到Intersight。
4.0	16-Mar-2022	新增了GIT上TacOutput指令碼的路徑。
3.0	22-Feb-2022	次要更新。
2.0	17-Dec-2021	將「觸發器輸出」APIC CLI新增到文檔。
1.0	06-Sep-2021	初始版本