このページで

7.4.x のアップグレードに関する注意事項

このページでは、Zabbix メジャーバージョンのマイナーリリースに関するアップグレードの注意事項をまとめています。

メジャーバージョンのアップグレードに関する注意事項も参照してください。

7.4.16へのアップグレードに関する注意事項

SAML署名をデフォルトで有効化

セキュリティを強化するため、ユーザー > 認証 でSAML認証を設定する際、すべてのSAML署名オプション（メッセージ、アサーション、AuthNリクエスト、ログアウトリクエスト、ログアウトレスポンス）がデフォルトで有効になりました。 その結果、署名オプションを無効にしない限り、新しいSAML設定ではSP秘密鍵とSP証明書が必須になりました。

既存のSAML設定は、アップグレードの影響を受けません。

7.4.15へのアップグレードに関する注意事項

Logbackライブラリの最小バージョン

Logbackライブラリの最小バージョンが1.5.16から1.5.25に引き上げられました。

HTTPベースのテンプレートとメディアタイプのTLS検証

HTTPSエンドポイントに接続するテンプレートとメディアタイプでは、デフォルトでエンドポイントのTLS証明書を検証するようになりました。

この変更は、すべてのクラウドおよびAPI監視テンプレート（Cloudflare by HTTP、Kubernetes nodes by HTTP など）と、すべてのwebhookメディアタイプ（Slack、Jira、Telegram など）に適用されます。 これらのテンプレートとメディアタイプに追加された新しい {$HTTP.TLS.VERIFY} ユーザーマクロで、この動作を変更できます。 検証を無効にするにはマクロの値を none に設定し、証明書チェーンと有効期限のみを検証するには peer に設定し、完全な検証を行うには full に設定します。 詳細については、各HTTPテンプレートまたはwebhookのREADMEファイルを参照してください。

Zabbixをアップグレードしても、テンプレートとメディアタイプは自動的にアップグレードされません。 これは、ユーザーが行ったカスタム変更が上書きされるのを防ぐためです。 テンプレートとメディアタイプを手動でアップグレードまたは追加するには、テンプレートのアップグレードの手順を参照してください。

7.4.14へのアップグレードに関する注意事項

このマイナーバージョンには、アップグレードに関する注意事項はありません。

Wildcard matching in user group mapping

In LDAP and SAML user group mapping (including SCIM provisioning), group patterns that contain the * wildcard must now match the entire group name. Previously, such patterns matched if they were found anywhere in the group name. For example, the pattern Zabbix* used to match both Zabbix admins and Old Zabbix users, but now matches only group names that start with Zabbix.

Review your group patterns before upgrading, as users may lose user groups or get a different user role if some of their mappings stop matching. Users whose groups no longer match any mapping are moved to the deprovisioned users group during the next provisioning; new users in this situation are not created and cannot log in. To match a string anywhere in the group name, add * on both sides of it (for example, *Zabbix*).

7.4.13 のアップグレードノート

Zabbix SELinuxポリシーパッケージの変更

AlmaLinux、CentOS Stream、RHEL、Rocky Linux、および Oracle Linux のバージョン 10 では、既存の zabbix-selinux-policy パッケージが zabbix-selinux-policy-main または selinux-policy-targeted-extra のいずれかに依存するようになりました。
既に zabbix-selinux-policy をインストールしている場合、手動での変更は不要です。 パッケージのアップグレード時に、zabbix-selinux-policy-main が自動的にインストールされます。 selinux-policy-targeted-extra がすでにインストールされている場合は、追加のパッケージはインストールされません。

JavaScriptの前処理: 組み込みオブジェクトのメソッドは読み取り専用になりました

前処理 スクリプト内のJavaScript組み込みオブジェクトのメソッドは、読み取り専用になりました。 すでにアイテムの前処理スクリプトでJavaScriptのプロトタイプ上の組み込みメソッドを変更している場合、組み込みのプロトタイプメソッドの変更はもはや許可されないため、問題が発生する可能性があります。

MySQLデータベースの文字セットと照合順序

ZabbixのMySQLデータベースが utf8mb3 文字セットおよび utf8mb3_bin 照合順序で作成されている場合は、Zabbixデータベースの文字セットと照合順序の修復 に記載されている手順に従って、Zabbixをアップグレードする前に utf8mb4 文字セットおよび utf8mb4_bin 照合順序へ変換することを強く推奨します。

7.4.12 のアップグレードノート

複数の IP アドレスを持つホストでのネットワークディスカバリ

ホストが複数の IP アドレスでディスカバリされた場合、network discovery はホストとサービスに正しいステータスを割り当てるようになりました。

7.4.11 のアップグレードノート

LLDマクロのLLDルールオーバーライドでのサポートを復元

低レベルディスカバリルールのオーバーライド操作を設定する際に、アイテムプロトタイプのパラメーター Update interval、History、Trends で再びLLDマクロを使用できるようになりました。

7.4.10 のアップグレードノート

VMwareアラームアイテムがエンティティ詳細を返す

vmware.*.alarms.get[] アイテムが返すJSONには、各アラームごとに entity オブジェクトが含まれるようになりました。
このオブジェクトは、影響を受けるエンティティのID、UUID、およびタイプ（ホスト、仮想マシン、またはデータストア）を返します。

VMwareアラームアイテムの出力を解析するスクリプトを使用している場合は、追加されたフィールドに対応するよう更新が必要になることがあります。

更新された Duo Universal PHP ライブラリ

Duo Universal PHP ライブラリ（Zabbix に付属しています）(supplied) が、バージョン 1.1.1 から 1.1.2 に更新されました。

7.4.9 のアップグレードに関する注意事項

このマイナーバージョンには、アップグレードに関する注意事項はありません。

7.4.8へのアップグレードに関する注意事項

iframeを使用してHTMLとして表示されるアイテム値

アイテム履歴ウィジェット内のアイテムデータは、HTML形式のテキストとして表示される場合、iframe内に分離されるようになりました。

更新されたSAML PHP Toolkitライブラリ

SAML PHP Toolkitライブラリ（Zabbixに同梱）が、バージョン4.0.0から4.3.1に更新されました。

7.4.7 のアップグレードノート

更新された Duo Universal PHP ライブラリ

Duo Universal PHP ライブラリ（Zabbix に 同梱）が、バージョン 1.0.2 から 1.1.1 に更新されました。

最小サポート対象の Go バージョン

最小サポート対象の Go バージョンが 1.24 から 1.25 に引き上げられました。

以前に Go バージョン 1.25 より古いバージョンを使用して Zabbix エージェント 2、エージェント 2 の ロード可能プラグイン、または web service をソースからビルドしていた場合は、最新のセキュリティ更新とバグ修正を受け取るために、サポート対象の Go バージョン を使用してこれらのコンポーネントを再ビルドすることを推奨します。
古い Go バージョンでビルドされたコンポーネントは引き続き動作しますが、アップグレード するには、より新しい Go 環境が必要になります。

7.4.6へのアップグレードに関する注意事項

ログファイルの制限された権限

Zabbix コンポーネントのログファイルは、現在、ファイル所有者のみが読み書き可能な権限で作成されます。
さらに、ファイルは所有者グループによって読み取り可能です。
その他の権限はすべて拒否されます。

Linux では、この変更により権限は 0666 から 0640 に変更されます。
この変更は、Zabbix サーバー、プロキシ、およびエージェントのログファイルに影響します。
Zabbix エージェント 2 のログファイルの権限は、0644 から 0640 に更新されました（その他のユーザーに対する読み取り権限を削除）。

さらに、いくつかのその他のファイルも 0640 の権限で作成されるようになりました。

Zabbixエージェント 2 が処理する MySQL レプリケーションステータスのクエリ

Zabbixエージェント 2 の MySQLプラグイン は、SHOW SLAVE STATUS と SHOW REPLICA STATUS の両方をサポートするようになりました。 このプラグインは、サーバーのバージョンに応じて適切なステートメントを自動的に選択して実行し、通常のJSON形式で結果を返します。

mysql.replication.discovery や mysql.replication.get_slave_status などのエージェント 2 アイテムは、SHOW SLAVE STATUS または SHOW REPLICA STATUS のいずれかを使用するサーバーで動作します。 既存のエージェント 2 アイテムやエージェント 2 テンプレートを変更する必要はありません。

サポートされるGoの最小バージョン

サポートされるGoの最小バージョンが、1.23から1.24.10に引き上げられました。

以前に、1.24.10より古いGoバージョンを使用してソースからZabbix エージェント 2、エージェント 2のロード可能なプラグイン、またはWebサービスをビルドしていた場合は、最新のセキュリティ更新とバグ修正を受け取るために、サポートされるGoバージョンを使用してこれらのコンポーネントを再ビルドすることを推奨します。 古いGoバージョンでビルドされたコンポーネントも引き続き動作しますが、それらをアップグレードするには、より新しいGo環境が必要になります。

Webサービス設定にファイルまたはフォルダーを含める

Zabbix Webサービス設定ファイルにIncludeパラメータが追加されました。 このパラメータを使用すると、個別のファイルまたはディレクトリ内のすべてのファイルを設定に含めることができます。

Zabbix Agent 2 Oracleプラグインでのアイテムごとのタイムアウトのサポート

Oracleプラグイン設定ファイルのPlugins.Oracle.CallTimeoutパラメータは、効果を持たなくなりました。 最大待機時間は、アイテムのタイムアウトによって決定されるようになりました。

7.4.5 のアップグレードに関する注意事項

このマイナーバージョンには、アップグレードに関する注意事項はありません。

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

注意! グラフとZabbixエージェント2のMySQLプラグインに関連するエラーのため、このバージョンへのアップグレードはお勧めできません。

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

PHP cURLの最小バージョン

PHP拡張機能cURLの最小サポートバージョンは7.19.4 になりました。

7.4.1 のアップグレードノート

エージェント2ランタイム制御出力ストリーム

Zabbixエージェント2のランタイム制御コマンド(zabbix_agent2 -R <option>)は、出力をstderr(標準エラー)ではなくstdout(標準出力)に書き込むようになりました。以前の動作に依存しているスクリプトは更新してください。