コレクターデバッグ機能
最終更新日: 10 年 2025 月 XNUMX 日Collector Debug Facility は、Collector 上でデバッグ コマンドをリモートで実行するために使用できるコマンド ライン インターフェイス (CLI) です。これは、データ収集に関する問題のトラブルシューティングに役立ちます。たとえば、スクリプト DataSource を作成して NaN 値を取得している場合、または 10 個のうち 1 個のインスタンスがデータを報告していない場合は、コレクタ デバッグ機能を実行して問題を特定できます。
ご注意: Collector デバッグ コマンドの履歴は監査ログに保存されます。詳細については、「」を参照してください。 監査ログ レポート.
デバッグするコレクタからコレクタ デバッグ機能を実行することも、リソース内の DataSource インスタンスに移動することもできます。コレクタ デバッグ機能を実行すると、新しいタブで開き、環境に適したデバッグ コマンドを実行できます。デバッグ コマンドのリストとその説明がコレクタ デバッグ機能インターフェイスに表示され、必要なコマンドを入力する前のトラブルシューティングに役立ちます。

コレクタ デバッグ機能のデバッグ コマンド
次の表に、トラブルシューティングのためにコレクタ デバッグ機能で実行できるデバッグ コマンドを示します。
Command | 説明 | 例 |
!account | で使用されているアカウント情報を表示します。 sbwinproxy . | !account |
!adlist | コレクターのアクティブディスカバリータスクのリストを表示します。 タスクIDがタスクごとに返されます。 | !adlist type=get !adlist method=ad_snmp |
!adetail <taskId> | 特定のアクティブディスカバリータスクに関する詳細情報を表示します。ここで、taskIdは !adlist . ご注意: コマンド仕様内の「taskId」参照は、コマンドの出力では「id」というラベルが付けられます。 | !adetail 142 |
!checkcredential | 指定されたホストでの資格情報の使用を有効、無効、およびチェックして、予期しないログインアクションのソースを特定します。 | !checkcrendential proto=snmp user=public !checkcrendential proto=snmp user=public usage=AP |
!hostproperty | ホストのシステムプロパティを追加、更新、または削除します。 | hostproperty action=del host=localhost property=virtualization !hostproperty action=add host=localhost property=ips value=127.0.0.1,192.168.1.1 |
!http | HTTP リクエストを送信し、応答を表示します。 URLは必須です。!http [username=xxx [password=yyy]] [followRedirect=true|false] [method=GET| POST| PUT] [version=1| 1.1] [timeout=<seconds>] url [-h "<header json>"] [-b "<body json>"] 応答を表示するためのオプションの引数は次のとおりです。
| !http http://www.google.com/index.html !http method=GET http://www.google.com/index.html !http method=POST http://www.google.com/index.html -h "{"Content-type": "application/json"}" -b "{"key" : "value"}" !http method=PUT http://www.google.com/index.html -h "{"Content-type": "application/json"}" -b "{"key" : "value"}" |
!jdbc | 指定されたホストに対してSQLクエリを実行します。 | !jdbc ‘url=jdbc:mysql://productrds.chqwqvn285rf.us-west-2.rds.amazonaws.com:3306 username=LogicMonitor password=MyPassword’ select Name, ID from productDB.Employees |
!logsurf | 指定されたデバッグレベルのログファイルエントリを表示します。 含まれている場合、ログは指定されたファイルにある場合にのみ指定されたseqおよびtaskIdに対して表示され、n個のログのみが表示されます。 taskIdとseqは、 !tlist 、ここで、taskIdはデータ収集タスクのIDであり、seqはコレクターがタスクを実行したことを記憶している回数です。 | !logsurf level=trace ../logs/wrapper.log taskid=833 seq=75 |
!packetcapture2 | このコマンドを実行しているデバイスのネットワーク トレースをキャプチャします。 引数を渡さない場合は !packetcapture2 コマンドを実行すると、システムは次のコンポーネントを表示します。
| !packetcapture2 interface=eth0 file=test.pcap timeout=1 "tcp and host 10.10.10.10 and port 443" |
!ping | 指定されたホストにpingを実行します。 | !ping 10.36.11.240 !ping type=proxy 10.36.11.240 |
!restart | 指定されたコレクターサービスを再起動します | !restart watchdog !restart collector |
!shealthcheck func=<function> collector=<collector_id> | !shealthcheck コマンドは、Collector の状態、消費されたメモリ、スケジュールされたタスクの数を確認するのに役立ちます。結果に基づいて、問題をデバッグして解決できます。func = trigger このデバッグ コマンドは、特定のコレクタのヘルスチェック タスクをトリガーします。このコマンドを実行すると、Santaba は指定されたコレクタのヘルスチェック タスクをスケジュールします。 結果を表示するには、次を実行する必要があります !shealthcheck 関数付きコマンド func=detail or func=show .func = show 通常、結果にはスケジュールされたタスクの概要が表示されます。 また、ヘルスチェックタスクの合計、終了、およびスキップされた数も示します。 たとえば、「最新の実行が終了しました。 スケジュールされたチェック(合計= 34、終了= 27、スキップ= 7)」 問題が検出された場合、その問題は結果に要約されます。 たとえば、「ディスクの空き領域は728.57Mバイトです。」 あなたは走れる !shealthcheck func=detail collector=<collector_id> debug コマンドを使用して、問題の詳細を確認したり、コレクタの正常性ステータスの詳細を取得したりできます。func = detail このデバッグコマンドは、すべてのスクリプトのステータスを詳細に提供します。 たとえば、「コレクターがエクスポートしたjarファイルと実行可能ファイルは変更されません。」 「コレクターには177のインスタンスがあります。」 このコマンドを実行すると、Collector は、 func=trigger 指示。たとえば、特定のコレクタに対して、午前 9.00 時に func=trigger コマンドを実行し、その後次のコマンドを実行するとします。 func=detail 午前 11.00 時に、午前 9.00 時に取得されたコレクタの健全性ステータスが表示されます。 | !shealthcheck func=show collector=123 !shealthcheck func=trigger collector=123 !shealthcheck func=detail collector=123 |
!tdetail <taskId> | 特定のデータ収集タスクに関する詳細情報を表示します。ここで、taskIdは次の場所にあります。 !tlist . | !tdetail 12323209239991 |
!tlist | DataSource、ConfigSources、EventSourcesなどのコレクターのデータ収集タスクを一覧表示します。 タスクIDがタスクごとに返されます。 を使用してリストを絞り込むことができます h=<hostname> と c=<collection type> オプション。 | !tlist c=wmi 返されたリストを絞り込みます。 !tlist c=script |
!uptime | コレクターの稼働時間を表示します。 | !uptime |
さらに、特定のコマンドの構文や使用法の詳細 (オプションおよび必須の引数やパラメーターなど) と例が必要な場合は、次のように入力できます。 commandname
該当するコマンドを使用して:
help !<commandname>
コレクタ デバッグ機能を実行するための要件
コレクタ デバッグ機能を使用してコマンドを実行する場合、コマンドの前に次の構文を付ける必要があります。
!
コレクターデバッグ機能の実行
- コレクター デバッグ機能を実行する場所に応じて、次のいずれかを実行します。
- コレクターの設定からコレクター デバッグ機能を実行するには、次の手順を実行します。
- MFAデバイスに移動する 設定 > コレクター.
- 選択 管理 コレクターのリストからデバッグするコレクターを選択します。
コレクターの設定がパネルに表示されます。 - 選択 その他
設定パネルで「デバッグコマンドの実行」を選択します。
- 選択 確認します プロンプトが表示されたら
コレクター デバッグ機能が新しいタブで開きます。
- リソースのデータソースからコレクタ デバッグ機能を実行するには、次の手順を実行します。
- MFAデバイスに移動する その他 > リソースツリーをクリックし、デバッグする DataSource または Datasource インスタンスを選択します。
- ソフトウェア設定ページで、下図のように Rawデータ タブ、選択 デバッグ ウィンドウを開く
.
コレクター デバッグ機能が新しいタブで開きます。
- コレクターの設定からコレクター デバッグ機能を実行するには、次の手順を実行します。
- コレクター デバッグ機能に該当するコマンドを入力します。
たとえば、!tlist
コマンドを使用して、DataSources、ConfigSources、EventSources などの Collector のデータ収集タスクを一覧表示します。
詳細については、を参照してください。 コレクタ デバッグ機能のデバッグ コマンド.
推奨事項:
- 問題を診断するためにさらに情報が必要な場合は、コレクタの適切な収集方法のログ レベルを上げます。詳細については、「」を参照してください。 コレクターロギング.
- ポーリング サイクル以上待つと、より多くの情報が返されることがあります。