TimescaleDB は、時系列データベースの機能を PostgreSQL に追加する拡張モジュールで、自動的にデータを時間単位で分割された小さなテーブルに格納できます。Zabbix のデータベースに TimescaleDB を使用することで、性能向上、ディスク使用量の削減などの効果が期待できます。

本記事では、 Zabbix で TimescaleDB を利用するメリット、セットアップ方法、利用上の注意点について紹介します。

TimescaleDB のサポート

TimescaleDB は Zabbix 4.4 から正式にサポートされるようになりました。

TimescaleDB では、時系列データベースの機能を適用した親テーブルをハイパーテーブルと呼び、データは内部的にチャンクと呼ばれる小さなテーブルに分割されます。

具体的には以下のヒストリ・トレンドデータを格納するテーブルをハイパーテーブルに変換し、日付ごとにチャンクが自動的に作成されます。

• history
• history_uint
• history_log
• history_text
• history_str
• trends
• trends_uint

また、Zabbix 5.0 以降では、古くなったチャンクを圧縮し、ファイルサイズを縮小することも可能です。

Zabbix で TimescaleDB を利用するメリット

Zabbix で TimescaleDB を利用することで、次のようなメリットが得られます。

Housekeeper による削除処理の負荷軽減

Housekeeper とは、保存期間を超えたヒストリ・トレンドやイベント、アラートなどのデータを定期的に削除する機能です。

Housekeeper の削除処理は時間範囲で絞り込んで、1行ずつ DELETE するので、削除するレコード数が多くなればなるほど時間がかかり、データベースへの負荷が高まります。データベースの負荷上昇によって、データの読み取り/書き込みが遅くなり、監視の遅延や誤検知など監視全体に影響を与える可能性があります。

一方、Zabbix で TimescaleDB を利用すると、1行ずつ削除する DELETE に対して、TimescaleDB はチャンク単位でデータを削除するため、非常に高速です。これまでの Housekeeper の削除処理による高負荷問題を解決できます。

NVPS が 300 程度、同様な監視設定の Zabbix サーバで、素の PostgreSQL と TimescaleDB を利用した場合の Housekeeper の負荷を検証してみました。Zabbix サーバとデータベースは同一サーバ上で動作し、環境情報は以下の通りです。

• OS: RHEL 8.5 (VirtualBox 上の VM)
• CPU: 2vCPUs
• メモリ: 4GB

PostgreSQL の場合は、Housekeeper プロセスのビジー率が 100% まで上がる場合がありました。PostgreSQL と比べて、TimescaleDB の場合は最大でも 20% 以下で大幅に軽減されていることがわかります。
※今回の検証で以下の結果を得ましたが、削除するイベントやアラートなどの量によって Housekeeper プロセスのビジー率が変動します。

不要領域発生の抑止

PostgreSQL は追記型アーキテクチャを採用しているため、DELETE を実行しても PostgreSQL が使用するディスク領域サイズは減りません。DELETE はデータを削減することはできますが、不要領域が発生します。不要領域を回収して再利用可能な状態にするには VACUUM が必要になります。

Zabbix で TimescaleDB を利用すると、チャンクごと削除するため、DELETE による不要領域の発生を抑止でき、不要領域を回収するための VACUUM 処理によるオーバーヘッドも削減できます。

圧縮によるディスク領域の節約

Zabbix で長期運用すると、収集した監視データによって DB のサイズが肥大化していきます。TimescaleDB の圧縮機能を利用し、一定期間経過したヒストリ・トレンドデータを自動的に圧縮できます。

10GB の history テーブルと history_uint テーブルにおいて、7日を超過したデータを圧縮すると、圧縮前に比べて、ディスク領域はそれぞれ 89% と 95% 削減できました。history_log、history_text、history_str テーブルのレコードは可変長レコードであり、レコードのサイズによって圧縮率が変動します。

書き込み性能の向上

TimescaleDB では、チャンクごとにインデックスを構築するため、インデックスのサイズが小さくなります。また、TimescaleDB は最新のチャンクのデータとインデックスをメモリに保存するため、データ挿入時のインデックスの更新が高速になり、書き込み性能が向上します。

TimescaleDB のインストール・設定

この節では、Zabbix のデータベースとして TimescaleDB を利用するためのインストール・設定手順を説明します。

検証環境

今回は以下の構成でインストールを行います。各ソフトウェアは 2022 年 5 月時点での最新バージョンを利用しています。

• OS: RHEL 8.5
• Zabbix 6.0.3
• PostgreSQL 14.2
• TimescaleDB 2.6.1

TimescaleDB は 2022 年 5 月時点で以下のバージョンがメンテナンスされており、それぞれ対応する PostgreSQL のバージョンは以下の通りです。

前提条件

TimescaleDB をインストールする前に、Zabbix サーバと PostgreSQL がすでにインストールされており、データベースの初期設定、データベーススキーマと初期データの投入が完了していることが前提となります。

まだ完了していない場合は、こちらのインストール手順を参照してください。

TimescaleDB のインストール

本記事では、RHEL 8 上で構築した PostgreSQL サーバに TimescaleDB をインストールします。他のプラットフォーム向けのインストール方法については TimescaleDB のドキュメントを参照してください。

TimescaleDB の Yum リポジトリを登録します。

$ sudo tee /etc/yum.repos.d/timescale_timescaledb.repo <<EOL
[timescale_timescaledb]
name=timescale_timescaledb
baseurl=https://packagecloud.io/timescale/timescaledb/el/$(rpm -E %{rhel})/\$basearch
repo_gpgcheck=1
gpgcheck=0
enabled=1
gpgkey=https://packagecloud.io/timescale/timescaledb/gpgkey
sslverify=1
sslcacert=/etc/pki/tls/certs/ca-bundle.crt
metadata_expire=300
EOL

TimescaleDB の RPM パッケージをインストールします。
※ PostgreSQL xx がインストールされている場合は timescaledb-2-postgresql-xx を指定します。

$ sudo dnf install timescaledb-2-postgresql-14

TimescaleDB の設定

PostgreSQL で TimescaleDB を利用するための設定を行います。

PostgreSQL の設定ファイル postgresql.conf を直接編集しても良いですが、ここでは、環境のスペックに応じて対話的に PostgreSQL パラメータのチューニングを行う timescaledb-tune コマンドを使います。

--pg-config オプションには pg_config コマンドのパスを指定します。その他のオプションについては timescaledb-tune --help で確認できます。
以下のコマンドを実行すると、次々と質問されますが、基本的には y を入力していけば良いです。最後に設定が postgresql.conf に書き込まれます。環境によって、Zabbix で使用するには max_connections の推奨値が小さすぎる可能性があるので、ここでは明示的に max_connections の値を設定します。

$ sudo timescaledb-tune --pg-config=/usr/pgsql-14/bin/pg_config --max-conns=100

上記コマンドによって、TimescaleDB が shared_preload_libraries にロードされ、PostgreSQL のパラメータが環境に応じた適切な値に設定されます。

設定変更を反映するため、PostgreSQL のサービスを再起動します。

$ sudo systemctl restart postgresql-14

TimesaceleDB 拡張の作成

Zabbix サーバが利用する zabbix データベースに TimesaceleDB 拡張をインストールします。

$ echo "CREATE EXTENSION IF NOT EXISTS timescaledb CASCADE;" | sudo -u postgres psql zabbix

/usr/share/doc/zabbix-sql-scripts/postgresql/ にある TimescaleDB のスキーマ作成スクリプト timescaledb.sql を実行します。

$ cat /usr/share/doc/zabbix-sql-scripts/postgresql/timescaledb.sql | sudo -u zabbix psql zabbix

上記コマンドに指定した timescaledb.sql スクリプトの中身を確認してみましょう。

(以下、実行不要)
$ cat /usr/share/doc/zabbix-sql-scripts/postgresql/timescaledb.sql
(省略)
# ヒストリ・トレンドテーブルを1日ごとにチャンクを作成するハイパーテーブルに変換。
# ヒストリ・トレンドテーブルに既存のデータがある場合には、既存のデータの移行が行われる。
PERFORM create_hypertable('history', 'clock', chunk_time_interval => 86400, migrate_data => true);
PERFORM create_hypertable('history_uint', 'clock', chunk_time_interval => 86400, migrate_data => true);
PERFORM create_hypertable('history_log', 'clock', chunk_time_interval => 86400, migrate_data => true);
PERFORM create_hypertable('history_text', 'clock', chunk_time_interval => 86400, migrate_data => true);
PERFORM create_hypertable('history_str', 'clock', chunk_time_interval => 86400, migrate_data => true);
PERFORM create_hypertable('trends', 'clock', chunk_time_interval => 2592000, migrate_data => true);
PERFORM create_hypertable('trends_uint', 'clock', chunk_time_interval => 2592000, migrate_data => true);

# [管理] -> [一般設定] -> [データの保存期間]ページで「アイテムのヒストリ/トレンドの保存期間設定を上書き」オプションを有効にする。
UPDATE config SET db_extension='timescaledb',hk_history_global=1,hk_trends_global=1;

# 圧縮機能を有効にする。デフォルトでは7日間を超えたデータは自動的に圧縮される。
UPDATE config SET compression_status=1,compress_older='7d';

Zabbix サーバのデータベースにアクセスし、history テーブルを確認してみます。

$ psql -U zabbix
Password for user zabbix: 
psql (14.2)
Type "help" for help.

zabbix=> \d+ history
                                                    Table "public.history"
 Column |       Type       | Collation | Nullable |        Default        | Storage | Compression | Stats target | Description 
--------+------------------+-----------+----------+-----------------------+---------+-------------+--------------+-------------
 itemid | bigint           |           | not null |                       | plain   |             |              | 
 clock  | integer          |           | not null | 0                     | plain   |             |              | 
 value  | double precision |           | not null | '0'::double precision | plain   |             |              | 
 ns     | integer          |           | not null | 0                     | plain   |             |              | 
Indexes:
    "history_pkey" PRIMARY KEY, btree (itemid, clock, ns)
    "history_clock_idx" btree (clock DESC)
Triggers:
    ts_insert_blocker BEFORE INSERT ON history FOR EACH ROW EXECUTE FUNCTION _timescaledb_internal.insert_blocker()
Child tables: _timescaledb_internal._hyper_1_1_chunk
Access method: heap

history テーブルがハイパーテーブルに変換されており、チャンク (Child tables) が1つ存在することがわかります。

ヒストリ・トレンドテーブルデータの保存期間や圧縮に関する詳細設定は Web インターフェースの [管理] -> [一般設定] -> [データの保存期間] ページにて設定できます。

timescaledb.sql スクリプトを実行すると、以下のような設定となります。

「アイテムのヒストリの保存期間設定を上書き」と「アイテムのトレンドの保存期間設定を上書き」にチェックが付いている状態になります。この設定により、ヒストリ・トレンドテーブルにて Housekeeper によるチャンクごとの削除処理が有効になります。また、これらにチェックが入っていると、各アイテムで設定したヒストリとトレンドの保存期間を上書きし、すべてのアイテムで共通のヒストリとトレンドの保存期間を設定できます。

ヒストリとトレンドが圧縮されるまでの期間は「次よりも古いものはレコードを圧縮」にて設定できます。7日以上の値を設定する必要があります。

TimescaleDB 利用上の注意点

本節では、Zabbix で TimescaleDB を利用する際の注意点を記載します。

• TimescaleDB は Zabbix プロキシではサポートされていません。
• パーティション化された Housekeeper 処理を利用する場合は、Zabbix サーバで共通のヒストリ・トレンドの保存期間を使用することになるので、アイテム別にヒストリ・トレンドの保存期間を設定できません。
• TimescaleDB の圧縮を利用するには、以下の条件が前提となります。
  • Zabbix 5.0 以降
  • PostgreSQL 10.2 以降
  • TimescaleDB 1.5 以降
• 圧縮したヒストリ・トレンドテーブルのデータは参照処理 (SELECT) はできますが、更新処理 (INSERT、UPDATE、DELETE) はできません。また、圧縮した ヒストリ・トレンドテーブルのスキーマ変更はできません。
• PostgreSQL から TimescaleDB に移行する場合、既存のヒストリ・トレンドテーブルのデータ量が多ければ多いほど、移行に時間がかかります。データの移行を行う前に、サーバに十分な空き領域があることを確認してください。少なくともヒストリ・トレンドテーブルとインデックスの合計サイズの 1.5 倍の空き領域が必要です。また、移行期間中に、Zabbix サーバと Zabbix フロントエンドを停止する必要があります。

おわりに

今回は、Zabbix サーバのバックエンドデータベースとして時系列データベース TimescaleDB を利用する際のメリットや注意点、インストール手順について紹介しました。

TimescaleDB を導入することによって、Housekeeper による負荷の軽減や書き込み性能の向上、ディスク使用量の削減などのメリットを得られます。

既存の PostgreSQL から容易に移行でき、これまで PostgreSQL で利用していたバックアップ、リストアなどの運用方式は TimescaleDB でも利用できるので、PostgreSQL を利用していて性能やディスク使用量を改善したい場合は、TimescaleDB を使うことを検討してみてはいかがでしょうか。

不具合修正

• エスカレーションを削除する際にデッドロックが発生する可能性があった不具合が修正されました。(ZBX-17851)
• log, log.count による監視においてファイルの最終変更時刻を無視するように変更されました。(ZBX-17891)
• MySQL のグローバル変数 auto_increment が Zabbix プロキシに対してのみシャドーイングされるようになりました。(ZBX-17801)

詳細は以下をご覧ください。
https://www.zabbix.com/jp/rn/rn4.4.10

不具合修正

• 埋め込みスクリプトでの 4 バイトの UTF-8 シーケンス処理が修正されました。(ZBX-17227)
• 既存のホストのプロトタイプを更新する際のクエリが失敗する不具合が修正されました。(ZBX-17662)
• trends と trends_uint の TimescaleDB のチャンク間隔が 1 ヶ月に拡張されました。(ZBX-16347)
• JavaScript の前保存処理で出力変数の初期化を行う際に、誤ったメモリ割り当ての警告が発生しないように修正されました。(ZBX-17747)
• MySQL のグローバル変数 auto_increment がシャドーイングされるようになりました。(ZBX-15484)
• 1 度に 2 回の SNMP チェックが行われていたため、unreachable poller のビジー率が高騰する不具合が修正されました。(ZBX-17607)
• ユーザメディアのポップアップのマークアップが修正されました。(ZBX-17629)
• Zabbix agent 2 の web.page.get、web.page、web.page.regexp キーでサーバの証明書チェーンとホスト名を検証しないように修正されました。(ZBX-17733)
• エージェントリクエストのパラメータタイプの解析が修正されました。(ZBX-17109)
• 一部のページでフィルタの要素がフォーカスされない不具合が修正されました。(ZBX-17470)
• DebugLevel=0 の場合のログレベルチェックが修正されました。(ZBX-17550)
• 正規表現の保存前処理でサーバがクラッシュする不具合が修正されました。(ZBX-17691)
• LLD 中に計算アイテムの式を更新できない場合に表示される紛らわしいエラーが修正されました。(ZBX-17445)

機能追加・改良

• 設定キャッシュの最大サイズの制限が 64 GB に拡張されました。(ZBXNEXT-5922)

詳細は以下をご覧ください。
https://www.zabbix.com/jp/rn/rn4.4.9

不具合修正

• haproxy.version の保存前処理が変更され、ディスカバリールールが http と tcp サービスに分割されました。(ZBX-17571)
• 時間選択ボタンの状態が修正されました。(ZBX-17524)
• ユーザ定義マクロに関連する API メソッド のバリデーションが修正されました。(ZBX-17496)
• クエリ文字列による CSS ファイルとスプライト画像のバージョニングが追加しました。(ZBX-17532)
• ブラウザの自動補完とマルチセレクトのサジェストが重なってしまう不具合が修正されました。(ZBX-17501)
• 検索フィールドの値が誤って小文字に変換されてしまう不具合が修正されました。(ZBX-17402)
• vfs.fs.inode を呼び出し時に、プロセスがクラッシュする不具合が修正されました。(ZBX-17505)
• Zabbix プロキシ経由で監視されている TLS 証明書による暗号化が設定されたホストのメタデータ、IP、ポートの更新が修正されました。(ZBX-17412)
• Windows での zabbix_agent2 のコンパイルエラーが修正されました。(ZBX-17558)
• ローカライズされた Windows システムでの組み込みカウンタインデックスの書き換えが修正されました。(ZBX-17140)
• curl_easy_setopt の戻り値のチェックが修正されました。(ZBX-16959)
• 「最新データ」のヒストリページにおける「リセット」ボタンの不具合が修正されました。(ZBX-17423)
• ppc64le アーキテクチャでの Duktape クラッシュが修正されました。(ZBX-17551)
• メタイムアウトを 65 秒に延ばすことによりメディアタイプテストの接続タイムアウト問題が修正されました。(ZBX-16112)
• アクティブチェック中に HostInterfaceItem がリフレッシュされない不具合が修正されました。(ZBX-17377)
• テンプレートのインポート時にテンプレートにリンクしていたアイテムのアプリケーションが削除されていた不具合が修正されました。(ZBX-17395)
• 複数の sortfield が指定されている場合の sortorder の DESC オプションが修正されました。(ZBX-17359)
• zabbix_agent2 が Unix プラットフォームで OpenSSL 1.0.1、1.0.2 を使用できるようになりました。(ZBX-16772)
• zabbix_agent2 の man ページのエラーが修正されました。(ZBX-17500)
• fping 失敗時のエラーメッセージが修正されました。(ZBX-17336)
• 「レポート」-「障害発生数上位100項目」ページにおけるフィルタの不具合が修正されました。(ZBX-17427)
• 「障害」ページを CSV ファイルにエクスポートする際に空白セルがスキップされる不具合が修正されました。(ZBX-17428)
• web.page.regexp キーの length パラメータの不具合が修正されました。(ZBX-17461)
• 「Template DB MySQL by Zabbix agent」における説明が修正されました。(ZBX-17457)
• Oracle データベースのエンコーディングチェックのエラーが修正されました。(ZBX-17508)
• 応答がない場合に、web.page.get がタイムアウトするように修正されました。(ZBX-17442)
• トリガー条件ダイアログで既存の条件式を開く際に負の数値が正しく表示されるように修正されました。(ZBX-17429)
• CurlHttpRequest の GET メソッドでの空のパラメータの処理が修正されました。(ZBX-17518)
• URL バリデータが相対的な URL も受け付けるように修正されました。(ZBX-17012)
• Oracle クエリがマルチステートメントとして解釈されていた不具合が修正されました。(ZBX-17507)
• Zabbix agent 2 の HostMetadataItem と HostInterfaceItem の処理が修正されました。(ZBX-17368)
• メンテナンス更新時のデータベースリクエストが最適化されるようになりました。(ZBX-17275)
• 別のプロセスをフォークしたいくつかのメトリクスを実行する際に Zabbix agent 2 でハングする可能性があった不具合が修正されました。(ZBX-17502)
• {EVENT.OPDATA} マクロで内部イベントをエスカレートするとサーバーがクラッシュする不具合が修正されました。(ZBX-17398)
• DST がサマータイムに変更された場合のメンテナンス計算の誤りが修正されました。(ZBX-9387)
• フィルタにおける最大選択期間のバリデーションが修正されました。(ZBX-17390)

機能追加・改良

• メディアタイプに「Telegram」が追加されました。(ZBXCTR-1)
• ウェブセットアップウィザードで、データベースの接続性テストのためにテーブルを作成したり削除したりしないように変更されました。(ZBXNEXT-4829)
• Webhook に base64 エンコード、デコード機能が追加されました。(ZBXNEXT-5734)

詳細は以下のページをご覧ください。

https://www.zabbix.com/rn/rn4.4.8

インストールおよびアップグレードについて

インストール

詳細はZabbixマニュアル(英語)を参照してください。

アップグレード

Zabbixバイナリを再コンパイルし、フロントエンドのPHPファイルを更新します。Zabbix 1.8.xからの移行の場合はデータベースパッチを実行します。詳細なアップグレード手順についてはZabbixマニュアル(英語)を参照してください。

参考文献

Zabbix 4.4マニュアル(英語)

不具合修正

• Template DB MySQL のアイテム mysql.dbsize が修正されました。(ZBX-17409)
• Windows エージェントのビルドスクリプトが改善されました。(ZBX-17173)
• template.massupdate API によるマクロ更新が修正されました。(ZBX-17425)
• テキストおよびログアイテムの「最新データ」⇒「ヒストリ」ページでフィ
  ルタが設定されていない場合に発生する PHP 7.4 のエラーが修正されました。
  (ZBX-17344)
• 2 の 31 乗 を超えるキーを持つ VMware イベントの読み取りエラーが修正
  されました。(ZBX-17330)
• 「管理」⇒「正規表現」⇒「テスト」タブの未定義のインデックスが修正されました。
  (ZBX-17288)
• go 1.14 での Zabbix agent 2 のビルドが修正されました。(ZBX-17426)
• log* キーに mtime-reread/mtime-noreread オプションパラメーターが追加
  されました。(ZBX-16802)
• 「最新データ」⇒「ヒストリ」ページにおける複数のデータ型の表示が修正
  されました。(ZBX-17350)
• Webhook で {EVENT.VALUE} マクロが適切に展開されない不具合が修正されました。
  (ZBX-17284)
• 一部の複数選択があるページのレイアウトが崩れる不具合が修正されました。
  (ZBX-17027)
• 選択された最大期間のバリデーションが修正されました。(ZBX-17390)
• マクロやタグなどの自動拡張可能なフィールドにスペースを連続で入力でき
  ない不具合が修正されました。(ZBX-17205)
• 汎用ポップアップの到達不能コードの通知が修正されました。(ZBX-17308)
• 失敗したログイン試行回数のメッセージが消えない不具合が修正されました。
  (ZBX-17185)
• マップにおける権限が設定されていないトリガー要素に対する未定義のイン
  デックスが修正されました。(ZBX-17180)
• 複数のホストを更新するときのサーバーとフロントエンド間のデッドロック
  が修正されました。(ZBX-17322)
• profiles テーブルにおいて重複したエントリが書き込まれる不具合が修正
  されました。(ZBX-9057)
• オーバーレイダイアログのインスタンス化が修正されました。(ZBX-17159)
• 内部プロセスの busy 率の計算が改善されました。(ZBX-17108)
• ヒストリページの未定義のインデックスが修正されました。(ZBX-17269)
• value cache が一杯になった際に、メモリ統計および値を多く持つアイテム
  をダンプするようになりました。(ZBX-17342)
• SunOS、Joyent、Solaris でコンパイルする際の int_max エラーが修正されました。
  (ZBX-16926)

機能追加・改良

• Zabbix コンポーネント間の通信に対して、ユーザが設定可能な暗号のサポ
  ートが追加されました。(ZBXNEXT-3604)
• JsonPath に名前参照 (‘~’ サフィックス) のサポートが追加されました。(ZBXNEXT-5649)
• 完全なプラグインインターフェースサポートと詳細なテストオプションを追
  加することにより、Zabbix agent 2 メトリックテスト（-t）およびプリン
  ト（-p）が改善されました。

詳細は以下のページをご覧ください。

https://www.zabbix.com/rn/rn4.4.7

インストールおよびアップグレードについて

インストール

詳細はZabbixマニュアル(英語)を参照してください。

アップグレード

Zabbixバイナリを再コンパイルし、フロントエンドのPHPファイルを更新します。Zabbix 1.8.xからの移行の場合はデータベースパッチを実行します。詳細なアップグレード手順についてはZabbixマニュアル(英語)を参照してください。

参考文献

Zabbix 4.4マニュアル(英語)

不具合修正

• Zabbix プロキシが Zabbix エージェント上でリモートコマンドを実行する際にタイムアウトしないように、また実行結果を待たないように修正されました。(ZBX-17213)
• snmp trapper プロセスの busy 率が 1000％ を超える不具合が修正されました。(ZBX-17201)
• Oracle データベースを使用する場合のサーバー上のプロキシ設定の同期パフォーマンスが改善されました。(ZBX-17121)
• 自然順で Webhook のパラメータをソートするように修正されました。(ZBX-17174)
• いくつかの PHP 7.4 互換性の不具合が修正されました。(ZBX-17220)
• Zabbix agent 2 が解析可能なホストが修正されました。(ZBX-17050)
• アイテムとアプリケーションの両方が検出されなくなったときに、アプリケーションがアイテムから解除される不具合が修正されました。(ZBX-16827)
• 有効な内部アクションがない場合、内部イベントが作成されないように修正されました。(ZBX-17035)
• テンプレートのリンクを作成/削除の実行内容の実行順序が修正されました。(ZBX-16965)
• tls_accept タグに対する XML 変換チェーンにおける誤ったバリデーションが修正されました。(ZBX-17165)

機能追加・改良

• discord メディアタイプが追加されました。(ZBXNEXT-5660)
• データベースのキャラクタセットをチェックする機能が追加されました。(ZBXNEXT-5603, ZBXNEXT-5626)
• 「Template DB MySQL by ODBC」が追加されました。(ZBXNEXT-5659)
• libssh のサポートが追加されました。(ZBXNEXT-5690)
• Zabbix agent 2 に HostInterface および HostInterfaceItem の設定パラメータのサポートが追加されました。(ZBXNEXT-5646)
• libxml2 を使用してビルドする際に xml2-config を pkg-config に置換するようになりました。(ZBXNEXT-5706)

https://www.zabbix.com/rn/rn4.4.6

インストールおよびアップグレードについて

インストール

詳細はZabbixマニュアル(英語)を参照してください。

アップグレード

Zabbixバイナリを再コンパイルし、フロントエンドのPHPファイルを更新します。Zabbix 1.8.xからの移行の場合はデータベースパッチを実行します。詳細なアップグレード手順についてはZabbixマニュアル(英語)を参照してください。

参考文献

Zabbix 4.4マニュアル(英語)

1. 構成

本記事では以下の構成でインストールを行います。

• CentOS 8.1 (1911)
• Zabbix 4.4.5
• Apache httpd 2.4.37 (OS同梱パッケージ)
• PostgreSQL 10.6 (OS同梱パッケージ)
• ZabbixJavaGateway (JMX監視モジュール)
• SNMPTT (SNMPTRAP監視モジュール) ※

※ SNMPTT は RHEL/CentOS 8向けパッケージが提供されていないため、 RHEL 7向けパッケージを流用します。

2. 構築の流れ

本記事ではRPMパッケージを使用して、以下の手順でインストールを行います。

1. パッケージのインストール
2. データベース作成
3. 設定ファイルの編集
4. Zabbixサーバ、エージェント、その他サービスの起動
5. Webフロントエンドから初期設定

3. インストール前の準備

SELinuxが有効になっている場合はdisabledもしくはpermissiveにします。また、firewalldの設定でZabbixサーバへの80、10051番ポートへのアクセスを許可しておきます。

4. パッケージのインストール

Zabbix本体および依存パッケージを各RPMリポジトリからyumコマンドでインストールします。本記事では以下のリポジトリを使用します。

• repo.zabbix.com (Zabbix公式リポジトリ)
• EPEL (RHEL向け拡張パッケージ)

4.1 PostgreSQL のインストール

OSに標準で含まれるPostgreSQL 10.6をインストールします。

# dnf -y install postgresql postgresql-server

4.2 Zabbix のインストール

Zabbixサーバ、Webフロントエンド、Zabbixエージェント、ZabbixJavaGatewayをインストールします。

なお、RHEL/CentOS 8.1ではzabbix-server-pgsqlパッケージが依存しているlibssh2パッケージがリポジトリから削除されているため、インストールに失敗します。このため、libssh2のみRHEL/CentOS 8.0のリポジトリからrpmをインストールしておく必要があります。

# rpm -Uvh http://mirror.centos.org/centos/8.0.1905/AppStream/x86_64/os/Packages/libssh2-1.8.0-8.module_el8.0.0+189+f9babebb.1.x86_64.rpm
# rpm -Uvh https://repo.zabbix.com/zabbix/4.4/rhel/8/x86_64/zabbix-release-4.4-1.el8.noarch.rpm
# dnf clean all
# dnf -y install zabbix-server-pgsql zabbix-web-pgsql zabbix-web-japanese zabbix-apache-conf zabbix-agent
# dnf -y install zabbix-java-gateway

4.3 SNMPTT のインストール

RHEL/CentOS 7.x までの場合はEPELリポジトリのSNMPTTパッケージを利用していました。しかし、現時点では RHEL/CentOS 8 用 EPEL リポジトリには SNMPTT パッケージは含まれていません。このため、暫定的に RHEL/CentOS 7.x 向けの SNMPTT パッケージを使用してインストールを行います。

また、RHEL/CentOS 8からnet-snmp-perlパッケージがリポジトリから削除されたため、net-snmp-perlを利用する機能は使用できないためご注意ください(※必要な場合は net-snmp の SRPM パッケージから rpm をビルドすることが可能です)。

最初にRHEL/CentOS 8向けEPELリポジトリを有効にします。

# rpm -Uvh https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm

CentOSのPowerToolsリポジトリに含まれるperl-Digest-SHA1およびperl-IO-stringyが必要となるため、PowerToolsリポジトリを有効にしてsnmpttパッケージのインストールを行います。

# dnf --enablerepo=PowerTools -y install https://dl.fedoraproject.org/pub/epel/7/x86_64/Packages/s/snmptt-1.4-0.9.beta2.el7.noarch.rpm

(注) RHEL 8.xの場合は上記のパッケージはCodeReady Linux Builder for x86_64 (codeready-builder-for-rhel-8-x86_64-rpms)リポジトリに含まれるため、以下のようにしてリポジトリを有効にしてください。

# subscription-manager repos --enable=codeready-builder-for-rhel-8-x86_64-rpms
# dnf -y install https://dl.fedoraproject.org/pub/epel/7/x86_64/Packages/s/snmptt-1.4-0.9.beta2.el7.noarch.rpm

あわせてnet-snmp、net-snmp-utilsおよびperl-Sys-Syslogパッケージをインストールします。

# dnf -y install net-snmp net-snmp-utils perl-Sys-Syslog

5. データベースの作成

データベースの初期化を行い、Zabbixのデータベースを作成します。

# PGSETUP_INITDB_OPTIONS="-E utf8 --no-locale" /usr/bin/postgresql-setup --initdb
* Initializing database in '/var/lib/pgsql/data'
* Initialized, logs are in /var/lib/pgsql/initdb_postgresql.log

pg_hba.confを編集し、TCP接続時のパスワード認証を有効にします。

# vi /var/lib/pgsql/data/pg_hba.conf
# IPv4 local connections:
#host    all             all             127.0.0.1/32            ident
host    all             all             127.0.0.1/32            md5
# IPv6 local connections:
#host    all             all             ::1/128                 ident
host    all             all             ::1/128                 md5

PostgreSQLを起動し、ユーザおよびデータベースを作成します。

# systemctl start postgresql

# sudo -u postgres createuser --pwprompt zabbix
Enter password for new role:
Enter it again:
# sudo -u postgres createdb -O zabbix zabbix

# zcat /usr/share/doc/zabbix-server-pgsql*/create.sql.gz | sudo -u zabbix psql zabbix

6. Zabbixサーバ設定

ZabbixサーバのDB設定、ZabbixJavaGateway、Zabbixエージェント、フロントエンドのタイムゾーン、およびSNMPTTの設定を行います。

# vi /etc/zabbix/zabbix_server.conf
DBName=zabbix
DBUser=zabbix
DBPassword=<パスワード>

JavaGateway=127.0.0.1
JavaGatewayPort=10052
StartJavaPollers=1

SNMPTrapperFile=/var/log/snmptt/snmptt.log
StartSNMPTrapper=1

# vi /etc/zabbix/zabbix_agentd.conf
Server=127.0.0.1
ServerActive=127.0.0.1
Hostname=(Zabbixエージェントのホスト名) ※Zabbixサーバ上のホストの設定と一致させる必要があります

# vi /etc/php-fpm.d/zabbix.conf
php_value[date.timezone] = Asia/Tokyo

6.1 SNMPTTの設定

snmptrapdの起動オプションを変更します。

# vi /etc/sysconfig/snmptrapd
OPTIONS="-m +ALL -Lsd -On"

snmptrapd.confに、受信したSNMPトラップをSNMPTTに送る設定を追加します。

# vi /etc/snmp/snmptrapd.conf
authCommunity   log,execute,net public
traphandle default /usr/sbin/snmptthandler

snmptthandler-embeddedを使用する場合はtraphandleの代わりに以下を追加します。なお、snmptthandler-embeddedを使用する場合はnet-snmp-perlが必要になります。

perl do "/usr/share/snmptt/snmptthandler-embedded"

snmptt.iniを以下のように変更します。

# vi /etc/snmp/snmptt.ini
#mode = standalone
mode = daemon

#net_snmp_perl_enable = 0
(net-snmp-perlを使用する場合のみ) net_snmp_perl_enable = 1

#net_snmp_perl_best_guess = 0
(net-snmp-perlを使用する場合のみ) net_snmp_perl_best_guess = 2

#sleep = 5
sleep = 1

snmptt.conf に下記を記述すると、すべてのSNMPトラップを「Unknown trap」として受け取り、snmptt.logファイルに出力します。実際には監視したいトラップのOIDごとに設定を行います。

# vi /etc/snmp/snmptt.conf
EVENT general .* "Unknown trap" Normal
FORMAT ZBXTRAP $aA $ar $*

SNMPTTおよびsnmptrapdの起動および自動起動を有効にします。

# systemctl enable --now snmptt snmptrapd

テストトラップを送信し、snmptt.logログファイルにトラップが出力されることを確認します。

# snmptrap -v 2c -c public 127.0.0.1 '' .1.3.6.1.4.1.8072.9999 .1.3.6.1.4.1.8072.9999 s 'Hello'
# cat /var/log/snmptt/snmptt.log
Tue Feb  4 15:43:56 2020 .1.3.6.1.4.1.8072.9999 Normal "Unknown trap" localhost - ZBXTRAP 127.0.0.1 127.0.0.1 Hello

7. Zabbixサーバの起動

Zabbixサーバおよび必要なその他サービスを起動し、同時に自動起動設定も行います。

# systemctl enable --now zabbix-server zabbix-agent zabbix-java-gateway httpd php-fpm

8. Webフロントエンドの設定

Webブラウザから http://(Zabbixサーバのホスト名orIPアドレス)/zabbix にアクセスし、画面の指示に従って初期設定を行います。アクセスできない場合はSELinuxおよびfirewalldの設定が正しく行われているかを確認してください。

設定完了後表示されるログイン画面で初期管理者ユーザ/パスワード(Admin/zabbix)でログインするとダッシュボード画面が表示されます。

右上のユーザープロファイルアイコンから、UserタブのLanguageを「Japanese (ja_JP)」に変更し、「Update」ボタンをクリックすると表示が日本語に切り替わります。

以上でRHEL/CentOS 8.xへのZabbixサーバのインストールは完了です。

9. おわりに

今回はRHEL/CentOS 8.xへのZabbixサーバのインストールについて解説しました。RHEL/CentOS 8.xはまだリリースされてから日が浅く、廃止されたパッケージなどもあるため、現時点ではやや手順が煩雑になります。これらの課題は今後のZabbixのリリースで解消していくものと思われます。

不具合修正

• メンテナンス期間の every フィールドのバリデーションが修正されました。(ZBX-10240)
• Windows の vfs.file.time のファイル変更時間が修正されました。(ZBX-17164)
• ユーザーがメディアタイプ webhook パラメータ名、スクリプトおよびメニューエントリ名、URL フィールドに空白スペースを入力できるように修正されました。(ZBX-17135)
• メモリリークと誤った型キャストが修正されました。(ZBX-17036)
• SELECT FOR UPDATE のロックを追加することにより、プロトタイプの削除中の SQL エラーが修正されました。(ZBX-16811)
• 属性のディスカバリを使用する場合、abbix Java Gateway に対して属性の一括収集が追加されました。(ZBX-17002)
• Coverity によって報告された Time of check to time of use の問題が修正されました。(ZBX-16960, ZBX-16961, ZBX-16964)
• alert manager のメモリリークが修正されました。(ZBX-17153)
• トリガーのないイベントに対する event.get および problem.get の 「opdata」プロパティが修正されました。(ZBX-16901)
• オーディオがサポートされていないデバイスへの通知の提供が修正されました。(ZBX-16902)
• JsonPath 関数処理のクラッシュが修正されました。(ZBX-17127)
• Oracle データベース使用時の maintenance テーブルのデッドロックが修正されました。(ZBX-17080)
• icmppingloss が最初の 400 ping のレスポンスより後の全てを失敗としてカウントしていた不具合が修正されました。(ZBX-16907)
• 長いパスワードでユーザーを作成するときの不具合が修正されました。(ZBX-17090)
• 値が int32 を超える場合の httpstepid 検証が修正されました。(ZBX-16325)
• 32bit のプラットフォームで Zabbix agent 2 のビルドに失敗する不具合が修正されました。(ZBX-17113)
• Web シナリオのステップでタイムアウトを 0 で設定できる不具合が修正されました。(ZBX-17078)
• 32bit のアーキテクチャにおけるアイテムアプリケーションのディスカバリ中の重複エントリエラーが修正されました。(ZBX-16997)
• SVG グラフウィジェットの設定フォームでのスクロールバーの表示が修正されました。(ZBX-17102)
• メンテナンスで「A non well formed numeric value encountered」エラーが出力される不具合が修正されました。(ZBX-17049)
• グラフ軸に対する検証メッセージが区別できない問題およびオーバライドにおける統合されたグラフの検証メッセージが修正されました。(ZBX-16866)
• DB2 のデータインポートスクリプトが修正されました。(ZBX-16972)
• コードのスペルミスが修正されました。(ZBX-16481)
• 軸ラベル計算の修正が元に戻されました。(ZBX-1977)
• フォームのエラーにより、動的に追加削除できる行で以前の入力が失われる不具合が修正されました。(ZBX-16894)
• 複数選択フォームの下に部分的に表示される aria-live メッセージが修正されました。(ZBX-17019)
• イベント相関関係の条件式における not 演算子が修正されました。(ZBX-16966)

機能追加・改良

• 埋め込み JavaScript テスト用の zabbix_js コマンドラインユーティリティが追加されました。(ZBXNEXT-5671)
• マウントされたファイルシステム情報と関連するメトリックを JSON 形式で収集する新しいキー vfs.fs.get が追加されました。(ZBXNEXT-5490)
• 「Template App Haproxy」 が追加されました。(ZBXNEXT-5636)
• メディア「pagerduty」が追加されました。(ZBXNEXT-5549)
• 「Template DB Redis」 が追加されました。(ZBXNEXT-5472)
• value cache 内の未使用または削除済みアイテム値のハウスキーピングが追加されました。(ZBXNEXT-5239)
• メディア「slack」が追加されました。(ZBXNEXT-5562)
• Agent2 の redis プラグインが追加されました。(ZBXNEXT-5428)
• Agent2 ファイルプラグインに Windows サポートが追加されました。(ZBXNEXT-5680)
• script.get() メソッドに入力パラメーターの厳密な検証が追加されました。(ZBX-3783)
• 複数選択によるテンプレートリンクおよび Ajax によるマクロリストのロードが改良されました。(ZBXNEXT-5473)

https://www.zabbix.com/rn/rn4.4.5

インストールおよびアップグレードについて

インストール

詳細はZabbixマニュアル(英語)を参照してください。

アップグレード

Zabbixバイナリを再コンパイルし、フロントエンドのPHPファイルを更新します。Zabbix 1.8.xからの移行の場合はデータベースパッチを実行します。詳細なアップグレード手順についてはZabbixマニュアル(英語)を参照してください。

参考文献

Zabbix 4.4マニュアル(英語)

不具合修正

• デフォルトのデータベースデータに欠落している webhook パラメーターが追加されました。(ZBXNEXT-5386)
• 出力前の URL 検証が修正されました。(ZBX-17101)
• プラグイン固有のパラメーターが設定されていない場合、Zabbix agent 2 のプラグイン設定が呼び出されない不具合が修正されました。(ZBX-17070)
• Zabbix のデータベースとして PostgreSQL を使用している場合の LLD マクロの置換が修正されました。(ZBX-17062)
• 関数のシグネチャが修正されました。(ZBX-16929)
• 稼働レポートに欠落している GET パラメーターが追加されました。(ZBX-16804)
• 高 DPI モニタでのグラフウィジェットの寸法の不具合が修正されました。(ZBX-16286)
• PHP の Fileinfo 拡張モジュールが存在しない場合に、ユーザープロファイルおよびユーザー編集フォームで発生する致命的な不具合が修正されました。(ZBX-16848)
• ヒストリのプレーンテキスト表示での誤った二重引用符が修正されました。(ZBX-16684)
• インターネット接続が遅い場合のウィジェットの保存が修正されました。(ZBX-16918)
• 大きな ID を持つ HTTP エージェントアイテムの「interfaceid」フィールドの検証が修正されました。(ZBX-16903)
• PHP 7.4 のサポートが修正されました。(ZBX-16751)
• アクションおよびイベント相関関係の実行条件において「タグの値」が「タグ」と表記される不具合が修正されました。(ZBX-16879)
• JSONPath の保存前処理でのコンテキストアウェアな LLD マクロ展開が修正されました。(ZBX-16459)
• テンプレートの一括更新での複数選択ボックスの検索候補が修正されました。(ZBX-16911)
• スタートアップ時にメモリ使用量が多くなる不具合が修正されました。(ZBX-9084)
• Zabbix agent 2 のパッシブチェックのタイムアウトによりプラグインの容量が使い果たされる不具合が修正されました。(ZBX-17058)
• NetBSD でのビルドの失敗が修正されました。(ZBX-16932)
• ウィジェットのポップアップウィンドウとともにリクエストがキャンセルされない不具合が修正されました。(ZBX-15041)
• screen.get API の出力から templateid が削除されました。(ZBX-16111)
• Chrome における Zabbix サーバ停止時に表示される警告メッセージの幅が修正されました。(ZBX-16919)
• グラフウィジェットのスクロールが消える不具合が修正されました。(ZBX-16954)
• ウィジェットの垂直方向の伸縮の不具合が修正されました。(ZBX-16995)
• 「深刻度ごとの障害」ウィジェットでの未定義のオフセットが修正されました。(ZBX-16978)
• アイテムフォームの「データ型」フィールドが読み取り専用の場合に必須としてマークされる不具合が修正されました。(ZBX-16944)
• 利用可能なコンテキストメニューがない場合に、ハンドカーソルを持つイメージマップ要素が修正されました。(ZBX-16912)
• 軸ラベルの計算が修正されました。(ZBX-1977)
• SNMP の OID が長い場合に枠を越えて表示される不具合が修正されました。(ZBX-16877)
• Zabbix Web サイトのリンクが更新されました。(ZBX-17034)
• IE でのマップタイプウィジェットのクリッピングが修正されました。(ZBX-16874)
• メモリリークが修正されました。(ZBX-16915)
• メンテナンス使用時の Zabbix サーバーのパフォーマンスが向上しました。(ZBX-17008)
• ファイルへのエクスポートの失敗時の無限ループが修正されました。(ZBX-16779)
• Template Module HOST-RESOURCES-MIB SNMPv1/2 が CPU、メモリ、ストレージ用の 3 つのサブテンプレートに分割されました。(ZBX-16540)
• グラフウィジェットの複数選択の折りたたみが修正されました。(ZBX-16852)
• textarea の高さの自動調整の動作が修正されました。(ZBX-16649)

機能追加・改良

• Webhook タイプのメディアタイプ「Pushover」が追加されました。(ZBXNEXT-5623)
• Webhook タイプのメディアタイプ「Mattermost」が追加されました。(ZBXNEXT-5591)
• Webhook タイプのメディアタイプ「Opsgenie」が追加されました。(ZBXNEXT-5586)
• Zabbix agent 2 の Windows でのビルドサポートが追加されました。(ZBXNEXT-5609)
• インポートされたテンプレートリンケージの「delete missing」オプションが実装されました。(ZBXNEXT-5271)
• テンプレートの内部バージョンが v0.34 に更新されました。(ZBXNEXT-5600)
• Template Module Windows services by Zabbix agent/Zabbix agent active テンプレートが追加され、Windows 関連のテンプレートの説明の更新および欠落していたユーザマクロの追加が行われました。(ZBXNEXT-5572)

https://www.zabbix.com/rn/rn4.4.4

インストールおよびアップグレードについて

インストール

詳細はZabbixマニュアル(英語)を参照してください。

アップグレード

Zabbixバイナリを再コンパイルし、フロントエンドのPHPファイルを更新します。Zabbix 1.8.xからの移行の場合はデータベースパッチを実行します。詳細なアップグレード手順についてはZabbixマニュアル(英語)を参照してください。

参考文献

Zabbix 4.4マニュアル(英語)

不具合修正

エージェントのメモリリークが修正されました。(ZBX-16988)

https://www.zabbix.com/rn/rn4.4.3

インストールおよびアップグレードについて

インストール

詳細はZabbixマニュアル(英語)を参照してください。

アップグレード

Zabbixバイナリを再コンパイルし、フロントエンドのPHPファイルを更新します。Zabbix 1.8.xからの移行の場合はデータベースパッチを実行します。詳細なアップグレード手順についてはZabbixマニュアル(英語)を参照してください。

参考文献

Zabbix 4.4マニュアル(英語)