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