Zabbixサーバー指標をGrafanaで可視化する（第2編) — Zabbix プラグインのインストールと Data Source 連携

📘 概要

第1回で Grafana のインストールとサービス設定が完了したら、
今回は Zabbix のデータを Grafana に接続する手順に進む。

本記事では Grafana 公式プラグインの一つである
zabbix plugin（alexanderzobnin-zabbix-app） を導入し、
Zabbix API を通じてリアルタイムメトリクスを取得する方法を解説する。

このプラグインは単なるグラフ描画用ではなく、
Zabbix の Host / Item / Trigger を直接クエリできる 強力な拡張機能で、
Zabbix を Grafana の Data Source に変換する中核となるコンポーネントだ。

---

1. Zabbix プラグインのインストール

Grafana は grafana-cli コマンドでプラグインを管理する。
Zabbix プラグインをインストールするには以下を実行する：

# grafana-cli plugins install alexanderzobnin-zabbix-app

インストール後、Grafana を再起動する：

# systemctl restart grafana-server

✅ 確認コマンド

grafana-cli plugins ls

リストに alexanderzobnin-zabbix-app が表示されれば正常。

---

2. プラグインの有効化

ブラウザから Grafana にログインし：

Administration → Plugins and data → Plugins

検索欄に zabbix と入力
→ 一覧から Zabbix を選択
→ Enable ボタンで有効化

💡 Grafana 10.x 以降ではプラグイン構造が変更されており、
旧バージョンのように「Configuration → Plugins」には表示されない。
必ず「Plugins and data」から有効化する。

---

3. Zabbix Data Source の追加

プラグインを有効化したら、Zabbix を Data Source として登録する。

Menu → Connections → Data sources → Add data source
→ Zabbix を選択

Connection タブの設定

項目	例	説明
URL	http://localhost/zabbix/api_jsonrpc.php	同一サーバーの場合
URL（外部）	http://<ZABBIX_IP>/zabbix/api_jsonrpc.php	別サーバーの場合
Username	Admin	Zabbix のログインユーザー
Password	zabbix	初期パスワード（必ず変更推奨）

⚠️ 注意：
Grafana サーバーが Zabbix API endpoint に到達できる必要がある。
（Firewall / Proxy / nginx ACL などで遮断されていると失敗する）

---

3.1 接続テスト

すべて入力後、Save & Test をクリック。
成功するとメッセージが表示される。

💬 失敗時の確認ポイント

• URL が /api_jsonrpc.php で終わっているか
• Grafana サーバーから curl で API が叩けるか

curl -X POST -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"apiinfo.version","id":1}' \
  http://<ZABBIX_IP>/zabbix/api_jsonrpc.php

---

4. 初回パネルの動作確認

プラグインが正常なら簡単に動作を確認できる：

Dashboards → New → Dashboard → Add visualization

• Data source: Zabbix
• Query Type: Metrics
• Group / Host / Item を選択
  例：Group: Linux servers, Host: web01, Item: CPU utilization

グラフが表示されれば成功。

🧠 メモ：

• Zabbix 側で template ベースの Host/Item が事前に設定されている必要がある
• CPU / Memory / Disk など主要メトリクスは標準テンプレートで自動表示
• 追加 Item が必要な場合は Zabbix の Key を直接クエリできる

---

5. トラブルシューティング

問題	原因	対処
Zabbix API version not found	API パスの誤り	正しい /api_jsonrpc.php を入力
401 Unauthorized	認証失敗	ユーザー名 / パスワード確認
Network Error	Firewall / Proxy による遮断	curl で疎通確認
Plugin not found	インストールパス問題	/var/lib/grafana/plugins を確認し再インストール

---

6. 次回予告

次の記事では 実務向けダッシュボード構成 を扱う。
CPU / Memory / Disk / Network を
1画面にわかりやすく集約するレイアウト例 を紹介する予定。

🛠 마지막 수정일: 2025.11.14