3 スクリプト

概要

アラート → スクリプト セクションでは、ユーザー定義のグローバルスクリプトを設定および管理できます。

グローバルスクリプトは、設定されたスコープおよびユーザー権限に応じて、以下の場所から実行できます。

• ホストメニューから、さまざまなフロントエンドの場所（ダッシュボード、障害、最新データ、マップなど）
• イベントメニューから
• アクションのオペレーションとして実行

スクリプトは、Zabbixエージェント、Zabbixサーバー（プロキシ）、またはZabbixサーバーのみで実行されます。 コマンド実行も参照してください。

ZabbixエージェントおよびZabbixプロキシの両方で、リモートスクリプトはデフォルトで無効になっています。 有効にするには、以下の設定が必要です。

• Zabbixエージェントで実行されるリモートコマンドの場合:
  • エージェントの設定ファイルに、許可する各コマンドごとに AllowKey=system.run[<command>,*] パラメータを追加します。 * は wait モードと nowait モードの両方を意味します。
• Zabbixプロキシで実行されるリモートコマンドの場合:
  • 注意: Zabbixプロキシで監視されているZabbixエージェントでリモートコマンドを実行する場合、Zabbixプロキシでリモートコマンドを有効にする必要はありません。 ただし、Zabbixプロキシでリモートコマンドを実行する必要がある場合は、プロキシの設定ファイルで EnableRemoteCommands パラメータを '1' に設定してください。

Zabbixサーバーでのグローバルスクリプトの実行は、サーバー設定で EnableGlobalScripts=0 を設定することで無効にできます。新規インストールの場合、Zabbix 7.0以降では、Zabbixサーバーでのグローバルスクリプトの実行はデフォルトで無効になっています。

既存のスクリプトの一覧とその詳細が表示されます。

表示されるデータ:

新しいスクリプトを設定するには、右上隅の スクリプトの作成 ボタンをクリックします。

一括編集オプション

リストの下のボタンで一括編集オプションを1つ利用できます。

• 削除 - スクリプトの削除

このオプションを使用するには、該当するスクリプトの前のチェックボックスをオンにして、削除をクリックします。

フィルターの使用

フィルターを使用して、関心のあるスクリプトのみを表示できます。検索パフォーマンスを向上させるために、データはマクロが未解決の状態で検索されます。

フィルター リンクはスクリプトのリストの上にあります。これをクリックすると、名前やスコープでスクリプトをフィルタリングできるフィルターが利用可能になります。

グローバルスクリプトの設定

スクリプトの属性:

詳細設定

詳細設定オプションは、折りたたみ可能な詳細設定セクションで利用できます。

手動ユーザー入力と確認メッセージの両方が設定されている場合、連続したポップアップウィンドウで表示されます。

手動ユーザー入力

手動ユーザー入力を使用すると、スクリプトの実行ごとにカスタムパラメータを指定できます。これにより、パラメータが1つだけ異なる複数の類似したユーザースクリプトを作成する必要がなくなります。

たとえば、スクリプトの実行時に異なる整数や異なるURLアドレスを指定したい場合があります。

手動ユーザー入力を有効にするには、次の手順を実行します。

• 必要な場所でスクリプト（コマンド、スクリプト、スクリプトパラメータ）内、またはURLスクリプトのURLフィールド内で{MANUALINPUT}マクロを使用します。
• 詳細スクリプト設定で手動ユーザー入力を有効にし、入力オプションを設定します。

ユーザー入力が有効になっている場合、スクリプトの実行前に手動入力のポップアップがユーザーに表示され、カスタム値の入力を求められます。指定された値はスクリプト内の{MANUALINPUT}と置き換えられます。

設定によっては、ユーザーは文字列値の入力を求められます。

または、あらかじめ決められたオプションのドロップダウンから値を選択します。

手動ユーザー入力は、スコープが「手動ホストアクション」または「手動イベントアクション」のスクリプトでのみ利用できます。

スクリプトの実行と結果

Zabbixサーバーによって実行されるスクリプトは、コマンド実行ページで説明されている順序で実行されます。

スクリプトの結果は、スクリプト実行後に表示されるポップアップウィンドウに表示されます。スクリプトの戻り値は標準出力です:

• スクリプトが正常に終了した場合（終了コードが0）、戻り値は16MBに制限されます（末尾の空白も含み、切り捨てられます）。
• スクリプトがエラーで終了した場合（非ゼロの終了コード）、戻り値は標準エラー出力で2KBに制限されます。

Zabbixはデフォルトで拡張スクリプト出力を保存しません。出力の詳細を保持するには、スクリプト内でロギングを実装することができます（例: 出力をローカルログファイルにリダイレクトするなど）。

ZabbixサーバーまたはZabbixプロキシで実行されるスクリプトについては、データベースの制限も適用されることに注意してください。

以下はスクリプトと結果ウィンドウの例です:

uname -v
       /tmp/non_existing_script.sh
       echo "This script was started by {USER.USERNAME}"

スクリプトの結果にはスクリプト自体は表示されません。

スクリプトのタイムアウト

Zabbixエージェント

スクリプトの実行中にタイムアウトが発生する場合があります。

Zabbixエージェントでスクリプトを実行した例と、その結果ウィンドウを以下に示します。

sleep 5
       df -h

この場合のエラーメッセージは次のとおりです。

Timeout while executing a shell script.

このような状況を回避するには、Zabbixエージェントの設定やZabbixサーバーの設定のTimeoutパラメータを調整するのではなく、スクリプト自体（上記の例では「5」）を最適化することを推奨します。 ただし、Zabbixエージェントのアクティブモードの場合は、Zabbixエージェントの設定のRefreshActiveChecksパラメータよりも、Zabbixサーバーの設定のTimeoutパラメータを数秒以上長く設定する必要があります。 これにより、サーバーがエージェントからアクティブチェックの結果を受信するのに十分な時間が確保されます。アクティブエージェントでのスクリプト実行は、Zabbixエージェント7.0以降でサポートされています。

Zabbixエージェントの設定でTimeoutパラメータを変更した場合、次のエラーメッセージが表示されます。

Get value from agent failed: ZBX_TCP_READ() timed out.

これは、Zabbixエージェントの設定で変更が行われたことを意味しますが、Zabbixサーバーの設定のTimeoutパラメータも変更する必要があります。

Zabbixサーバー/プロキシ

Zabbixサーバーでスクリプトを実行した例と、下の結果ウィンドウを参照してください:

sleep 11
       df -h

また、Zabbixサーバーの設定を変更してTrapperTimeoutパラメータを対応する値(この場合は11より大きい値)に調整するのではなく、スクリプト自体を最適化することを推奨します。