マニュアル

Job Server：jasender.shの設定

※バージョン2.1.0からJob Serverが直接Zabbixにメッセージを通知するため、「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] メッセージ本文 (HostName=ジョブ実行ホスト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
イベント生成 任意のイベント生成を設定
深刻度 任意の深刻度を設定
ヒストリ保存期間 任意の保存期間を設定
-->

Job Arranger マニュアル