ACIテクニカルサポートおよびTAC要求出力ガイドの収集

はじめに

このドキュメントでは、TAC for ACIを使用する場合のトラブルシューティングに必要なさまざまなログと出力について説明します。

バックグラウンド情報

TACケースをオープンする前に収集するデータのクイックリファレンスについては、表1を参照してください。

表1：ログ/Show tech収集マトリックス：

問題	収集対象	注意事項
アップグレードの問題	アップグレードの問題のあるノードからのオンデマンド テクニカルサポート. すべての APIC からのオンデマンド テクニカルサポート. TacOutputによる障害、イベント、監査の追加	APICが分散され、オンデマンドTechSupport収集が失敗する場合は、TechSupport Localを収集します。
ランダム接続の問題	srcノード（srcエンドポイントが接続されている）からのオンデマンドのテクニカルサポート。 dstノード（dstendpointが接続されている場所）からのオンデマンドのテクニカルサポート TacOutputによる障害、イベント、監査の追加
接続の完全な消失	リーフ（srcおよびdst）からのオンデマンドのテクニカルサポート スパインからのオンデマンド テクニカルサポート. APIC からのオンデマンド テクニカルサポート TacOutputによる障害、イベント、監査の追加	継続的な停止については、TAC に連絡してライブデバッグを依頼してください。何らかの理由でノードを再起動する必要があるときに RCA が要求される場合は、リロードする前にログを収集します。
クラスタリングの問題	すべての APIC からのオンデマンド テクニカルサポート TacOutputによる障害、イベント、監査の追加	APICが分散され、オンデマンドTechSupport収集が失敗する場合は、TechSupport Localを収集します。
ルーティングの問題	ルーティングの問題のあるノードからのオンデマンド テクニカルサポート. TacOutputによる障害、イベント、監査の追加
ノードのクラッシュ/予期しないリロード	クラッシュしたノードからのオンデマンド テクニカルサポート. クラッシュしたノードのクラッシュ/コアファイル。 TacOutputによる障害、イベント、監査の追加
APIC アプリの問題	すべての APIC からのオンデマンド テクニカルサポート. 影響を受けるアプリの APIC アプリテクニカルサポート.

ACI APIC とスイッチ

オンデマンド テクニカルサポート

トリガーし、APIC経由でIntersightにアップロード：Nexus Insights Cloud Connectorアプリケーション

この方法を使用するには、「ACIファブリックは、APIC:Nexus Insights Cloud Connectorアプリケーションを介してIntersightに接続され、要求される必要があります」を参照してください。

1. APIC > Apps > Installed Apps > Open the NCC App > TAC Assist > Click Beginの順に選択します。
2. ノードを選択し、Collect Logsをクリックします。
3. ジョブのステータスがCOMPLETEになったら、View Detailsをクリックします。
4. Job DetailsページのLogsテーブルの下のFileの下で、Cloud列を見つけます。 
5. 各デバイスのテクニカルサポートバンドルに対してUploadをクリックします。

ND経由でIntersightにトリガーおよびアップロード – Nexus Dashboard Insights

この方法を使用するには、「Nexus Dashboard: Nexus Dashboard Insights」を使用してACIファブリックが接続され、Intersightで要求される必要があります。

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. アップロードが完了したら、IntersightにファイルがアップロードされたことをTACに通知します。 
4. TACエンジニアは、分析のためにIntersightからTACケースにファイルを移動できます。 

APIC UI を介したトリガー

オンデマンド テクニカルサポート ポリシーの作成

注：TACから明示的な指示がない限り、テクニカルサポートの時間範囲を指定しないでください。過剰なログチャーンがあると、ログが失われる可能性があります。これは、TACがタイムリーにRCAを提供する機能に重大な影響を与えます。TechSupport Time Rangeを指定すると、最後のファイル変更タイムスタンプに基づいてログが削除されますが、ログファイル自体に含まれるタイムスタンプに基づいて削除されません。

1. メニューバーで、Admin > Import/Export > Export Policies > On-demand TechSupport > Create On-demand TechSupportの順にクリックします。
2. [Create On-demand TechSupport] ダイアログボックスのフィールドに適切な値を入力します。
   • リモートロケーションが利用できない場合は、[Export to Controller] をオンにします。生成されたテクニカルサポートは、生成された後、GUIのOperationalタブを介してダウンロードされます。
   • [Include All Controllers in TechSupport] をオンにして、APIC テクニカルサポートを生成します。
   • Source Nodesフィールドでは、テクニカルサポートを生成するスイッチノードを指定できます。
3. [Submit] をクリックして、オンデマンド テクニカルサポート ポリシーを作成します。

オンデマンドのテクニカルサポートを生成します。

1. 既存のオンデマンド テクニカルサポート ポリシーに移動します。作成したポリシーは次の場所にあります。Admin > Import/Export > Export Policies > On-Demand TechSupport > Expand On-Demand TechSupport folder > Expand the Policy to be used > Collect Tech Supports.
   
   • または、オンデマンドTechSupportポリシーを左クリックしてメインペインに表示し、Wrench/HammerアイコンをクリックしてCollect Tech Supportsを選択します。
2. [Yes] を選択して、テクニカルサポート情報の収集を開始します。

生成されたテクニカルサポートを収集します。

1. テクニカルサポートの生成時にコントローラへのエクスポートが有効になっていない場合は、エクスポート先（リモートの場所）ですべてのテクニカルサポートファイルを確認できます。
2. [Export to Controller] が有効になっている場合は、テクニカルサポートが生成されたオンデマンド テクニカルサポート ポリシーに移動します。作成したポリシーは、Admin > Import/Export > Export Policies > On-Demand TechSupportで確認できます。
   • 生成されたテクニカルサポートは、オンデマンドTechSupportポリシーのOperationalタブ内にあります。各ファイルには、http/https経由でダウンロードするリンクがあります。各ノードには3つのリンクがあり、1つのリンクが各ファイルに結び付けられています。

注：バージョンが2.2より前の場合は、ローカルの管理者ユーザアカウントを使用して、UI経由でTechSupportsをダウンロードする必要があります。 それ以外の場合は、管理者権限を持つ他のローカルアカウントを使用します。リモートユーザは、UI経由でTechSupportをダウンロードできません。代わりに、sftpまたは別の方法を使用して、対応するAPICの/data/techsupport/ディレクトリからTechSupportファイルを取得できます。

注：テクニカルサポートバンドルの URL 内にある番号は、ファイルが存在する APIC を示しています。たとえば、files/2/techsupport.tgzは、この特定のバンドルがAPIC 2の/data/techsupport/ディレクトリにあることを示します。

オンデマンド テクニカルサポート ファイルの説明

TechSupportsファイルがExport to Controllerオプションで生成された場合、GUIにはACIノード（APICノードまたはスイッチノード）ごとに3つのURLが表示されます。 URL ごとにログファイルのタイプが異なり、固有の情報が含まれています。通常、TACでは、完全な分析のためにすべてのロギングを受信するために、3つのファイルすべてをノードごとにアップロードする必要があります。

各URLは、次の3つのファイルタイプのいずれかにマッピングされます。

[Category]	典型的なサフィックス	便利な用途	ファイル サイズ
エクスポート	_1of3.tgz	監査/障害ログ	小から中
ログ	_logs_3of3.tgz	プロセスログ	最大
DB	_db_2of3.tgz	MO ダンプ	小

注：コントローラへのエクスポートではなくエクスポート先を選択した場合、定義済みのリモートロケーションによって、ノードごとに3つのファイルを含むフォルダが作成されます。

ブラウザリンクを使用したテクニカルサポートのダウンロードで問題が発生した場合は、scpまたはsftpクライアント（WinSCPまたはFileZillaなど）を使用してAPICストレージから直接ファイルをダウンロードします。

1. 各 APIC に接続（sftp）します。収集されたテクニカルサポートファイルは、使用可能なすべてのAPICに保存されます。したがって、収集されたテクニカルサポートファイルについて各APICを確認することが重要です。

2. 接続された APIC の /data/techsupport フォルダに移動します（すべての APIC コントローラでこの手順を繰り返します）。

3. オンデマンドテクニカルサポートポリシー名を含む名前のファイル（この例ではABCTECH）を検索し、それらのファイルをコンピュータにダウンロードします。

テクニカルサポートローカル

オンデマンドのテクニカルサポートは状況を完全に把握できるため、オンデマンドのテクニカルサポートは常にテクニカルサポートのローカルのサポートよりも推奨されます。 ただし、収集はポリシーによってトリガーされるため、完全に適合した APIC クラスタに依存しています。

テクニカルサポートのローカルシナリオ：

• APICは完全には適合しません。
• ACIスイッチは、まだAPICによって検出されていません。
• ACIスイッチとAPICとの通信が失われました。
• 内部プロセスが正常に機能していないため、オンデマンドのテクニカルサポートが完全に動作しない（まれ）。

APIC CLI を介したトリガー

1. 管理者クレデンシャルを使用してAPICでSSHセッションを開きます。
   • ログインにadminクレデンシャルを使用できない場合は、ユーザ名rescue-userを使用します。パスワードは、adminローカルユーザと同じにすることができます。
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を使用してtechsupportファイルをダウンロードします。
     • WinSCPまたはpscp.exe（Windowsユーザ）。
     • ネイティブSCPクライアント（MACユーザ）。
   • オプションB:HTTPSを使用してtechsupportファイルをダウンロードします。
     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. プロンプトが表示されたら、ブラウザのダウンロードプロンプトで [Save File] を選択します。

スイッチ 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スイッチからtechsupportファイルをダウンロードします。
  • WinSCPまたはpscp.exe（Windowsユーザ）。
  • ネイティブSCPクライアント（MACユーザ）。
• オプションB:APIC経由でHTTPSを使用してtechsupportファイルをダウンロードします。
  
  1. APIC CLIにログインします（ステップ4で使用されているAPICに注意してください）。
  2. 次のコマンドを使用して、ACIスイッチからAPICにtechsupportファイルを転送します。
     • scp <ノード名>:/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. プロンプトが表示されたら、ブラウザのダウンロードプロンプトで [Save File] を選択します。

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/	ローリング不揮発性ログメッセージを含みます。
対応/	不揮発性設定とSEL。
mp/	show tech-supportテキストファイルと、BIOS tech-supportテキストファイル。このテキストファイルには、すべてのプロセス、ネットワーク、システム、メザニン、および BIOS の状態情報が含まれています。
mctool	CIMCの状態に関する基本情報を取得します。
network	現在のネットワーク設定とソケット情報を受信します。
obfl	ライブobfl(On-Board Failure Logs)を取得します。
メッセージ	ライブ/var/log/messagesファイルを受信します。
アラーム	アラーム状態のセンサーをリストします。
センサー	IPMIからの現在のセンサーの読み取り
電力	x86の現在の電源状態です。

監査、イベント、障害などの拡張（TacOutput）

TACは、障害、イベント、監査などの追加の基本出力を要求できます。これらは通常、RCAに必要です。

現在、show techsにはこれらのオブジェクトのサブセットがすでに含まれていますが、最後の10,000レコードのみが含まれています。場合によっては、TACは10,000レコードを超えるフルセットのレコードを必要とします。

注：リリース5.2(1g)以降では、APICからCLIコマンドtrigger tacoutputを使用して、これらの追加オブジェクトを収集できます。ただし、5.3(x)および6.0(3d)より前のリリースでは、組み込みスクリプトでレコードのすべてのページを収集できない場合があります。この場合は、次のセクションで概説するaci-tac-scriptsリポジトリ内で最新バージョンのスクリプトを使用することを推奨します。

トリガーによるトリガーTACOutput - 5.2/5.3/6.0(3d)以降のリリース

バージョン5.2/5.3/6.0(3d)以降のリリースを実行しているACIファブリックの場合、trigger tacoutputにより、イベント、障害、監査、およびその他のトラブルシューティング出力のための簡素化された収集インターフェイスが提供されます。

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

Collect 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	「trigger tacoutput」APIC CLIをドキュメントに追加。
1.0	06-Sep-2021	初版