ジョブサーバー:jasender.shの設定

※バージョン2.1.0からジョブサーバが直接Zabbixにメッセージを通知しますので、「jasender.sh」の設定は不要です。
「jasender.sh」はJob ArrangerからZabbixにメッセージを通知する場合に使用します。
Job Arrangerでジョブの異常終了を検知した際や、Job Arranger内でエラーが発生した際に、ジョブサーバが「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]
※引数はジョブサーバが自動で設定します。

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トラッパー」を設定してください。
キー 任意のキー名を設定してください。
データ型 「テキスト」を設定してください。
ヒストリ保存期間 任意の保存期間を設定してください。
ステータス 「有効」を設定してください。

Zabbix Triggerパラメータ一覧

パラメータ 設定内容
名前 任意のトリガー名を設定してください。
(Job Arrangerから送付されるメッセージ本文をそのままZabbixの画面に表示させたい場合は{ITEM.VALUE}を設定します)
条件式 {<ホスト名>:<キー名>.str([<重要度>])}=1
イベント生成 任意のイベント生成を設定してください。
深刻度 任意の深刻度を設定してください。
ヒストリ保存期間 任意の保存期間を設定してください。