マニュアル

Job Server:jasender.shの設定

「jasender.sh」はJob ArrangerからZabbixにメッセージを通知する場合に使用します。
Job Arrangerでジョブの異常終了を検知した際や、Job Arranger内でエラーが発生した際に、Job Serverが「jasender.sh」を実行し、Zabbixへエラー通知を行います。
これにより、Zabbixのトリガ画面やイベント画面にJob Arrangerで発生したエラー内容を表示させたり、発生したエラーに応じて適切なアクションを設定することができます。

「jasender.sh」は初期インストール時に/etc/jobarranger/alert/jasender.sh(RPM使用時)に配置されます。
このシェルは内部で変数定義をしており、各環境に合わせて設定する必要があります。
設定対象となるパラメータは[jasender.sh内の環境変数]を参照下さい。
jasender.shは、内部でZabbixの機能の一部である「zabbix_sender」コマンドを呼び出しています。そのため「zabbix_sender」コマンドを「jasender.sh」からアクセスできる場所に配置しておく必要があります。
また、Zabbixにjasender通知用のItemsを作成しておく必要があります。
※ZabbixのItemsの登録方法についてはZabbixのマニュアルをご参照下さい。

実行コマンド(jasender.sh)

シンタックス

#./jasender.sh [ユーザID] [ジョブネットID] [現在時刻] [メッセージID] [重要度] [メッセージ本文] [ホスト名] [ジョブID]

※引数はJob Serverが自動で設定します。

Zabbixに送信されるメッセージ

[現在時刻] [重要度(INFO/CRIT/ERROR/WORN)] [メッセージID] メッセージ本文 (USER NAME=ユーザID JOBNET=ジョブネットID JOB=ジョブID)

jasender.sh 引数一覧

引数名 説明
ユーザID エラーが発生したジョブネットの作成ユーザID
ジョブネットID エラーが発生したジョブネットID
現在時刻 コマンド実行時の現在時刻(YYYY/MM/DD HH:MM:SS)
メッセージID メッセージID
重要度 メッセージの重要度
0 - INFO
1 - CRIT
2 - ERROR
3 – WARN
メッセージ本文 メッセージIDに対応するメッセージ本文
ホスト名 エラーが発生したアイコンに設定されたホスト名
※zabbix_senderに指定するホスト名となります。
※ジョブアイコン、ファイル転送アイコン、リブートアイコンのエラー時にのみ値が通知されます。その他のエラー時は空データが通知されます。
ジョブID エラーが発生したジョブID

jasender.sh内の環境変数

パラメータ 説明
ZABBIX_SERVER ZabbixサーバのIPアドレスを設定
ZABBIX_PORT Zabbixサーバのポート番号を設定
ZABBIX_SENDER zabbix_senderが格納されているパスを設定
KEY Zabbix上で登録されているItemsで設定したkeyを設定
HOST Zabbix上で登録されているエージェントのホスト名(デフォルト)を設定
※引数のホスト名が空データの場合はエージェントのホスト名にこのホスト名が使用されます。

Zabbix側受信Item設定

Zabbix Itemsパラメータ一覧数

パラメータ 説明
ホスト Zabbix上で登録されているエージェントのホスト名を設定
タイプ 「Zabbixトラッパー」を設定
キー 任意のキー名を設定
データ型 「テキスト」を設定
ヒストリ保存期間 任意の保存期間を設定
ステータス 「有効」を設定

Job Arranger マニュアル