Documentation
Table of Contents
10 6.4.0へアップグレード時の注意点
Zabbix 6.2.xからZabbix 6.4.0へのアップグレードに関する注意点です。
すべての注意点は以下のように分類されています。
- 重大な変更 - 既存の環境を壊す可能性のある変更、およびアップグレードプロセスに関連する重要な情報
- その他 - Zabbixの機能の変更に関する残りのすべての情報
参照 :
- Zabbix 6.2.0より前のバージョンからのアップグレードに関する情報は、アップグレード手順を参照してください。
- 高可用性(HA)クラスター内のサーバーのアップグレード手順は、HAクラスターのアップグレードを参照してください。
アップグレードプロセス
MySQL/MariaDBでZabbixサーバーのアップグレードを正常に完了するには、バイナリロギングが有効で、スーパーユーザー権限がなく、MySQL構成ファイルにlog_bin_trust_function_creators = 1が設定されていない場合、MySQLでGLOBAL log_bin_trust_function_creators = 1を設定する必要がある場合があります。
MySQLコンソールを使用して変数を設定するには、次を実行します。
アップグレードが正常に完了したら、このオプションを無効にすることができます。
重大な変更
MySQLバージョン
MySQLの8.0.30より前のバージョンはサポートされなくなりました。MySQLの必須バージョンが8.0.0から8.0.30に上げられました。
libsshバージョン
libsshの必須バージョンが0.6.0から0.9.0に引き上げられました。
SLESバージョン
SUSE Linux Enterprise Server (SLES) 15の、サポートされる最小サービスパックバージョンはSP4になりました。
SP4以降のSLES 12も引き続きサポートされていますが、libsshライブラリが古いため、このOSバージョンのSSHチェックのサポートは中止されました。
最適化されたプロキシ構成の更新
新しいバージョンでは、プロキシ構成の増分更新が導入されました。
その結果、アクティブプロキシのConfigFrequencyパラメータは非推奨になりました。代わりに、ProxyConfigFrequencyパラメーターをサーバー (パッシブプロキシの場合) とプロキシ (アクティブプロキシの場合) の両方で使用する必要があります。 ProxyConfigFrequencyとConfigFrequencyの両方を使用すると、プロキシはエラーを記録して終了することに注意してください。
ProxyConfigFrequencyのデフォルト値が3600秒から10秒に引き下げられました。 また、サーバー上のCacheUpdateFrequencyのデフォルト値が60秒から10秒に引き下げられました。
サーバーは構成キャッシュを使用して、リビジョン番号でプロキシ構成の変更を追跡するようになりました。そのため、キャッシュデータ量が増加し、構成キャッシュのサイズを増やすことが必要になる場合があります。
変更をプロキシに同期する前に、サーバー構成を同期する必要があることに注意してください。 したがって、ユーザーが何らかの変更を加え、それをプロキシに同期したい場合は、最初にサーバー構成キャッシュをリロードする必要があります。
その他
SQLiteを使用したプロキシ上の自動データベースアップグレード
アップグレード後の最初の起動時に、SQLite3を使用したZabbixプロキシは、既存の古いバージョンのデータベースファイルを自動的にダンプし、現在のバージョン用に新しいデータベースファイルを作成するようになりました。 SQLiteデータベースファイルに保存されているヒストリデータは保存されません。 以前は、SQLiteデータベースファイルを手動で再作成する必要がありました。
Zabbixプロキシのバージョンがデータベースファイルのバージョンより古い場合、プロキシはエラーを記録して終了します。
CSRFトークン
CSRF (クロスサイトリクエストフォージェリ) 攻撃に対するセキュリティを強化するために、Zabbixフロントエンドは、静的なセッションベースのトークンの代わりに、ランダムに生成された CSRFトークンを使用するようになりました。 インストールで特定のトークン名をチェックするIDS/IPSを使用している場合、誤検知を回避するために、新しいトークン名 _csrf_token を認識するように構成を更新する必要がある場合があります。
スレッドベースの前処理ワーカー
アイテム値の前処理がスレッドベースの前処理ワーカーを使用するように書き直されたため、Zabbixサーバー/プロキシには新しいライブラリlibevent_pthreadsが必要になります。
ユーザー設定の必須ではないフィールド
ユーザーグループとユーザーロールのフィールドは、ユーザー設定では必須ではなくなりました。 ただし、内部Zabbixユーザーがユーザーロールなしで作成された場合、ユーザーは内部認証を使用してZabbixにログインすることができません。
アクティブチェックの即時更新
以前は、Zabbixエージェント(アクティブモード)は、ZabbixサーバーまたはZabbixプロキシから(デフォルト)2分ごとに設定の完全なコピーを受信していました 。 増分設定同期の導入により、ホストまたはグローバル正規表現に変更がない場合には完全な設定が送信されなくなり、デフォルトの同期間隔が5秒に短縮されました。
Zabbixエージェント設定ファイルでサポートされている'RefreshActiveChecks'パラメータのデフォルト値が120秒から5秒に変更されました。 これにより、特に暗号化が使用されている場合、接続の頻度が増加し、ネットワーク使用量が増加する可能性があります。
アクティブエージェントチェック用のJSONプロトコルが更新され、config_revisionおよびsessionID が含まれるようになりました。 詳細はPassive and active agent checksをご覧ください。
ユーザーマクロ も増分構成同期に影響します。 グローバルマクロを追加、更新、または削除すると、すべてのホストの設定の増分更新が強制されるため、グローバルマクロの代わりにホストマクロを使用することをお勧めします。
ハートビートのサポートは廃止されました
Zabbix 6.4以降、heartbeat senderはプロキシから削除されるため、Zabbixプロキシアイテムzabbix [process,heartbeat sender]はサポートされず、テンプレートから削除されます。 HeartbeatFrequency パラメータは非推奨になりました。
Zabbixサーバーの自動登録ハートビート
Zabbixサーバーのアクティブエージェント自動登録ハートビートは120秒に設定されています (Zabbixプロキシ同様)。 したがって、検出されたホストが削除された場合、自動登録は120秒後に再実行されます。
古い数値タイプ(float)は非推奨になりました
Zabbix 5.0以降、数値データ型(float)は、約15桁の精度と約-1.79E+308 ~ 1.79E+308までの拡張値範囲をサポートする新しい形式に切り替えられました。 現在、無効になっていますがサポートは残っている古い数値型は非推奨となり、次のバージョンで削除される予定です。
インストールが拡張範囲の数値にアップグレードされていない場合、フロントエンドのシステム情報に次の警告が表示されます。"データベースヒストリテーブルがアップグレードされました: いいえ。古い数値型のサポートは廃止されました。拡張範囲の数値にアップグレードしてください。"
この場合、数値の拡張範囲を有効にするための手順を参照してください。
エクスポートから削除された日付
オブジェクト (ホスト、テンプレートなど) をエクスポートする際のエクスポート形式からdate要素が削除されました。
テンプレートのバージョン管理
テンプレートの管理とアップグレードを改善するために、テンプレートのバージョン管理が導入されました。
データ収集 → テンプレートで、テンプレートのベンダーとバージョンを確認したり、ベンダーやバージョンごとにテンプレートをフィルターしたりできるようになりました。
更新されたテンプレートをインポート
Zabbixを以前のバージョンからアップグレードする場合は、テンプレートは手動でアップグレードする必要があることに注意してください。 これは、更新されたテンプレートをインポートすることで実行できます。 更新されたテンプレートは、ダウンロードした最新のZabbixバージョンのzabbix/templatesディレクトリにあります。 データ収集 → テンプレートでは、このディレクトリからそれらをインポートできます。
Zabbixのgitリポジトリから直接テンプレートをダウンロードすることもできます。
カスタムテンプレートのベンダーとバージョンの更新
既存のカスタムテンプレートの場合、テンプレートのベンダーとバージョンは、テンプレートAPIを通じて変更することもできます。