10 6.0.0へアップグレード時の注意点

Zabbix 5.4.xからZabbix 6.0.0へのアップグレードに関する注意点です。 すべての注意点は以下のように分類されています。

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

Zabbix 6.0.0は、Zabbix 5.4.0以前のバージョンからアップグレードすることができます。 以前のZabbixバージョンからのアップグレードに関するすべての情報については、アップグレード手順セクションをご覧ください。

重要(Critical)

MySQL/MariaDBでZabbixサーバーのアップグレードを正常に完了するには、バイナリロギングが有効で、スーパーユーザー権限がなく、MySQL構成ファイルにlog_bin_trust_function_creators = 1が設定されていない場合、MySQLでGLOBAL log_bin_trust_function_creators = 1を設定する必要がある場合があります。

MySQLコンソールを使用して変数を設定するには、次を実行します。

mysql> SET GLOBAL log_bin_trust_function_creators = 1;

アップグレードが正常に完了したら、このオプションを無効にすることができます。

mysql> SET GLOBAL log_bin_trust_function_creators = 0;

データベース

最適なユーザーエクスペリエンスを実現し、さまざまな運用環境で最高のZabbixパフォーマンスを確保するために、一部の古いデータベースリリースのサポートが終了しました。 これは主に、サービス終了点が近づいているデータベース バージョンと、通常のパフォーマンスを妨げる可能性がある未修正の問題があるバージョンに適用されます。

Zabbix 6.0以降、次のデータベースバージョンが正式にサポートされるようになりました。

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

デフォルトでは、サポートされていないデータベースバージョンが検出された場合、Zabbixサーバーとプロキシは起動しません。 推奨はされませんが、サーバーまたはプロキシのAllowUnsupportedDBVersions設定値を変更することで、DBバージョンチェックをオフにできるようになりました。

プライマリーキー

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

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

MySQL/MariaDB
PostgreSQL
TimescaleDB v1 and v2
Oracle

PCRE2のサポート

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

以下のZabbixのインストールパッケージが更新され、PCRE2が使用できるようになりました：

• RHEL 7以降
• SLES (すべてのバージョン)
• Debian 9以降
• Ubuntu 16.04以降

PCRE2に移行後、いくつかの正規表現を更新する必要があることに注意してください。特にパターン ^[\w-\.] は ^[-\\w\\.] に変更しないと正常に機能しません - 詳細は既知の問題点を確認してください。

ODBCチェックの分離処理

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

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

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

監査ログ

Zabbixの監査ログを改善し、監査ログを完全で信頼性の高いものにするために、従来のデータベース構造を変更する必要がありました。
アップグレードにより、DBテーブル auditlog と auditlog_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 overview と Trigger 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文字に切り詰められます)。リンクされたサービスも同じ問題タグが設定されます。

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

• 'ステータス計算アルゴリズム'は、次のルールを使用してアップグレードされます。

  • 計算しない → ステータスをOKにする
  • 子ノードのうち1つでも障害があれば、障害 → 子ノードのうち最も重大なもの
  • 子ノード全てに障害があれば、障害 → 全ての子ノードが持っている最も重大なもの

• SLAはサービス属性ではなくなり、複数のサービスに割り当てることができる別個のエンティティになりました。 アップグレード中に、同一のSLAがグループ化され、各グループごとに1つのSLAが作成されます。サービスには、マッチング用に新しいサービスタグ SLA:<ID> が付与されます。

参照 :

• サービス監視アップグレードの詳細
• サービスの設定