LogicMonitor は、2024 Gartner Voice of the Customer の Observability プラットフォーム部門で、Gartner Peer Insights™ の Customers' Choice に選出されました。

続きを読む

コレクターデバッグ機能

最終更新日: 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」というラベルが付けられます。 !adlist 

!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
!httpHTTP リクエストを送信し、応答を表示します。 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>"]

応答を表示するためのオプションの引数は次のとおりです。

  • ユーザー名=xxx [パスワード=yyy]
    Web エンドポイントで基本認証が必要な場合、パスワードを持っているユーザーを含める必要があります。ただし、ユーザーがいる場合は、パスワードは必要ありません。

  • followRedirect=true|false
    リダイレクトに従うかどうかを決定します

  • メソッド=GET|投稿|置く
    HTTPメソッドを決定しますバージョン=1| 1.1
    HTTP バージョンを決定します

  • タイムアウト=
    カスタムタイムアウトを設定できます

  • -h “ 」
    カスタムヘッダーを追加できます

  • -b “ 」
    カスタム本文を送信します (通常は POST で使用されます)
!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 コマンドを実行すると、システムは次のコンポーネントを表示します。
  • インタフェース—ネットワーク トラフィックをキャプチャできるシステム上のネットワーク インターフェイス。一般的な例は次のとおりです。
    • Linux —eth0 (イーサネット)、 wlan0 (Wi-Fi)、および lo (ループバック)
    • Windows - インターフェースは、多くの場合、GUIDを使用して命名されます。 \Device\NPF_{GUID}
      !packetcapture2 どちらかを使用します npcap (Windowsの場合)または libpcap (Linux用)ライブラリ。デバイスには、 npcap or libcap マシンにインストールされているライブラリ。たとえば、Linuxマシンの場合、 eth0 は、以下で提供されているインターフェースの1つです。 libpcap ライブラリ。 (name=eth0,description=null).

    • File—すべてのネットワークトレースが保存されるファイル名。例: test.pcap.
    • タイムアウト— 指定された時間、すべてのネットワーク トレースがキャプチャされます。タイムアウトは分単位で指定します。指定されたタイムアウトが 50 分などに延長されると、要求はタイムアウトになりますが、パケット キャプチャはバックグラウンドで実行され続け、ファイルに保存されます。
    • フィルタ— フィルターは、指定されたホストとポートへのすべてのネットワーク呼び出しをキャプチャします。基本的なフィルターには次のようなものがあります。
    • "tcp"—すべてのTCPパケットをキャプチャします
    • "udp"—すべてのUDPパケットをキャプチャします
    • "icmp"—すべてのICMPパケットをキャプチャします
    • "ip"—すべてのIPパケットをキャプチャします
    • "arp"—すべてのARPパケットをキャプチャします
    フィルターを組み合わせて新しいフィルターを作成することもできます。たとえば、 
    • "tcp and port <port number>"—特定のポートの TCP パケットをキャプチャします。
    • "udp and port <port number>"—特定のポートの UDP パケットをキャプチャします。

    .pcap ファイルのダウンロード
    システムが指定されたフィルターに従ってネットワーク トレースをキャプチャすると、ファイル ディレクトリに移動して結果を表示できます。たとえば、/usr/local/logicmonitor/agent/logs/test.pcap などです。
    あなたもダウンロードすることができます .pcap すべてのネットワーク トレースが保存されているファイルを作成します。これを行うには、次の手順に従います。
    1. コマンドを入力してください !uploadlog ファイル名が続きます。例えば、 !uploadlog test.pcap.
    2. コマンドを実行します。ZIP ファイルがダウンロードされます。
!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
!tlistDataSource、ConfigSources、EventSourcesなどのコレクターのデータ収集タスクを一覧表示します。 タスクIDがタスクごとに返されます。

を使用してリストを絞り込むことができます h=<hostname> と c=<collection type> オプション。 
!tlist c=wmi
!tlist summary=collector
!tlist summary=true lasttime=10 columns=5


返されたリストを絞り込みます。
!tlist c=script
!uptimeコレクターの稼働時間を表示します。!uptime

さらに、特定のコマンドの構文や使用法の詳細 (オプションおよび必須の引数やパラメーターなど) と例が必要な場合は、次のように入力できます。 commandname 該当するコマンドを使用して:

help !<commandname>

コレクタ デバッグ機能を実行するための要件

コレクタ デバッグ機能を使用してコマンドを実行する場合、コマンドの前に次の構文を付ける必要があります。

!

コレクターデバッグ機能の実行

  1. コレクター デバッグ機能を実行する場所に応じて、次のいずれかを実行します。
    • コレクターの設定からコレクター デバッグ機能を実行するには、次の手順を実行します。
      1. MFAデバイスに移動する  設定 > コレクター.
      2. 選択 管理  コレクターのリストからデバッグするコレクターを選択します。
        コレクターの設定がパネルに表示されます。
        コレクターリスト
      3. 選択 その他 もっとアイコン 設定パネルで「デバッグコマンドの実行」を選択します。
      4. 選択 確認します プロンプトが表示されたら
        デバッグターミナル
        コレクター デバッグ機能が新しいタブで開きます。
    • リソースのデータソースからコレクタ デバッグ機能を実行するには、次の手順を実行します。
      1. MFAデバイスに移動する  その他 > リソースツリーをクリックし、デバッグする DataSource または Datasource インスタンスを選択します。
      2. ソフトウェア設定ページで、下図のように Rawデータ タブ、選択 デバッグ ウィンドウを開く .
        デバッグターミナルアイコンを開く
        コレクター デバッグ機能が新しいタブで開きます。
  2. コレクター デバッグ機能に該当するコマンドを入力します。
    たとえば、 !tlist コマンドを使用して、DataSources、ConfigSources、EventSources などの Collector のデータ収集タスクを一覧表示します。
    詳細については、を参照してください。 コレクタ デバッグ機能のデバッグ コマンド.

推奨事項:

  • 問題を診断するためにさらに情報が必要な場合は、コレクタの適切な収集方法のログ レベルを上げます。詳細については、「」を参照してください。 コレクターロギング.
  • ポーリング サイクル以上待つと、より多くの情報が返されることがあります。
  1. 終了したらウィンドウを閉じます。
記事上で