7 外部チェック

概要

外部チェックは、Zabbix サーバーが シェルスクリプトの実行 またはバイナリを実行して行うチェックです。ただし、ホストが Zabbix プロキシによって監視されている場合、外部チェックはプロキシによって実行されます。

外部チェックでは、監視対象のホスト上でエージェントを実行する必要はありません。

アイテムキーの構文は次のとおりです。

script[<parameter1>,<parameter2>,...]

各項目の意味は次のとおりです。

ARGUMENT DEFINITION
script シェルスクリプトまたはバイナリの名前。
parameter(s) 省略可能なコマンドラインパラメーター。

スクリプトにパラメーターを渡したくない場合は、次を使用できます。

script[] または
script

Zabbix サーバーまたはプロキシは、外部スクリプト用に指定されたディレクトリを検索し、コマンドを実行します（Zabbix server/proxy 設定ファイルの ExternalScripts パラメーターを参照してください）。 コマンドは Zabbix サーバー/プロキシと同じユーザー権限で実行されるため、必要に応じて、アクセス権限や環境変数はラッパースクリプトで処理してください。 コマンドの権限も、そのユーザーが実行できるように設定されている必要があります。 指定されたディレクトリ内のコマンドのみが実行可能です。

外部チェックを使いすぎないでください。各スクリプトの実行ごとに Zabbix サーバー/プロキシは fork プロセスを開始する必要があり、多数のスクリプトを実行すると Zabbix のパフォーマンスが大幅に低下する可能性があります。

使用例

最初のパラメータ '-h' を指定してスクリプト check_oracle.sh を実行します。2番目のパラメータは、ホストのプロパティでの選択に応じて、IPアドレスまたはDNS名に置き換えられます。

check_oracle.sh["-h","{HOST.CONN}"]

ホストがIPアドレスを使用するように設定されている場合、Zabbixサーバー/プロキシは次を実行します。

check_oracle.sh '-h' '192.168.1.4'

外部チェックの結果

外部チェックの戻り値は、チェックによって生成される標準出力と標準エラー出力です。

テキスト（character、log、またはtext型の情報）を返すアイテムは、標準エラー出力があっても未サポートにはなりません。

戻り値は16MBに制限されています（切り捨てられる末尾の空白を含む）。データベースの制限も適用されます。

要求されたスクリプトが見つからない場合、またはZabbixサーバー/プロキシにその実行権限がない場合、アイテムは未サポートになり、対応するエラーメッセージが表示されます。

タイムアウトが発生した場合、アイテムは未サポートになり、対応するエラーメッセージが表示され、スクリプト用にforkされたプロセスは終了されます。