Zabbix 7.4 を Zabbix 8.0 にバージョンアップする
Zabbix 8.0 がリリースされたので、Zabbix 7.4からバージョンアップしました。バージョンアップしたサーバーのスペックは以下となります
- OS:Rocky Linux release 8.10
- Zabbix 7.4
zabbix-agent2について
zabbix-agent2には、従来の Zabbix Agent(C言語製) と Zabbix Agent 2(Go言語製) の一番大きな違いは、内部構造(アーキテクチャ)が「マルチプロセス」から「非同期の並行処理+プラグイン方式」に作り直された点です。
1. プラグイン対応でミドルウェア監視が圧倒的に楽になる
これが実運用で最も恩恵が大きいポイントです。
- 従来の Agent:OSの標準メトリクス(CPU、メモリ、ディスク等)以外の監視(Docker、Redis、PostgreSQL、MySQL、MongoDB、systemd、スマートモニタリング等)を行うには、別途シェルスクリプトを組んで
UserParameterを定義したり、ODBC等の外部ツールを用意する必要がありました。 - Agent 2:標準で多数のプラグインが組み込まれています。Zabbixの公式テンプレートを適用するだけで、スクリプトを書かずに各種ミドルウェアやコンテナ、systemdのサービス状態などを直接監視できます。
2. チェックの並行処理とスケジュール管理(待ち時間の解消)
- 従来の Agent:設定された
StartAgentsのプロセス数で順番に処理を行うため、重いチェックやタイムアウトが発生する監視項目があると、他のチェックが待たされる(キューが詰まる)ことがありました。 - Agent 2:Go言語の並行処理(goroutine)により、複数のチェックを並列で効率よく実行します。特定のアイテムが遅延しても他の監視項目に影響しにくく、独自のスケジューラで柔軟に間隔を制御できます。
3. 永続的な接続(ステートフル)とローカルキャッシュの強化
- 従来の Agent:DBなどを監視する際、チェックのたびに接続して切断する(ステートレス)動きになりがちで、監視対象に余計な負荷をかけることがありました。
- Agent 2:プラグインごとに接続状態を維持(コネクションプーリング)できるため、監視対象への接続オーバーヘッドが減ります。また、ネットワーク断などでZabbixサーバーと通信できない場合も、メモリやローカルファイル(設定による)にデータを保持して復旧後にまとめて送信する仕組みが強化されています。
Zabbix 8のバージョンアップ手順
インストールの際にの参考サイトは公式のサイトから、手順書を修正して作成しています。また今回はzabbix-agent2を利用します
Zabbix関連のサービスを停止する
バージョンアップ作業を実施する前にzabbix関連のサービスを停止してDB更新をおこなわないようにします
# zabbixサーバを停止します $ sudo systemctl stop zabbix-server # zabbixクライアントを停止します $ sudo systemctl stop zabbix-agent
バックアップを作成する
バージョンアップ前の環境を設定ファイルやコンテンツをバックアップします
設定ファイルをバックアップします
$ sudo mkdir /var/tmp/zabbix-backup/ $ sudo cp /etc/zabbix/zabbix_server.conf /var/tmp/zabbix-backup/ $ sudo cp /etc/httpd/conf.d/zabbix.conf /var/tmp/zabbix-backup/
WEB管理画面のコンテンツをバックアップする
$ sudo cp -R /usr/share/zabbix/ /var/tmp/zabbix-backup/ $ sudo cp -R /usr/share/zabbix-* /var/tmp/zabbix-backup/
Zabbix をアップグレードする
zabbixをバージョンアップする流れとしては、最新のリポジトリに更新をおこなってから、dnfコマンドでアップデートします。
zabbixクライアントに関しては、zabbix-agent2を利用するので、zabbix-agentdは削除してからzabbix-agent2をインストールする流れになります
1.レポジトリをzabbix 8に対応した最新にものに変更します。
下記コマンドは、RHEL8系のRockyLinux8でのリポジトリとなっていますので、~rhel/8/noarch~ の箇所のOSのバージョンは使用する環境によって変更して下さい
# OS:RockyLinux 8 $ sudo rpm -Uvh https://repo.zabbix.com/zabbix/8.0/release/rhel/8/noarch/zabbix-release-latest.el8.noarch.rpm
2.dnf パッケージマネージャーのキャッシュをクリーンアップします
$ sudo dnf clean all
3.インストールされている、zabbixを確認します
$ rpm -qa|grep zabbix zabbix-web-deps-7.4.16-release2.el8.noarch zabbix-agent-7.4.16-release2.el8.x86_64 zabbix-release-8.0-2.el9.noarch zabbix-sql-scripts-7.4.16-release2.el8.noarch zabbix-apache-conf-7.4.16-release2.el8.noarch zabbix-web-7.4.16-release2.el8.noarch zabbix-web-japanese-7.4.16-release2.el8.noarch zabbix-selinux-policy-7.4.16-release2.el8.x86_64 zabbix-web-service-7.4.16-release2.el8.x86_64 zabbix-web-mysql-7.4.16-release2.el8.noarch zabbix-server-mysql-7.4.16-release2.el8.x86_64
4.クライアントは、zabbix-agent2を利用するので、zabbix-agentを削除する
$ sudo dnf remove zabbix-agent
5.インストールされているzabbixを参考にして、必要なパッケージをインストールします
$ sudo dnf install zabbix-server-mysql zabbix-web-mysql zabbix-web-japanese zabbix-apache-conf \ zabbix-selinux-policy zabbix-web-service zabbix-agent2 zabbix-agent2-plugin-*
6.zabbixのWebインターフェースをZabbix8用にアップグレードします
$ sudo dnf install zabbix-apache-conf $ sudo systemctl restart httpd
7.zabbix関連のサービスを起動します
$ sudo systemctl restart zabbix-server.service $ sudo systemctl restart zabbix-agent2.service $ sudo systemctl restart zabbix-web-service.service
zabbixクライアントのみをバージョンアップする場合
複数のクライアントがいる環境で、クライアントのサービス(zabbix-agent2)のみをzabbix8にしたい場合は以下の作業となります
zabbix-agent2のインストール方法
1.レポジトリをzabbix 8に対応した最新にものに変更します。
$ sudo rpm -Uvh https://repo.zabbix.com/zabbix/8.0/release/rhel/8/noarch/zabbix-release-latest.el8.noarch.rpm
2.クライアントは、最新版のzabbix-agent2を利用するので、zabbix-agentを削除する
$ sudo dnf remove zabbix-agent
3.クライアントパッケージをアップグレードする
$ sudo dnf install zabbix-agent2
4.zabbixクライアント起動する
$ sudo systemctl start zabbix-agent2
クライアントの設定ファイルについて
zabbix-agent2をインストールすると、zabbix-agentdで利用していたファイルは、「zabbix_agentd.conf.rpmsave」とリネームされコピーされて、「zabbix_agent2.conf」を新規で配置されます。
その際に、「zabbix_agent2.conf」は、初期設定状態となり、「zabbix_agentd.conf」を編集している場合はその値が反映していない状態となるので、「zabbix_agent2.conf」を編集する必要があります。この編集しないとクライアントから正しい通信ができず監視対象の値が取得できません
# 新規ファイルの値を確認する $ sudo grep -E "^(Server|ServerActive|Hostname)=" /etc/zabbix/zabbix_agent2.conf Server=127.0.0.1 ServerActive=127.0.0.1 Hostname=Zabbix server # 以前のファイルの値を確認します $ sudo grep -E "^(Server|ServerActive|Hostname)=" /etc/zabbix/zabbix_agentd.conf.rpmsave Server=192.168.0.10 ServerActive=192.168.0.10:10051 Hostname=zabbix_master
上記のように値が異なっていれば正しい値に変更します
$ sudo vim /etc/zabbix/zabbix_agent2.conf Server=192.168.0.10 ServerActive=192.168.0.10:10051 Hostname=zabbix_master
設定ファイル後は、zabbix-agent2を再起動します
$ sudo systemctl start zabbix-agent2
バージョンアップ後、zabbixが起動しない場合
私の環境でも、バージョンアップ後にzabbixが起動しないケースが発生しました。
対策は別記事(zabbix8 にバージョンアップしたらzabbixが起動しない)に書いてますので、参考にして下さい。
内容としては、zabbix-agent2で対応していないプラグインがインストールされ起動しないパターンと、MariaDBのバージョンが古くzabbix-serverが起動しなかったケースです


