LogicMonitorにおける外部スクリプト
最終更新日 - 01年2026月XNUMX日
LogicMonitorは、GroovyやPowerShellによる組み込みスクリプトに加え、あらゆるスクリプト言語を使用した外部スクリプトもサポートしています。外部スクリプトを使用すれば、コレクター上で任意のプログラムを直接実行し、その出力結果からデータを収集することも可能です。
推奨事項：
- スクリプト作成が必要なほとんどのタスクにはGroovyを使用してください。詳細については、以下を参照してください。 埋め込まれたGroovyスクリプト.
- 外部スクリプトを使用する際は、必ずバージョンと拡張子の依存関係を考慮してください。
外部スクリプトの設定要件
外部スクリプトを設定するには、以下のものが必要です。
- アクセス権を持つユーザーロール モジュール。
詳細については、を参照してください。 LogicMonitor ロール - スクリプトが適用される、新規または既存のリソース。
- ご希望の言語で記述されたスクリプトファイル。
例えば、次のPerlスクリプトは、tomcat_log_size.plTomcatのルートディレクトリを含む単一の引数を受け取るように記述されています。
#!/usr/bin/perl
use warnings;
use strict;
# ingest the single argument into a single variable
my ($tomcatRoot) = @ARGV;
# run the "stat" function on the filename and collect the output as an array
my @result = stat("$tomcatRoot/logs/catalina.out");
# exit with a non-zero code if we didn't get a valid result from stat
if (!@result) {
exit 1;
}
# the 7th element in the array is size in bytes; print this out
print $result[7];
# exit to indicate we got a valid result
exit 0;スクリプトをテストするには、コマンドラインで以下を実行してください。$ ./tomcat_log_size.pl /usr/local/tomcat 3710925
注意： 保存されている値 tomcat.root プロパティは、そのシステムにTomcatがインストールされているディレクトリです。このスクリプトはリモート接続に対応していないため、コレクターと同じホストで実行されているTomcatインストールのみを監視できます。必要に応じて、スクリプトを修正してリモート監視を有効にできます。
データソースの外部スクリプトの設定
- LogicMonitorで、次の場所に移動します モジュール.
- 既存のデータソースを選択するか、新しいデータソースを作成します。詳細については、以下を参照してください。 データソースの作成.
例えば、次のようなリソースプロパティを作成します。tomcat.rootTomcatログファイルを監視したい各リソースに対して設定を行います。
詳細については、を参照してください。 リソースとインスタンスのプロパティ. - 製品概要 セクションで、「SCRIPT」を選択します。 収集方法 ドロップダウンメニュー。
- 収集 セクションで、「スクリプト ファイルのアップロード」を選択します。 スクリプトタイプ ドロップダウンメニュー。
- 選択 スクリプトのアップロード そして、カスタムスクリプトファイルをアップロードしてください。
外部スクリプトは、LogicMonitor Collector 内の agent、local、または bin サブディレクトリにインストールされます。複数のスクリプトがある場合（たとえば、Linux 用と Windows 用）、両方を順番にアップロードしてください。
推奨事項： LogicMonitorは、以下の理由から、データソース定義を使用した自動デプロイを強く推奨します。
- スクリプトとデータソース定義の一貫性—コレクター上で外部スクリプトが誤って変更された場合、上流で管理されているバージョンと強制的に再同期されます。
- スクリプトの更新が簡単外部スクリプトの更新が必要な場合、データソース定義の新しいバージョンが必要に応じてコレクターに自動的に配布されます。
- 関係するすべての収集業者への自動配信LogicMonitorは、必要なすべてのコレクターにスクリプトを配布します。たとえば、コレクターがダウンし、リソースがバックアップコレクターにフェイルオーバーした場合でも、データ収集は中断されることなく継続されます。
- Windowsスクリプト名/パス および Linux/Unixスクリプト名/パス フィールドには、アップロードしたスクリプトの名前を指定します。
例えば、サンプルtomcat_log_size.plスクリプトは以下の詳細情報を使用します。- Linux/Unixスクリプト名/パス フィールドにファイル名として「tomcat_log_size.pl」と入力します。
注意： スクリプトをターゲットのコレクターに配信するには、これらのフィールドにあるスクリプト名が、[スクリプトのアップロード]ボタンを使用してアップロードしたスクリプト名と一致している必要があります。ただし、スクリプトパスは名前付き/アップロードされたスクリプトを参照するものではなく、任意のローカルコレクターパスを参照できます。スクリプトパスは、各コレクターに手動でコピーする必要があります。
- Windowsの引数 および Linux/Unixの引数 フィールドには、スクリプトに渡す引数を入力します。
複数の引数を渡す場合は、各引数を個別に指定し、空白で区切ってください。引数文字列を二重引用符で囲まないでください。
例えば、サンプルtomcat_log_size.plスクリプトは ##tomcat.root## を使用します Linux/Unixの引数 フィールド。
注意：Windowsスクリプトに引数を渡す場合、LogicMonitorでは、Windowsスクリプトフィールドにスクリプトインタープリタを指定し、スクリプトパラメータフィールドに引数とともに完全なパスを指定することを推奨しています。
例えば、Pythonスクリプトでは、次のように入力します。 c:\python27\python.exe スクリプト名として c:\program files (x86)\logicmonitor\agent\lib\monitor_script.py ##system.hostname## スクリプトのパラメータとして。
この場合、スクリプトファイル名と関連する引数を二重引用符で囲む必要があります。
- (オプション） 選択する テストスクリプト スクリプトと適用された引数が正しく機能することを確認する。
- (オプション監視対象リソースから値を取得するために、通常データポイントと複雑なデータポイントを追加または編集します。詳細については、以下を参照してください。 通常のデータポイント (NAIST) と 複雑なデータポイント.
例えば、サンプルスクリプト tomcat_log_size.pl の通常のデータポイントを作成するには、次の手順を実行します。- In 通常のデータポイント選択 通常のデータポイントを追加します。
- 出力を次のように解釈します ドロップダウンメニューから「解釈なし、直接使用」を選択してください。スクリプトは単一の値のみを返します。
注意： スクリプトの出力に複数の値が含まれている場合、それらはキーと値のペアとして、または正規表現を使用して抽出できます。
- 選択 静的しきい値を追加します。 データポイントが1GBを超えた場合にアラートを発するように、以下のフィールドを設定してください。
- In 時間範囲毎日監視する時間帯を設定してください。
- フィールド、選択 値.
- 「（＞）より大きい」を選択します。 Is アラートの深刻度を選択し、対応するフィールドに「1」と入力します。
- 選択 適用されます。
- 選択 保存します。
データソースは モジュール リスト。
ConfigSource の外部スクリプトの設定
- LogicMonitorで、次の場所に移動します モジュール.
- 既存のConfigSourceを選択するか、新しいConfigSourceを作成してください。
詳細については、を参照してください。 ConfigSourceの作成. - 製品概要 セクションで、「SCRIPT」を選択します。 収集方法 ドロップダウンメニュー。
- 収集 セクションで、「スクリプト ファイルのアップロード」を選択します。 スクリプトタイプ ドロップダウンメニュー。
- 選択 スクリプトのアップロード そして、カスタムスクリプトファイルをアップロードしてください。
外部スクリプトは、LogicMonitor Collector 内の agent/local/bin/ サブディレクトリにインストールされます。複数のスクリプト（例えば、Linux 用と Windows 用）がある場合は、それぞれを順番にアップロードしてください。
推奨事項： LogicMonitorは、以下の理由から、データソース定義を使用した自動デプロイを強く推奨します。
- スクリプトとConfigSource定義の一貫性—コレクター上で外部スクリプトが誤って変更された場合、上流で管理されているバージョンと強制的に再同期されます。
- スクリプトの更新が簡単外部スクリプトの更新が必要な場合、データソース定義の新しいバージョンが必要に応じてコレクターに自動的に配布されます。
- 関連するすべてのコレクターへの自動配信—LogicMonitorは、必要なすべてのコレクターにスクリプトを配信します。たとえば、コレクターがダウンし、リソースがバックアップコレクターにフェイルオーバーした場合でも、データ収集は中断されることなく継続されます。
- Windowsスクリプト名/パス および Linux/Unixスクリプト名/パス フィールドには、アップロードしたスクリプトの名前を指定します。
注意： スクリプトをターゲットのコレクターに配信するには、これらのフィールドにあるスクリプト名が、[スクリプトのアップロード]ボタンを使用してアップロードしたスクリプト名と一致している必要があります。ただし、スクリプトパスは名前付き/アップロードされたスクリプトを参照するものではなく、任意のローカルコレクターパスを参照できます。スクリプトパスは、各コレクターに手動でコピーする必要があります。
- Windowsの引数 および Linux/Unixの引数 フィールドには、スクリプトに渡す引数を入力します。
複数の引数を渡す場合は、各引数を個別に指定し、空白で区切ってください。引数文字列を二重引用符で囲まないでください。
推奨事項： Windowsスクリプトに引数を渡す場合、LogicMonitorでは、Windowsスクリプトフィールドにスクリプトインタープリタを指定し、スクリプトパラメータフィールドに引数とともに完全なパスを指定することを推奨しています。
例えば、Pythonスクリプトでは、次のように入力します。 c:\python27\python.exe スクリプト名として c:\program files (x86)\logicmonitor\agent\lib\monitor_script.py ##system.hostname## スクリプトのパラメータとして。
この場合、スクリプトファイル名と関連する引数を二重引用符で囲む必要があります。
- (オプション） 選択する テストスクリプト スクリプトと適用された引数が正しく機能することを確認する。
- (オプション必要に応じて設定チェックを追加または編集します。詳細については、以下を参照してください。 構成チェック.
- 選択 保存します。
ConfigSource は、 モジュール リスト。
