トラブルシューティング
リリース2.1.0以降、HealthBotは4つの検証およびトラブルシューティング機能をサポートしています。
Paragon Insightsセルフテスト:Paragon Insightsが正しく動作していることを検証します。
デバイス到達可能性テスト:ネットワークデバイスが稼働しており、ping&SSH経由で到達可能であることを検証します
取り込み接続テスト:特定のデバイスでサポートされている取り込みタイプを検証します
デバッグ無データ: デバイスがParagon Insights GUIで「データなし」と表示した場合にデバッグを提供します。
これらの機能にアクセスするには、左側のナビゲーション パネルから [ 管理] > [デバッグ ] に移動します。
Paragon Insightsセルフテスト
概要
Paragon Insightsで基本機能を設定する場合、問題の診断が困難な場合があります。インストールからデバイスの構成、デバイスの追加、プレイブックの適用まで、問題が発生したときに調査する可能性のある領域は多数あります。
HealthBotリリース2.1.0以降、セルフテストツールによってParagon Insightsのコア機能が検証されます。セルフテストを実行するために、ツールは一般的な一連のタスクを実行します。
シミュレートされたデバイスをParagon Insightsに追加します。
デバイス グループを作成し、デバイスを追加します。
ルールを作成します。
プレイブックを作成してデプロイする
シミュレートされたデバイスからデータをストリーミングします
ダッシュボードに進行中のステータスを表示します
セルフテストインスタンスは、基本的には完全に機能するセットアップとして機能し、完全にParagon Insightsシステム内で実行されます。テストが完了すると、ツールによってレポートが提供されます。
セルフテストツールのその他の用途
Paragon Insightsのインストールを検証するだけでなく、セルフテスト機能には以下もあります。
簡単なデモを行う簡単な方法 - セルフテストインスタンスは、Paragon Insightsに接続されたシミュレートされたデバイスを提供するため、実際のデバイスを追加したり、プレイブックを適用したりすることなく、Paragon Insightsのデモを行うことができます。
新規ユーザーが始めるための良い方法として、セルフテストではParagon Insightsに接続されたシミュレートされたデバイスを自動構成することで、デバイスの追加やプレイブックの適用などの複雑さを解消します。
「実行中の参照」-実際のデバイスに問題がある場合は、セルフテストインスタンスを使用して、問題がどこにあるかを判断するのに役立ちます。セルフテストインスタンスに問題がなければ、問題はParagon Insightsシステムにはありません。
使用上の注意
現在、この機能は、OpenConfigテレメトリとiAgent(NETCONF)用のデータをストリーミングするためのシミュレーションデバイスをサポートしています。
上記のように、セルフテストインスタンスを保持して「実行参照」として機能させることができます。
テスト結果の色分けは次のとおりです。
緑 = 合格
黄色 = エラー (テストできません)
赤 = 失敗
黄色または赤のステータスのアイテムには、問題の詳細が記載されたメッセージが含まれます。
未デプロイの変更がある場合は、セルフテスト・ツールを使用しないでください。セルフテスト・ツールは実行中に独自のデプロイを発行するためです。
ルール、プレイブック、デバイス、デバイスグループ、またはセルフテストツールで作成されたその他の要素を、実際のネットワークデバイスで使用しないでください。
セルフテストツールの使用方法
左側のナビゲーション パネルから [ 管理] ページ> [デバッグ ] ページに移動し、[ アプリケーション] タブを選択します。
ドロップダウンメニューから目的のセンサータイプを選択します。
[ テスト ] ボタンをクリックします。
しばらくすると、テスト結果が表示されます。
上記の例は、両方のセンサーが期待どおりに機能していることを示しています。
デバイス到達可能性テスト
概要
Paragon Insightの初期バージョンでは、追加したデバイスが稼働していて到達可能かどうかを簡単に判断する方法はありませんでした。デバイスの追加、デバイス グループのセットアップ、プレイブックの適用、デバイスの監視など、セットアップ手順全体を実行する必要がありますが、その時点で、正常性ページに "データなし" と表示され、セットアップが正しく機能しなかったことを示します。さらに、「データなし」は、問題が到達可能性の問題なのか、データ ストリーミングの問題なのかを示すものではありません。
HealthBotリリース2.1.0以降、デバイス到達可能性ツールでデバイスへの接続を確認できるようになりました。このツールは、ping と SSH を使用してテストを実行します。Paragon Insightは、デバイス追加時に設定された内容に基づいて、デバイスのIPアドレスまたはホスト名を使用します。
使用上の注意
この機能は通常、デバイスのオンボードのトラブルシューティングに役立つことを目的としていますが、デバイスの到達可能性を確認するためにいつでも使用できます。
テスト結果の色分けは次のとおりです。
緑 = 合格
黄色 = エラー (テストできません)
赤 = 失敗
黄色または赤のステータスのアイテムには、問題の詳細が記載されたメッセージが含まれます。
デバイス到達可能性ツールの使用方法
ツールにアクセスするには:
左側のナビゲーション パネルから [ 管理] ページ> [デバッグ ] ページに移動し、[ 到達可能性 ] タブを選択します。
または、[ダッシュボード] ページで、デバイス リスト ウィジェットで目的のデバイスをクリックし、ポップアップ ウィンドウで [到達可能性テスト ] ボタンをクリックします。
メモ:[到達可能性テスト] ボタンは、デバイスを最初に追加するときには表示されません。
デバイス到達可能性ツールで、ドロップダウンメニューから目的のデバイスを選択します。
[ テスト ] ボタンをクリックします。
しばらくすると、テスト結果が表示されます。
上記の例は、pingテストは成功したが、SSHテストは失敗したことを示しています。
取り込み接続テスト
概要
Paragon Insightsの初期バージョンでは、特定のデバイスでサポートされているインジェスト方法を簡単に判断する方法はありませんでした。また、設定されたINGESTメソッドがネットワークデバイスとの接続を正常に確立したかどうかを知る方法もありませんでした。
HealthBotリリース2.1.0以降、Ingest Connectivityツールは、Paragon Insightsが接続を開始するOpenConfig、iAgent、SNMPなどのインジェスト方法を検証できるようになりました。UDPパラメータはデバイスグループに共通であり、デバイスに固有ではないため、Paragon Insightでは、syslogやネイティブGPBなどのUDPベースのインジェスト方法はテストされません。
Paragon Insightsは、サポートされている各インジェスト方法を独自の方法で検証します。
OpenConfig: IP/ホスト名、gRPC ポート、および資格情報を使用して、デバイスとの gRPC 接続を確立します
iAgent:IP/ホスト名、NETCONFポート、認証情報を使用して、デバイスとのNETCONFセッションを確立します。
SNMP: 単純な SNMP GET コマンドを実行します。デバイスからの応答を受信することを想定しています
このツールには、次のような複数の利点があります。
これは、ネットワーク デバイス側で構成が不足している可能性がある場合を特定するのに役立ちます。
これは、サポートされている取り込み方法と互換性のあるセンサーを使用する適切なプレイブックとルールを選択するのに役立ちます。
これは、前のセクションで説明した「データなし」の問題をトラブルシューティングするのではなく、取り込み接続の問題を早期に特定するのに役立ちます。
使用上の注意
この機能は通常、デバイスのオンボードのトラブルシューティングに役立つことを目的としていますが、いつでも使用して取り込み接続を確認できます。
テスト結果の色分けは次のとおりです。
緑 = 合格
黄色 = エラー (テストできません)
赤 = 失敗
黄色または赤のステータスのアイテムには、問題の詳細が記載されたメッセージが含まれます。
インジェスト接続ツールの使用方法
ツールにアクセスするには:
左側のナビゲーション・パネルから「 管理」ページ>「デバッグ 」ページに移動し、「 INGEST 」タブをクリックします。
または、[ダッシュボード]ページでデバイスリストウィジェットで目的のデバイスをクリックし、ポップアップウィンドウで[ INGEST TEST ]ボタンをクリックします。
メモ:[ インジェスト テスト ] ボタンは、デバイスを最初に追加するときには表示されません。
接続の取り込みツールで、ドロップダウンメニューから目的のデバイスを選択します
[ テスト ] ボタンをクリックします。
しばらくすると、テスト結果が表示されます。
上記の例では、iAgent がサポートされ、OpenConfig がサポートされておらず、SNMP でエラーが発生したことを示しています。
デバッグなしデータ
概要
Paragon Insightsのユーザーが直面する最も一般的な問題の1つは、「データなしをデバッグする方法」です。根本原因の特定は、次のようなさまざまな理由で問題が発生する可能性があるため、困難です。
デバイスに到達できません
デバイスがデータを送信しない
ファイアウォールが接続をブロックしている
取り込み接続設定の不一致
ルールの頻度/トリガー間隔がルーターの応答時間より短く設定されている
Paragon Insightsサービスが実行されない
Paragon Insightsの初期バージョンでは、問題を手動で探し、デバイス追加パラメータを確認し、ログを確認し、デバイス設定を確認する必要がありました。
HealthBotリリース2.1.0以降、デバッグデータなしツールは、デバイスまたはルールのステータスが「データなし」である理由を判断するのに役立ちます。このツールは、次のように、受信データがドロップまたはブロックされる段階を決定するために、順次の段階的なアプローチを取ります。
Paragon Insightsサービス
すべての共通サービスおよびデバイス グループ関連のサービスが稼働していることを確認します
デバイス到達可能性
pingとSSHを使用したデバイスへの接続テスト
接続の取り込み
設定されたインジェストセッションが確立されていることを確認します
生データのストリーミング
インジェストがデバイスから生データを受信しているかどうかを確認します
デバイス接続に問題がなければ問題ない可能性が高い
フィールド処理
ルール内で、フィールドが正しく動作していること、およびフィールド情報がデータベースに入力されていることを確認します
トリガー処理
ルール内で、トリガー設定が意図したとおりに機能し、ステータス情報がデータベースに入力されていることを確認します
API検証
GUIに影響を与えている可能性のあるAPIタイムアウトを確認する
使用上の注意
このツールは、途中の問題に関係なく、一連のチェック全体を実行します。
テスト結果は、根本原因情報を提供し、トラブルシューティング作業の重点を置く場所を示します。
この機能は通常、データが no-data としてマークされている場合にデバイスをデバッグすることを目的としていますが、展開されたルールがデータを受信していることを検証するためにいつでも使用できます。
センサー データはイベント ドリブンであり、定期的ではないため、このツールは syslog センサーを使用するルールをサポートしていません。
テスト結果の色分けは次のとおりです。
緑 = 合格
黄色 = エラー (テストできません)
赤 = 失敗
黄色または赤のステータスのアイテムには、問題の詳細が記載されたメッセージが含まれます。
データなしデバッグツールの使用方法
ツールにアクセスするには:
任意のデバイスの正常性ページで、[データなし] タイルをクリックします。
または、左側のナビゲーション パネルから [ 管理] ページ> [デバッグ ] ページに移動し、[データなし] タブを選択します。
[データなしデバッグ(Debug No-Data)] ツールで、ドロップダウン メニューから目的のデバイス グループ、デバイス、および 1 つ以上のルールを選択します
[ デバッグ] ボタンをクリックします。
しばらくすると、テスト結果が表示されます。
上記の例は、1つの一般的なサービスが正しく機能していないことを示しています。