4 Zabbix エージェント 2 (UNIX)

概要

Zabbix agent 2 は新世代の Zabbix エージェントであり、 Zabbix エージェントの代わりに使用できます。

このセクションでは、Zabbix agent 2 の設定ファイル (zabbix_agent2.conf) でサポートされるパラメータを一覧表示します。

パラメータは追加情報なしで一覧表示されています。 詳細については、パラメータをクリックしてください。

Parameter Description
Alias アイテムキーのエイリアスを設定します。
AllowKey パターンに一致するアイテムキーの実行を許可します。
BufferSend データをバッファ内に N 秒を超えて保持しません。
BufferSize メモリバッファ内の値の最大数。
ControlSocket '-R' オプションで実行時コマンドを送信するために使用される制御ソケット。
DebugLevel デバッグレベル。
DenyKey パターンに一致するアイテムキーの実行を拒否します。
EnablePersistentBuffer アクティブアイテムに対するローカル永続ストレージの使用を有効にします。
ForceActiveChecksOnStart 再起動後、最初に受信した設定に対して直ちにアクティブチェックを実行します。
HeartbeatFrequency ハートビートメッセージの送信間隔（秒）。
HostInterface ホストインターフェースを定義するオプションのパラメータ。
HostInterfaceItem ホストインターフェースの取得に使用するアイテムを定義するオプションのパラメータ。
HostMetadata ホストメタデータを定義するオプションのパラメータ。
HostMetadataItem ホストメタデータの取得に使用する Zabbix エージェントアイテムを定義するオプションのパラメータ。
Hostname ホスト名を定義するオプションのパラメータ。
HostnameItem ホスト名の取得に使用する Zabbix エージェントアイテムを定義するオプションのパラメータ。
Include 設定ファイルには、個別のファイルまたはディレクトリ内のすべてのファイルを含めることができます。
ListenIP エージェントが待ち受ける、カンマ区切りの IP アドレスのリスト。
ListenPort エージェントはこのポートでサーバーからの接続を待ち受けます。
LogFile ログファイル名。
LogFileSize ログファイルの最大サイズ。
LogType ログ出力の種類。
PersistentBufferFile Zabbix agent 2 が SQLite データベースを保持するファイル。
PersistentBufferPeriod サーバーまたはプロキシへの接続がない場合にデータを保存する期間。
PidFile PID ファイル名。
Plugins.<PluginName>.System.Capacity 同時に実行できるプラグインごとのチェック数の上限。
Plugins.Log.MaxLinesPerSecond 'log' および 'logrt' のアクティブチェックを処理する際に、エージェントが 1 秒あたりに Zabbix サーバーまたはプロキシへ送信する新しい行の最大数。
Plugins.SystemRun.LogRemoteCommands 実行されたシェルコマンドの警告としてのログ記録を有効にします。
PluginSocket ロード可能プラグインとの通信用 UNIX ソケットへのパス。
PluginTimeout ロード可能プラグインとの接続のタイムアウト（秒）。
RefreshActiveChecks アクティブチェックの一覧を更新する頻度。
Server CIDR 表記を任意で含む、カンマ区切りの IP アドレス、または Zabbix サーバーおよび Zabbix プロキシの DNS 名のリスト。
ServerActive アクティブチェックの取得元となる Zabbix サーバー/プロキシのアドレス、またはクラスタ設定。
SourceIP 送信元 IP アドレス。
StatusPort 設定した場合、エージェントはこのポートで HTTP ステータス要求 (http://localhost:<port>/status) を待ち受けます。
Timeout Zabbix プロキシまたはサーバーとの接続確立およびデータ交換を待機する時間（秒）を指定します。
TLSAccept 受け入れる受信接続の種類。
TLSCAFile ピア証明書の検証用トップレベル CA 証明書を含むファイルのフルパス名。Zabbix コンポーネント間の暗号化通信に使用されます。
TLSCertFile エージェント証明書または証明書チェーンを含むファイルのフルパス名。Zabbix コンポーネント間の暗号化通信に使用されます。
TLSCipherAll OpenSSL の暗号文字列 (TLS 1.2)。証明書ベースおよび PSK ベース暗号化のデフォルト暗号スイート選択基準を上書きします。
TLSCipherAll13 OpenSSL 1.1.1 以降向けの OpenSSL 暗号文字列 (TLS 1.3)。証明書ベースおよび PSK ベース暗号化のデフォルト暗号スイート選択基準を上書きします。
TLSCipherCert OpenSSL の暗号文字列 (TLS 1.2)。証明書ベース暗号化のデフォルト暗号スイート選択基準を上書きします。
TLSCipherCert13 OpenSSL 1.1.1 以降向けの OpenSSL 暗号文字列 (TLS 1.3)。証明書ベース暗号化のデフォルト暗号スイート選択基準を上書きします。
TLSCipherPSK OpenSSL の暗号文字列 (TLS 1.2)。PSK ベース暗号化のデフォルト暗号スイート選択基準を上書きします。
TLSCipherPSK13 OpenSSL 1.1.1 以降向けの OpenSSL 暗号文字列 (TLS 1.3)。PSK ベース暗号化のデフォルト暗号スイート選択基準を上書きします。
TLSConnect エージェントが Zabbix サーバーまたはプロキシに接続する方法。
TLSCRLFile 失効した証明書を含むファイルのフルパス名。このパラメータは Zabbix コンポーネント間の暗号化通信に使用されます。
TLSKeyFile エージェント秘密鍵を含むファイルのフルパス名。Zabbix コンポーネント間の暗号化通信に使用されます。
TLSPSKFile エージェント事前共有鍵を含むファイルのフルパス名。Zabbix サーバーとの暗号化通信に使用されます。
TLSPSKIdentity 事前共有鍵の識別文字列。Zabbix サーバーとの暗号化通信に使用されます。
TLSServerCertIssuer 許可されるサーバー（プロキシ）証明書の発行者。
TLSServerCertSubject 許可されるサーバー（プロキシ）証明書のサブジェクト。
UnsafeUserParameters ユーザー定義パラメータの引数にすべての文字を渡すことを許可します。
UserParameter 監視するユーザー定義パラメータ。
UserParameterDir UserParameter コマンドのデフォルト検索パス。

すべてのパラメータは、明示的に必須と記載されていない限り、必須ではありません。

注意:

  • デフォルト値は、配布される設定ファイル内の値ではなく、プロセスのデフォルト値を反映しています。
  • 値では environment variables をサポートしています。
  • Zabbix がサポートする設定ファイルは、BOM なしの UTF-8 エンコーディングのみです。
  • "#" で始まるコメントは、行頭でのみサポートされます。

パラメータの詳細

エイリアス

アイテムキーのエイリアスを設定します。長くて複雑なアイテムキーを、より短くてシンプルなものに置き換えることができます。
Alias パラメーターは複数指定できます。同じ Alias キーを持つ複数のパラメーターは許可されません。
異なる Alias キーが同じアイテムキーを参照する場合があります。
エイリアスは HostMetadataItem では使用できますが、HostnameItem パラメーターでは使用できません。

例 1: ユーザー 'zabbix' の ID を取得します。

Alias=zabbix.userid:vfs.file.regexp[/etc/passwd,"^zabbix:.:([0-9]+)",,,,\1]

これで、zabbix.userid という短縮キーを使用してデータを取得できるようになりました。

例 2: デフォルトおよびカスタムパラメーターを使用した CPU 使用率の取得

Alias=cpu.util:system.cpu.util
Alias=cpu.util[*]:system.cpu.util[*]

これにより、cpu.util キーを使用してデフォルトのパラメータでCPU使用率を取得できるだけでなく、cpu.util[all, idle, avg15] を使用してCPU使用率に関する特定のデータを取得できます。

例3: 同じ検出項目を処理する複数の 低レベル検出 ルールを実行する。

Alias=vfs.fs.discovery[*]:vfs.fs.discovery

これで、vfs.fs.discovery を使用して、ルールごとに異なるパラメータを持つ複数の検出ルールを設定できるようになりました。（例: vfs.fs.discovery[foo]、vfs.fs.discovery[bar] など）

AllowKey

パターンに一致するアイテムキーの実行を許可します。キーパターンはワイルドカード表現で、"*"文字を含む任意の数の文字に一致します。
DenyKeyと組み合わせて、複数のキー一致ルールを定義できます。パラメータは出現順序に従って1つずつ処理されます。エージェントチェックの制限も参照してください。

BufferSend

バッファからZabbixサーバーへ値を送信する間隔（秒単位）です。バッファがいっぱいの場合は、データがより早く送信されます。

デフォルト: 5
範囲: 1-3600

BufferSize

メモリバッファ内の値の最大数。バッファがいっぱいになった場合、エージェントは収集したすべてのデータをZabbixサーバーまたはプロキシに送信します。このパラメータは、永続バッファが無効になっている場合（EnablePersistentBuffer=0）のみ使用してください。

デフォルト: 1000
範囲: 2-65535

ControlSocket

コントロールソケット、'-R' オプションを指定したランタイムコマンドの送信に使用します。

デフォルト: /tmp/agent.sock

DebugLevel

デバッグレベルを指定します。
0 - Zabbix プロセスの起動と停止に関する基本情報
1 - 重要な情報
2 - エラー情報
3 - 警告
4 - デバッグ用（多くの情報を生成します）
5 - 拡張デバッグ（さらに多くの情報を生成します）

デフォルト: 3
範囲: 0-5

DenyKey

パターンに一致するアイテムキーの実行を拒否します。キーパターンはワイルドカード表現で、"*"文字を含む任意の数の文字に一致します。
AllowKeyと組み合わせて、複数のキーマッチングルールを定義できます。パラメータは出現順序に従って1つずつ処理されます。エージェントチェックの制限も参照してください。

EnablePersistentBuffer

アクティブアイテム用のローカル永続ストレージの使用を有効にします。永続ストレージが無効になっている場合は、メモリバッファが使用されます。

デフォルト: 0
値: 0 - 無効、1 - 有効

ForceActiveChecksOnStart

再起動後、最初に受信した構成に対してアクティブチェックを直ちに実行します。プラグインごとの設定パラメータとしても利用可能です。例: Plugins.Uptime.System.ForceActiveChecksOnStart=1

デフォルト: 0
値: 0 - 無効、1 - 有効

HeartbeatFrequency

ハートビートメッセージの送信頻度（秒単位）。アクティブチェックの可用性を監視するために使用されます。
0 - ハートビートメッセージは無効です。

デフォルト: 60
範囲: 0-3600

HostInterface

ホストインターフェースを定義する追加パラメーターです。ホストインターフェースは、ホストの自動登録プロセスで使用されます。定義されていない場合は、HostInterfaceItemから値が取得されます。
値が255文字の制限を超える場合、エージェントはエラーを通知して起動しません。

範囲: 0-255文字

HostInterfaceItem

ホストインターフェースの取得に使用するアイテムを定義する追加パラメータです。
ホストインターフェースは、ホストの自動登録プロセスで使用されます。このオプションは、HostInterfaceが定義されていない場合にのみ使用されます。
system.run[]アイテムは、AllowKey/DenyKeyの値に関係なくサポートされます。
自動ディスカバリリクエスト中に、指定された項目によって返される値が255文字の制限を超えている場合、エージェントは警告メッセージをログに記録します。

HostMetadata

ホストメタデータを定義する追加パラメータです。ホストメタデータは、ホスト自動登録プロセスでのみ使用されます。定義されていない場合は、HostMetadataItem から値が取得されます。
指定された値が2034バイトの制限を超える場合、またはUTF-8以外の文字列の場合、エージェントはエラーを通知して起動しません。

範囲: 0-2034バイト

HostMetadataItem

ホストメタデータの取得に使用する項目を定義する追加パラメータです。このオプションは、HostMetadata が定義されていない場合にのみ使用されます。ユーザーパラメータとエイリアスがサポートされています。system.run[] 項目は、AllowKey/DenyKey の値に関係なくサポートされます。
HostMetadataItem の値は、自動登録の試行ごとに取得され、ホストの自動登録プロセスでのみ使用されます。
自動登録リクエスト中、指定されたアイテムによって返される値が UTF-8 コードポイントの上限である 65535 を超える場合、エージェントは警告メッセージをログに記録します。アイテムによって返される値は UTF-8 文字列である必要があります。そうでない場合は無視されます。

ホスト名

カンマ区切りの、大文字と小文字を区別する一意のホスト名のリストです。アクティブチェックに必須で、サーバーに設定されているホスト名と一致する必要があります。値が未定義の場合は、HostnameItem から取得されます。
使用可能な文字: 英数字、'.'、''、'_'、'-'。最大文字数: ホスト名ごとに128文字、行全体で2048文字。

デフォルト: HostnameItem によって設定

HostnameItem

ホスト名の取得に使用する項目を定義する追加パラメータです。このオプションは、Hostname が定義されていない場合にのみ使用されます。ユーザーパラメータやエイリアスはサポートされていませんが、system.run[] アイテムは、AllowKey/DenyKey の値に関わらずサポートされます。

デフォルト: system.hostname

Include

設定ファイルには、個々のファイルまたはディレクトリ内のすべてのファイルをincludeできます。Zabbixはインストール時に、コンパイル時に変更されない限り、/usr/local/etcにincludeディレクトリを作成します。パスは、zabbix_agent2.confファイルの場所からの相対パスで指定できます。
指定されたディレクトリ内の関連ファイルのみをincludeするには、パターンマッチングでアスタリスクワイルドカード文字を使用できます。
制限事項については特記事項を参照してください。

例:

Include=/absolute/path/to/config/files/*.conf

ListenIP

エージェントがListenするIPアドレスをカンマ区切りで指定します。最初のIPアドレスは、Zabbixサーバーに接続している場合、アクティブなチェックリストを取得するためにZabbixサーバーに送信されます。

デフォルト: 0.0.0.0

ListenPort

エージェントは、サーバーからの接続をこのポートで待ち受けします。

デフォルト: 10050
範囲: 1024-32767

LogFile

ログファイル名

デフォルト: /tmp/zabbix_agent2.log
必須: LogType が file に設定されている場合は必須、それ以外の場合は必須ではありません。

LogFileSize

ログファイルの最大サイズ（MB）
0 - 自動ログローテーションを無効にします。
注: ログファイルのサイズ制限に達し、何らかの理由でファイルローテーションが失敗した場合、既存のログファイルは切り捨てられ、新たに開始されます。

デフォルト: 1
範囲: 0-1024

LogType

ログ出力の種類:
file - LogFile パラメータで指定されたファイルにログを書き込みます。
system - syslog にログを書き込みます。
console - 標準出力にログを書き込みます。

デフォルト: file

PersistentBufferFile

Zabbixエージェント2がSQLiteデータベースを保存するファイル。完全なファイル名を指定する必要があります。このパラメータは、永続バッファが有効になっている場合（EnablePersistentBuffer=1）のみ使用されます。

PersistentBufferPeriod

サーバーまたはプロキシへの接続がない場合にデータを保存する期間です。古いデータは失われます。ログデータは保持されます。このパラメータは、永続バッファが有効になっている場合（EnablePersistentBuffer=1）のみ使用されます。

デフォルト: 1h
範囲: 1m～365d

PidFile

PIDファイルの名前

デフォルト: /tmp/zabbix_agent2.pid

Plugins.<PluginName>.System.Capacity

<PluginName> プラグインごとに同時に実行できるチェックの上限。

デフォルト: 1000 範囲: 1-1000

Plugins.Log.MaxLinesPerSecond

'log'および'logrt'アクティブチェックの処理時に、エージェントがZabbixサーバーまたはプロキシに送信する1秒あたりの新規行の最大数。ここで指定した値は、'log'および'logrt'アイテムキーで指定された'maxlines'パラメータによって上書きされます。
注: Zabbixは、ログアイテム内で必要な文字列を検索するために、MaxLinesPerSecondで設定された値の10倍の新規行を処理します。

デフォルト: 20
範囲: 1-1000

Plugins.SystemRun.LogRemoteCommands

実行されたシェルコマンドを警告としてログに記録します。コマンドはリモートで実行された場合にのみログに記録されます。system.run[] が HostMetadataItem、HostInterfaceItem、または HostnameItem パラメータによってローカルで起動された場合は、ログエントリは作成されません。

デフォルト: 0
値: 0 - 無効、1 - 有効

PluginSocket

ロード可能なプラグイン通信用のUNIXソケットへのパス

デフォルト: /tmp/agent.plugin.sock

PluginTimeout

読み込み可能なプラグインとの接続のタイムアウト（秒単位）

デフォルト: Timeout
範囲: 1-30

RefreshActiveChecks

アクティブチェックのリストを更新する頻度（秒単位）。アクティブチェックのリストの更新に失敗した場合、次の更新は60秒後に試行されます。

デフォルト: 5
範囲: 1-86400

Server

ZabbixサーバーまたはZabbixプロキシのIPアドレス（CIDR表記も可）またはDNS名をカンマ区切りで指定します。ここで指定したホストからの接続のみが受信されます。IPv6サポートが有効な場合、'127.0.0.1'、'::127.0.0.1'、'::ffff:127.0.0.1'は同等に扱われ、'::/0'は任意のIPv4またはIPv6アドレスを許可します。'0.0.0.0/0'は任意のIPv4アドレスを許可します。スペースも使用できます。このパラメータを指定しない場合、パッシブチェックは無効になり、エージェントはどのTCPポートも待受しません。

例：

Server=127.0.0.1,192.168.1.0/24,::1,2001:db8::/32,zabbix.example.com

ServerActive

アクティブチェックの取得元となるZabbixサーバー/プロキシのアドレス、またはクラスタ設定を指定します。
サーバー/プロキシのアドレスは、IPアドレスまたはDNS名と、必要に応じてコロンで区切ったポート番号です。
クラスタ設定は、1つ以上のサーバーまたはプロキシグループメンバーのアドレスをセミコロンで区切って指定します。
複数のZabbixサーバー/クラスタおよびZabbixプロキシを、カンマで区切って指定できます。
プロキシグループを使用しない限り、各Zabbixサーバー/クラスタごとに複数のZabbixプロキシを指定してはいけません。
Zabbixプロキシを指定した場合、そのプロキシに対応するZabbixサーバー/クラスタは指定してはいけません。
複数の独立したZabbixサーバーを並行して使用するために、カンマ区切りで複数のアドレスを指定できます。
スペースを含めることができます。
ポートを指定しない場合は、デフォルトのポートが使用されます。
IPv6アドレスでそのホストのポートを指定する場合、IPv6アドレスは角括弧で囲む必要があります。
ポートを指定しない場合、IPv6アドレスの角括弧は省略可能です。
このパラメータを指定しない場合、アクティブチェックは無効になります。

Zabbixプロキシの例: 

ServerActive=127.0.0.1:10051

Zabbixプロキシグループの例:

ServerActive=proxy1.example.com;proxy2.example.com;proxy3.example.com;proxy4.example.com;proxy5.example.com

複数サーバーの例: 

ServerActive=127.0.0.1:20051,zabbix.domain,[::1]:30051,::1,[12fc::1]

高可用性の例:

ServerActive=zabbix.cluster.node1;zabbix.cluster.node2:20051;zabbix.cluster.node3

2つのクラスタと1つのサーバーを使用した高可用性の例:

ServerActive=zabbix.cluster.node1;zabbix.cluster.node2:20051,zabbix.cluster2.node1;zabbix.cluster2.node2,zabbix.domain
SourceIP

以下の送信元IPアドレス：
- ZabbixサーバーまたはZabbixプロキシへの送信接続
- 特定のアイテム（web.page.get、net.tcp.portなど）の実行中に接続を確立する場合

StatusPort

設定されている場合、エージェントはこのポートでHTTPステータスリクエスト（http://localhost:<port>/status）を待受します。

範囲: 1024-32767

Timeout

Zabbixプロキシまたはサーバーとの接続確立およびデータ交換を待機する時間（秒）を指定します。

このパラメータは、以下を含むさまざまな通信処理の継続時間を定義します。

  • Zabbixサーバーからの応答待機時間。
  • アクティブチェック におけるアイテム設定要求およびアイテムデータを含む、Zabbixサーバーへのリクエスト送信。
  • logfile を介したログデータの取得。
  • ハートビートメッセージの送信。
  • vfs.* チェックの最大継続時間。
  • バージョン 7.0 より前のサーバーまたはプロキシがタイムアウトなしでチェックを送信する場合のフォールバックとして機能すること。

このタイムアウトは、Webインターフェースでタイムアウト設定を構成できるエージェントチェック（グローバル、プロキシ、またはアイテム単位）には使用されません。

デフォルト: 3
範囲: 1-30

TLSAccept

受け入れる受信接続。パッシブチェックに使用します。複数の値をカンマで区切って指定できます。
unencrypted - 暗号化なしの接続を受け入れます（デフォルト）
psk - TLSと事前共有鍵（PSK）を使用した接続を受け入れます
cert - TLSと証明書を使用した接続を受け入れます

必須：TLS証明書またはPSKパラメータが定義されている場合は必須、そうでない場合は必須ではない。

TLSCAFile

Zabbix コンポーネント間の暗号化通信に使用される、ピア証明書検証用の最上位 CA 証明書を含むファイルのフルパス名

TLSCertFile

Zabbix コンポーネントとの暗号化通信に使用されるエージェント証明書または証明書チェーンを含むファイルのフルパス名

TLSCipherAll

OpenSSL 暗号文字列 (TLS 1.2)証明書ベースおよび PSK ベースの暗号化におけるデフォルトの暗号スイート選択基準を上書きします。

例:

EECDH+aRSA+AES128:RSA+aRSA+AES128:kECDHEPSK+AES128:kPSK+AES128

TLSCipherAll13

OpenSSL 1.1.1 以降用の OpenSSL 暗号文字列 (TLS 1.3)証明書ベースおよび PSK ベースの暗号化におけるデフォルトの暗号スイート選択基準を上書きします。

例:

TLS_AES_256_GCM_SHA384:TLS_CHACHA20_POLY1305_SHA256:TLS_AES_128_GCM_SHA256

TLSCipherCert

OpenSSL 暗号文字列 (TLS 1.2)証明書ベースの暗号化におけるデフォルトの暗号スイート選択基準を上書きします。

例:

EECDH+aRSA+AES128:RSA+aRSA+AES128

このパラメータは TLSAccept=cert,psk と同時に使用できないことに注意してください。証明書接続 (TLSConnect=cert) の場合は、代わりに TLSCipherAll を使用してください。

TLSCipherCert13

OpenSSL 1.1.1 以降用の OpenSSL 暗号文字列 (TLS 1.3)証明書ベースの暗号化におけるデフォルトの暗号スイート選択基準を上書きします。

このパラメータは TLSAccept=cert,psk と同時に使用できないことに注意してください。証明書接続 (TLSConnect=cert) の場合は、代わりに TLSCipherAll13 を使用してください。

TLSCipherPSK

OpenSSL 暗号文字列 (TLS 1.2)PSK ベースの暗号化におけるデフォルトの暗号スイート選択基準を上書きします。

例:

kECDHEPSK+AES128:kPSK+AES128

TLSCipherPSK13

OpenSSL 1.1.1 以降用の OpenSSL 暗号文字列 (TLS 1.3)PSK ベースの暗号化におけるデフォルトの暗号スイート選択基準を上書きします。

例:

TLS_CHACHA20_POLY1305_SHA256:TLS_AES_128_GCM_SHA256

TLSConnect

エージェントがZabbixサーバーまたはプロキシに接続する方法。アクティブチェックに使用されます。指定できる値は1つだけです。
unencrypted - 暗号化なしで接続（デフォルト）
psk - TLSと事前共有鍵（PSK）を使用して接続
cert - TLSと証明書を使用して接続

必須：TLS証明書またはPSKパラメータが定義されている場合は必須、そうでない場合は必須ではない。

TLSCRLFile

失効した証明書を含むファイルのフルパス名。このパラメータは、Zabbixコンポーネント間の暗号化通信に使用されます。

TLSKeyFile

Zabbix コンポーネント間の暗号化通信に使用されるエージェント秘密鍵を含むファイルのフルパス名

TLSPSKFile

Zabbix サーバーとの暗号化通信に使用されるエージェントの事前共有キーを含むファイルのフルパス名

TLSPSKIdentity

Zabbixサーバーとの暗号化通信に使用される、事前共有キーのID文字列

TLSServerCertIssuer

許可されたサーバー（プロキシ）証明書の発行者

TLSServerCertSubject

許可されたサーバー（プロキシ）証明書のサブジェクト

UnsafeUserParameters

ユーザー定義パラメータの引数として、すべての文字を渡すことを許可します。以下の文字は許可されません: \ ' " ` * ? [ ] { } \~ $ ! & ; ( ) < > | # @
改行文字も許可されません。

デフォルト: 0
値: 0 - 許可しない、1 - 許可する

UserParameter

監視するユーザー定義パラメータ。複数のユーザー定義パラメータを指定できます。
形式: UserParameter=<キー>,<シェルコマンド>
シェルコマンドは空文字列やEOLのみを返さないでください。UserParameterDirパラメータが指定されている場合、シェルコマンドは相対パスで指定できます。

例:

UserParameter=system.test,who|wc -l UserParameter=check_cpu,./custom_script.sh

UserParameterDir

UserParameter コマンドのデフォルトの検索パスです。このパスを指定すると、エージェントはコマンド実行前にここで指定されたディレクトリに作業ディレクトリを変更します。これにより、UserParameter コマンドにはフルパスではなく相対パスの ./ プレフィックスを付けることができます。
指定できるエントリは1つだけです。

例:

UserParameterDir=/opt/myscripts