Groovyスクリプトのデバッグ

最終更新日 - 21年2026月XNUMX日

LogicMonitorアカウントに組み込まれたGroovyスクリプトは、コレクターと同じJVM内で実行されます。

LogicMonitor CollectorでGroovyスクリプトを実行するためのガイドラインは以下のとおりです。

• Groovyスクリプトは軽量でなければならない。
• データソースに組み込まれた場合、Groovyスクリプトは1分以内に実行されなければなりません。
• Groovyスクリプトは、コレクターJVMのメモリリソース内に収まる必要があります。
• エラーのあるGroovyスクリプトは、コレクターの安定性に悪影響を与える可能性があります。

Groovyスクリプトをデバッグするには、以下のいずれかの方法を使用できます。

• Groovyスクリプトをデバッグするには コレクターデバッグ ウィンドウを使用して入力ファイルを追加します。
• データソースを使用したGroovyスクリプトのデバッグ
• Groovyスクリプトをデバッグするには テストスクリプト

Groovyスクリプトのデバッグに必要な要件

テストスクリプトを使用して Groovy スクリプトをデバッグするには、 テストスクリプトを有効にする セキュリティページでスイッチをオンにします。詳細については、以下を参照してください。 セキュリティの設定.

コレクターデバッグウィンドウを使用したGroovyスクリプトのデバッグ

LogicMonitor DataSource 内の Groovy スクリプトは、コレクターマシン上で直接実行され、その環境で提供されている Java および Groovy のバージョンを使用します。同じ環境で実行するには、組み込みの !groovy コマンド コレクターデバッグ ウィンドウ。詳細については、以下を参照してください。 コレクターデバッグ機能.

1. LogicMonitorで、次の場所に移動します 設定 > コレクター.
2. デバッグするコレクターについては、以下を選択してください。 その他 次に選択します デバッグコマンドを実行する.
   
   開く操作を確認するダイアログボックス コレクターデバッグ ウィンドウ表示。
3. 選択する 確認します。 ザ・ コレクターデバッグ ウィンドウが新しいタブで開きます。
4. タイプ !groovy に選出しました。 コレクターデバッグ 窓。
   その 入力Groovyスクリプト モーダルディスプレイ。
5. コードを編集して選択する 送信.
   
   コレクターはスクリプトを実行し、結果を コレクターデバッグ 窓。
   

6. それを閉めて コレクターデバッグ 窓。

スクリプトのデバッグが成功したら、以下の2つの方法のいずれかに従ってソースコードをコピーしてください。

• ソースコードをコピーして 入力Groovyスクリプト ダイアログボックス。
• ソースコードを含む自動生成ファイルをコピーします。 agentRoot/tmp/test.groovy. 

データソースを使用したGroovyスクリプトのデバッグ

1. LogicMonitorで、次の場所に移動します モジュール.
2. ソフトウェア設定ページで、下図のように マイ モジュール ツールボックス ページを選択 追加.
3.  追加 モーダル、選択 データソース.
   
4. 希望する名前、グループ、ポーリング間隔で新しいデータソースを作成し、以下の情報を指定します。
   1. サンドボックスコレクターによって監視されているデバイスを選択してください。
   2. 「SCRIPT」を選択してください 収集方法 ドロップダウンメニュー。
      
5. データソースをデバイスのホスト名と一致するように構成します。 に適用されます 関数ウィザード。
   例えば、 System.hostname == "127.0.0.1" 関数は、サンドボックスコレクターによって監視されているデバイスと一致します。サンドボックスコレクターによって監視されているデバイスがない場合は、デバイスを追加してください。詳細については、以下を参照してください。 リソースの追加.
6. 「埋め込みGroovyスクリプト」を選択してください。 スクリプトタイプ ドロップダウンメニュー。
7. にコードを入力してください 組み込み Groovyスクリプト フィールド。
   例えば、「3」を出力する最小限のスクリプト。
   
8. まず データポイント タブを開き、以下の操作を行います。
   1. 選択する 正規データポイントを追加する.
   2.  名前 フィールドには、データポイントの名前を入力します。例: 経過時間.
   3. 「スクリプトの実行時間（ミリ秒）」を選択してください。 データポイントソース ドロップダウンメニュー。
      データポイントソースは、スクリプトの実行状況に関する有益なフィードバックを提供します。
      
       Groovy スクリプトに終了コードがある場合は、その戻り値を監視する別のデータポイントを追加します。スクリプトが値を出力する場合は、標準出力の内容を監視できます。この例では、スクリプトが値を出力するので、という名前のデータポイントを追加します。 スリー 出力を取得するために追加されます。
9. 選択する Save.

データソースの検証

データソースを作成し、サンドボックスコレクターによって監視されているデバイスに関連付けた後、実行状況を確認できます。 

1. LogicMonitorで、 リソースツリー.
2. データソースが適用されているリソースを特定します。
3.  Rawデータ タブで、有効な数字を確認します 経過時間 の三脚と スリー 列。
   
   コレクター イベントを確認して、最近のメッセージがログに記録されていないことを確認してください。 イベントログ.
   

テストスクリプトを使用したGroovyスクリプトのデバッグ

Groovy スクリプトは、 テストスクリプト データソースで使用できる機能。この方法では、個々のスクリプト コンポーネント (Active Discovery または Collection) をテストできます。 コレクターデバッグコマンド 窓。

1. LogicMonitorで、次の場所に移動します モジュール.
2. ソフトウェア設定ページで、下図のように マイ モジュール ツールボックス ページを選択 追加.
3. 追加モーダルで、 データソース.
4. まず に適用されます タブ、[選択 テスト適用先 スクリプトが適用されているデバイスをテストする。
   
5. まず 収集 タブをクリックして、次の操作を行います。
   1. 「埋め込みGroovyスクリプト」を選択してください。 スクリプトタイプ ドロップダウンメニュー。
   2. Groovyスクリプトを入力してください。
   3. 選択する テストスクリプト.
      その テスト収集スクリプト モーダルディスプレイ。
   4.  検索リソース フィールドを開き、リソースを検索して選択します。
   5. 選択する テストを実行.
      スクリプトの結果は stdOutput.