デバッグシステムを使用したISEのトラブルシューティング

はじめに

このドキュメントでは、CLIで show logging コマンドを実行することによって、エラーが発生している間のトラブルシューティングとエラーのキャッチを行う方法について説明します。

前提条件

要件

次の項目に関する知識があることが推奨されます。

• Identity Services Engine(ISE)を使用します。
• コマンドラインインターフェイス(CLI)。 

使用するコンポーネント

このドキュメントの情報は、Identity Services Engine(ISE)3.3バージョンに基づくものです。

このドキュメントの情報は、特定のラボ環境にあるデバイスに基づいて作成されました。このドキュメントで使用するすべてのデバイスは、クリアな（デフォルト）設定で作業を開始しています。本稼働中のネットワークでは、各コマンドによって起こる可能性がある影響を十分確認してください。 

背景説明

ISEは、ログファイルを保存するために特定の構造を利用します。これについては、この記事で詳しく説明します。そのためには、CLIを使用して、show loggingコマンドを実行することでリアルタイムのエラー検出を実行します。

問題の説明

Cisco Identity Services Engine(ISE)には、ローカルログメッセージを保存するためのフォルダがあります。問題の性質に応じて、2つの主要なshow loggingコマンドを使用して診断とトラブルシューティングを行うことができます。

1 – システムフォルダ

システムフォルダにはシステムsyslogが表示され、ライブエラーを表示できます。このロギング機能は、ISEサービスの問題など、システム関連の問題を特定するのに役立ちます。

システムフォルダへのアクセス方法：

このフォルダには、CLIから次のコマンドを使用してアクセスできます。

• show logging system <LogFile>

使用可能なシステムフォルダの例：

SSPT33A/admin#show logging system 5105179 Jul 17 2024 20:09:49 ade/ADE.log 29542 Jan 02 2024 16:36:28 anaconda/anaconda.log 1012889 Jan 02 2024 16:36:28 anaconda/syslog 564 Jan 02 2024 17:07:06 boot.log 1416192 Jul 06 2024 13:57:25 btmp 292292 Jul 17 2024 20:09:07 lastlog 0 Jan 02 2024 16:31:58 maillog 4623022 Jul 17 2024 20:11:43 messages 548756 Jul 01 2024 23:50:00 sa/sa01 4173362 Jul 17 2024 20:11:11 secure 0 Jan 02 2024 16:31:58 spooler 16896 Jul 17 2024 19:38:55 wtmp SSPT33A/admin#

注：ロギングの実行を中断するには、単にCtrlキーを押した状態でCキーを1回押します。

2:ロギングフォルダ

ロギングフォルダにはアプリケーションのsyslogが表示され、ライブエラーを表示できます。このロギング機能は、通信の問題、ポスチャ、ゲストサービス、プロファイリングなど、特定の機能に関連する問題の特定に役立ちます。

開始する前に

問題を再現する場合は、ほとんどの場合、最初にデバッグレベルまたはトレースレベルで適切なコンポーネントを設定する必要があります。Operation > Troubleshoot > Debug Wizard > Debug Log Configurationの順に移動し、ノードを選択して、Component Nameの下のlogレベルをクリックし、必要なLogレベルを選択して、Save.Setting Componentをクリックします。

注：問題を再現した後で、コンポーネントレベルをデフォルトに戻す必要があることを考慮してください。

警告: runtime-aaa、runtime-logging、およびruntime-configに対してデバッグログを有効にすると、システムのパフォーマンスが大幅に影響を受けます。パフォーマンスの低下を避けるため、これらのログは15分以上デバッグするように設定しないでください。

プロファイル設定のデバッグ

Debug Wizardには、ISEノードの問題をトラブルシューティングするためのヘルプを含む定義済みデバッグテンプレートが用意されています。テンプレート内の個々のコンポーネントにデバッグログ重大度レベルを設定できます。 さまざまなコンポーネントの詳細なロギングを設定するプロセスを簡素化する、事前定義されたデバッグテンプレートが用意されています。

これらのテンプレートは、一般的なトラブルシューティングシナリオに対応するように設計されており、管理者が必要なデバッグ設定を迅速かつ簡単に設定してアクティブ化できるようにします。

テンプレートを使用または設定するには、Operation > Troubleshoot > Debug Wizard > Debug Profile Configuration:

プロファイル設定のデバッグ

事前に定義されたテンプレートがすでにいくつかありますが、Addをクリックして独自のテンプレートを作成することもできます。

新しいテンプレートの追加

テンプレートの有効化

テンプレートを有効にすると、変更したコンポーネントレベルが有効になります。Templateを選択して、Debug Nodesをクリックします。テンプレートを適用するノードを選択して、Saveをクリックします。

デバッグノード

 ここで、テンプレートにはノードが割り当てられている必要があります。

確認

注：特定のノードでテンプレートを使用するまで、コンポーネントレベルは有効になりません。

デバッグプロファイルテンプレートを無効にするには、テンプレートを選択します。Debug Nodesをクリックします。テンプレートを適用するノードのチェックマークを外して、Saveをクリックします。

テンプレートの無効化

コンポーネントレベルを既定に戻す

Operation > Troubleshoot > Debug Wizard > Debug Log Configurationの順に移動します。ノードを選択します。Reset toDefault、Yesの順にクリックします。

デフォルトにリセット

警告: Debug Profileテンプレートが有効な状態でReset to Defaultオプションを使用すると、Debug Profiletemplateは有効なままになりますが、コンポーネントはデフォルト設定に戻るため、不一致が発生します。Debug Profile templatesがイネーブルになっている場合は、Reset to Defaultオプションを使用しないことが重要です。

詳細と具体的な例については、シスコの公式ドキュメントを参照してください。このドキュメントには、コンポーネントとデバッグログの包括的なマトリックス「ISEでのデバッグのトラブルシューティングと有効化」が記載されています。

ロギングフォルダへのアクセス方法：

このフォルダには、CLIから次のコマンドを使用してアクセスできます。

• show logging application <logfile>

例：ISEゲストサービスに関する情報 show logging application profiler.log tail

例：ISEゲストサービスに関する情報 show logging application guest.log tail

特定のメッセージを探すだけでなく、キーワードを使用して探します。例：ISEについての情報 –  show logging application localStore/iseLocalStore.log | include 70000\ NOTICE\  

SSPT33A/admin#show logging application localStore/iseLocalStore.log | include 70000\ NOTICE\ 2024-07-18 00:03:28.668 -05:00 0000423187 70000 NOTICE System-Stats: ISE Utilization, ConfigVersionId=14667, SysStatsUtilizationCpu=5.41%, SysStatsUtilizationNetwork=eth0: rcvd = 2052\; sent = 4062 \;rcvd_dropped = 0\; sent_dropped = 0, SysStatsUtilizationNetwork=cni-podman1: rcvd = 1577511\; sent = 115782 \;rcvd_dropped = 0\; sent_dropped = 0, SysStatsUtilizationNetwork=veth2f590a1a: rcvd = 2024-07-18 00:08:46.369 -05:00 0000423194 70000 NOTICE System-Stats: ISE Utilization, ConfigVersionId=14667, SysStatsUtilizationCpu=1.36%, SysStatsUtilizationNetwork=eth0: rcvd = 1959\; sent = 3012 \;rcvd_dropped = 0\; sent_dropped = 0, SysStatsUtilizationNetwork=cni-podman1: rcvd = 1576019\; sent = 114411 \;rcvd_dropped = 0\; sent_dropped = 0, SysStatsUtilizationNetwork=veth2f590a1a: rcvd = SysStatsUtilizationDiskSpace=8% /opt, SysStatsUtilizationDiskSpace=1% /mnt/encpart, SysStatsUtilizationDiskSpace=8% /opt/podman/containers/storage/overlay, AverageRadiusRequestLatency=0, AverageTacacsRequestLatency=0, DeltaRadiusRequestCount=0, DeltaTacacsRequestCount=0, SysStatsUtilizationLoadAvg=0.40, SysStatsCpuCount=16, SysStatsProcessMemoryMB=18082, ActiveSessionCount=0,

注：このコマンドはshow logging application localStore/iseLocalStore.log | include 70000\ NOTICE\は、パッチレベルまたはISEリリース（以前）によっては機能しません。または、show logging application localStore/iseLocalStore.log | 「70000 NOTICE」を含める

注：ロギングを中断するには、単にCtrlキーを押した状態でCキーを1回押します。

コマンドの分解

SSPT33A/admin#show logging application guest.log | include portalwebaction

説明：

• show：このコマンドは、情報を表示するために使用されます。
• logging：ログまたはログファイルを指します。
• application：ログを表示するアプリケーションまたはプロセスを指定します。
• guest.log:guest.logという名前のログファイルを指定します。
• include：コマンドのこの部分は、特定のパターンまたはキーワードに一致する行だけが含まれるように出力をフィルタリングします。
•   portalwebaction：前のコマンドの出力内で検索するキーワードまたはパターン(show logging application guest.log)。

必要なファイルの検索

特定のログ名が不明な場合は、フィルタリングしてさらにオプションを表示できます。次に例を示します。Enterキーを押すと、出力が表示されます。

ise3-3a/admin#show logging application | include pxgrid 14059847 Jul 18 2024 20:46:09 pxgrid/pxgrid-server.log 5367398 Jul 12 2024 23:59:39 pxgrid/pxgrid-server.log.2024-07-12-1 16261440 Jul 13 2024 23:59:44 pxgrid/pxgrid-server.log.2024-07-13-1 16261440 Jul 14 2024 23:59:49 pxgrid/pxgrid-server.log.2024-07-14-1 16261794 Jul 15 2024 23:59:53 pxgrid/pxgrid-server.log.2024-07-15-1 16261625 Jul 16 2024 23:59:58 pxgrid/pxgrid-server.log.2024-07-16-1 16261479 Jul 17 2024 23:59:45 pxgrid/pxgrid-server.log.2024-07-17-1 0 Jul 12 2024 15:42:36 pxgrid/pxgrid_dbsync_summary.log 0 Jul 12 2024 15:42:36 pxgrid/pxgrid_internal_dbsync_summary.log 16744 Jul 15 2024 20:45:49 pxgriddirect-connector.log 2841 Jul 15 2024 20:45:44 pxgriddirect-service.log 6277 Jul 12 2024 16:33:53 pxgriddirect-service.log.2024-07-12-1 ise3-3a/admin#