●はじめに

Zabbixに独自の監視項目を追加できる機能「ユーザーパラメータ」の使い方と使用例をメモします。
ユーザーパラメータを使うと、Zabbix Agentに定義したコマンドやスクリプトを実行し、それらの標準出力をZabbixサーバーに返すことができます。

●環境

項目	詳細
ホストOS	macOS Monterey 12.2.1
仮想化ソフト	VMware Fusion 12.2.0
ゲストOS	Alma Linux 8.5
Zabbix/Zabbix Agent ver	5.0.21

●基本的な使い方

1.監視対象ホストにて監視項目追加

# 監視対象ホストにログイン
# zabbix_agentd.confを編集
$ vi /etc/zabbix/zabbix_agentd.conf

# 以下を編集
UserParameter=キー,コマンド
あるいは
UserParameter=キー[*],コマンド

# zabbix-agent再起動
$ systemctl restart zabbix-agent

2.Zabbix WebUI側でアイテム作成

Zabbix WebUI アイテム作成画面

名前：任意
タイプ：Zabbixエージェント
キー:手順1で指定したキー
データ型：コマンドの標準出力の結果に合わせる
※他は任意の設定

補足

手順1でキー[*] とすると、Zabbix WebUIのアイテムキー設定でユーザーパラメータに対して引数を渡せる（設定例参考）

●サービス死活監視の設定例

1.ユーザーパラメータの設定

# 監視対象ホストのzabbix_agentd.confを編集
$ vi zabbix_agentd.conf

# 以下の通りに記述
UserParameter=httpd.info,systemctl status httpd | awk 'NR==5{print $3}'

NRの数値5は、標準出力に対し「上から5行目」を表す
5行目ではなく3行目、とかの場合もあるので、一旦対象ホストでsystemctl statusコマンドを実行して確かめるのを推奨

2.Zabbix WebUI アイテム作成

1.Zabbix WebUIにログイン
2.左ペイン[設定] - [ホスト] - 任意のホスト選択 - [アイテム] - [アイテム作成]の順に押下
3.以下の通り入力し、更新を押下

名前：サービス死活監視
タイプ：Zabbixエージェント
キー:httpd.info
データ型：文字列

アイテム画面

取得結果