Sidebar

Zabbix Summit 2022
Register for Zabbix Summit 2022

10 6.0.0へのアップグレードノート

このノートはZabbix 5.4.xからZabbix 6.0.0へのアップグレードのためのものです。
すべてのノートは以下のように分類されています。

  • 重要(Critical) - アップグレードプロセスとZabbixの機能変更に関連する最も重要な情報です。
  • 情報提供(Informational) - Zabbixの機能の変更に関する残りのすべての情報です。

Zabbix 6.0.0は、Zabbix 5.4.0以前のバージョンからアップグレードすることができます。
upgrade procedureセクションをご覧ください。

重要(Critical)

データベース

最適なユーザエクスペリエンスを実現し、最高のZabbixパフォーマンスを保証するために
様々な実運用環境において、いくつかのデータベースがサポートされています。
パフォーマンスを確保するため、一部の旧リリースのデータベースはサポートされなくなりました。
これは主にサービスライフポイントの終わりに近いデータベースバージョン、および
通常のパフォーマンスに支障をきたす可能性のある未解決の問題があるバージョンに適用されます。

Zabbix6.0で公式にサポートしているバージョンの databaseは以下の通りです。

  • MySQL/Percona 8.0.X
  • MariaDB 10.5.X - 10.6.X
  • PostgreSQL 13.X - 14.X
  • Oracle 19c - 21c
  • TimescaleDB 2.0.1-2.3
  • SQLite 3.3.5-3.34.X

デフォルトでは、サポートされていないデータベースのバージョンが検出された場合、Zabbix server と proxyは起動しません。 ただし、推奨はしませんが、server や [proxy] (/manual/appendix/config/zabbix_proxy) の AllowUnsupportedDBVersions 設定パラメータを変更することで、DB バージョンをチェックしないようにすることができます。

プライマリーキー

新規インストール時に、履歴テーブルを含むすべてのテーブルでプライマリーキーを使用するようになりました。

既存環境への主キーの自動アップグレードはありません。
履歴テーブルを主キーに 手動でアップグレードする方法については以下のリンクを参照してください。

MySQL/MariaDB
PostgreSQL
TimescaleDB v1 and v2
Oracle

PCRE2 のサポート

PCRE2のサポートが追加されました。PCREは引き続きサポートされていますが、
ZabbixはPCREまたはPCRE2のどちらかのライブラリを使ってのみコンパイルすることができ、両方を同時に使用することはできません。

以下のZabbixインストールパッケージが更新され、PCRE2が使用できるようになりました。
- RHEL/CentOS 7 and newer - SLES (all versions) - Debian 9 and newer - Ubuntu 16.04 and newer

PCRE2に移行した後、いくつかの正規表現を更新する必要があることに注意してください。
特に、 ^[\w-\.]^[-\\w\\.] に変更しないと正常に動作しないことがあります。
Known issues に詳細な説明があります。

ODBCチェックの分離処理

ODBCチェックの処理は、通常のポーラプロセスから、独立したserver / proxy プロセスODBCポーラーに移動しました。
この変更により、ポーラプロセスで作成されるデータベースへの接続数を制限することができます。
以前は、ODBCチェックはZabbix agent アイテムやSSHチェックなどでも動作する通常のポーラによって実行されていました。

新しい設定パラメータStartODBCPollersがZabbix serverproxy 設定ファイルに追加されました。

内部項目 zabbix[process,<type>] を使用すると、ODBC ポーラの負荷を監視できます。

監査ログ

Zabbixの監査ログを改善し、監査ログを完全で信頼性の高いものにするために、従来のデータベース構造を変更する必要がありました。
アップグレードにより、DBテーブル auditlogauditlog_details は新しいフォーマットテーブルに置き換えられ、
古い監査記録は保存されません

新しい section Administration→General メニューに Audit log が追加され、監査ログの有効化(デフォルト)または無効化ができるようになりました。
監査に関するハウスキーピング設定は、これまでHousekeeperメニューセクションにありましたが、
新しいAudit_logメニューに移動されました。既存のハウスキーピングの設定は保存されます。

API変更点

Zabbix 6.0.0 の API changesの一覧を参照してください。

シンプルマクロを式マクロに置き換える

シンプルマクロの機能を式マクロに移行transferredしました。既存のシンプルマクロは、バージョンアップ時に式マクロに変換されます。
長さの制限により変換できないマクロは変換されず、警告がログファイルに警告が出力されます。

マクロ

位置指定マクロはサポートされなくなりました

アイテム名の位置指定マクロ($1, $2...$9)のサポートはZabbix 4.0から非推奨となり、完全に削除されました。

アイテム名のユーザーマクロはサポートされなくなりました。

Zabbix 4.0から非推奨となっていたアイテム名(ディスカバリールール名を含む)のユーザーマクロのサポートは、完全に廃止されました。

Monitoring → Overview を削除

Monitoring メニューの Overview セクションが完全に削除されました。
同じ機能は、Data overviewTrigger overview のダッシュボードを使用してアクセスすることができます。
widgets を参照してください。

継承されたトリガーの依存関係を変更することはできません

テンプレートから継承されたトリガーの依存関係を変更することはできなくなりました。
これは、テンプレートトリガーの依存関係を更新すると、継承されたトリガーの依存関係も上書きされるためです。
したがって、トリガーの依存関係は常にルートテンプレートレベルでのみ設定する方がより確実です。

情報提供 (Informational)

履歴/トレンドの非推奨内部item

以下の内部itemは非推奨となり、将来のメジャーリリースで削除される予定です。

  • zabbix[history]
  • zabbix[history_log]
  • zabbix[history_str]
  • zabbix[history_text]
  • zabbix[history_uint]
  • zabbix[trends]
  • zabbix[trends_uint]
Zabbix agent 2 プラグイン

Zabbix agent 2プラグインに、個別のconfiguration fileが追加されました。
デフォルトでは、これらのファイルは ./zabbix_agent2.d/plugins.d/ ディレクトリに配置されます。
このパスは、agent 2 設定ファイルの Include パラメータで指定し、 zabbix_agent2.conf またはzabbix_agent2.win.confファイルの場所を指定します。

ユーザーパスワード

従来は、ユーザー設定フォームとログインフォームの両方で、ユーザーパスワードのスペースが自動的に切り取られていました。
設定可能なpassword complexity requirements が導入されたため、 パスワードのスペースが削除されなくなりました。
パスワードにスペースが含まれていると考えていたユーザーは、通常通りログインすることができなくなり
スペースを除いた「古い」パスワードを入力しなければならなくなります。
引き続きパスワードの再作成が必要です。

Prometheus メトリクスの一括処理

Prometheusメトリクスの前処理キューに、依存項目の一括処理が導入されたため、依存項目が並列処理されなくなり
処理速度に影響が出る可能性があります。

ランタイムコマンドの転送

Zabbixサーバとプロキシのランタイムコマンドは、Unixシグナルではなく、ソケット経由で発行されるようになりました。
この変更により、ランタイムコントロールオプションの操作性が向上しました。
- コマンド実行の結果がコンソールに表示されるようになりました。 - ノード番号の代わりにHAノード名など、より長い入力パラメータを送信できるようになりました。

お気に入りカスタムグラフに対応しなくなりました

Monitoring -> Hosts -> Graphs でカスタムグラフをお気に入りに追加することができなくなります。 アップグレード後、既存のカスタムグラフはすべてお気に入りから削除されます。

サービス監視

サービス監視機能に関連するいくつかのメジャーアップデートが行われました。
既存のサービスツリー構成は、アップグレード中に以下のように変更されます。

  • 問題とサービスの間のトリガーベースの依存関係は、サービスと問題のタグベースのマッピングに置き換えられます。
    サービスにリンクされたトリガーには、新しいタグ ServiceLink : <trigger ID>:<trigger name> (タグ値は 32 文字に切り詰められます) が設定されます。
    リンクされたサービスには、同じproblem tagが付けられます。

  • ハード依存とソフト依存は、もはや存在しません。その代わり、1つのサービスは複数の親サービスを持つことになります。

  • 'Status calculation algorithm' が、以下のルールでバージョンアップされます。

    • 計算しない → ステータスをOKにする
    • 子ノードのうち1つでも問題があれば問題あり → 子ノードのうち最も重要なもの
    • すべての子ノードに問題がある場合、問題あり → すべての子ノードに問題がある場合、最もクリティカルになる
  • SLAはもはやサービス属性ではなく、複数のサービスに割り当てることができる別個のエンティティです。
    アップグレードの際、同一のSLAがグループ化され、各グループに1つのSLAが作成されます。
    サービスには、マッチング用に新しいservice tag SLA:<ID> が付与されます。

こちらもご参照ください。