EMQX Cloud V5 から V6 へのアップグレードガイド
EMQX 専用展開ユーザーは、EMQX を V5 から V6 にアップグレードできます。現在の EMQX バージョンを確認するには、展開詳細ページを開き、設定 をクリックして展開情報を表示してください。
EMQX V6 は、V5 のコアアーキテクチャと利用モデルを維持しつつ、ネームスペース、ログトレース、イベント履歴、BigQuery データ統合、Snowflake ストリーミングデータ統合、および MQTT ソース機能を新たに導入または強化しています。詳細は 新機能 をご参照ください。
利用可能性
EMQX V6 は専用および専用フレックスブローカー展開でのみ利用可能です。サーバレス展開では EMQX バージョンの選択はサポートされていません。
アップグレード前の準備
- クライアントで自動再接続が有効になっていることを確認し、アップグレード中の短時間の接続断に備えてください。
- アップグレード前に、接続中のクライアント数、メッセージのパブリッシュおよび配信レート、認証成功率、ルールやデータ統合の状態など、主要なビジネスベースラインを記録してください。これらの値はアップグレード後の比較に使用します。
- アップグレード前に当社の SRE チームが展開状況と特別な設定を確認します。アップグレードに影響を及ぼす可能性がある場合は事前にご連絡いたします。
データ移行および設定の保持
アップグレード中に以下の設定およびデータは保持されます。
- MQTT エンドポイントおよびポート
- 認証および認可設定
- コネクター、ルール、ソース、シンクを含むデータ統合設定
- TLS 証明書情報
- リテインドメッセージ
- NAT ゲートウェイ、内部エンドポイント、PrivateLink、VPC ピアリングを含むネットワーク管理設定
V5 から V6 へのアップグレードは、V4 アップグレードで必要だった大規模な API、認証・認可、データ統合アーキテクチャの互換性作業を必要としません。サポートチケットを通じて設定された特別なパラメーターは、引き続き SRE チームのアップグレード前評価の対象となります。
アップグレードの影響
- アップグレードは 15～25 分程度で完了し、サービスのダウンタイムはありません。
- アップグレードのために 2時間 のメンテナンスウィンドウが設定されます。この期間中のアップグレードによるサービス停止は SLA の可用性計算から除外されます。
- アップグレード中にクライアントは 2～3 回の短い切断を経験する可能性があります。デバイスで自動再接続が有効であれば、通常の利用に影響はありません。
- ご注意：
clean sessionがfalseに設定されている場合、アップグレード後に既存のセッションは破棄されます。セッションを保持する必要がある場合は事前にご連絡ください。
アップグレード後の対応
アップグレード後の検証
- アップグレード後、EMQX Cloud の SRE チームが展開ログとメトリクスを確認します。
- アップグレード前に記録したビジネスベースラインに対して以下の点を重点的に検証してください。
- クライアントが自動的に再接続すること
- クライアントの認証および認可が正常に動作すること
- サブスクリプションが復元され、メッセージのパブリッシュおよび配信が正常に行われること
- ルール、コネクター、ソース、シンクが正常に動作すること
- TLS 接続およびカスタム証明書が正常に動作すること
- 監視メトリクスおよびアラートが期待通りであること
- 問題を発見した場合は、速やかにご連絡ください。
ロールバック
- アップグレード確定前に 24 時間のロールバック期間があり、この期間中は展開を V6 から V5 に戻すことが可能です。
- ロールバックも 15～25 分程度で完了し、サービスのダウンタイムはありません。
- ロールバック中にクライアント接続は 1～2 回切断されます。
- パーシステンスセッション状態は保持できません。クライアントは再接続後に新しいセッションを作成します。
V6 のコア機能
V6 固有の機能
ご注意
以下の機能は EMQX V6 をサポートする専用および専用フレックス展開でのみ利用可能です。実際の利用可否は V6 のマイナーバージョン、リージョン、およびコンソールに表示されるオプションによって異なります。
| V6 固有の機能 | 実用的な価値 |
|---|---|
| ネームスペース | マルチテナントシナリオにおけるリソースと権限の分離を提供します。ルール、コネクター、アクションなどのリソースをテナント、チーム、事業部門ごとに整理でき、テナント間の影響を減らし、共有クラスターでの運用を簡素化します。 |
| ログトレース | 特定のクライアント、トピック、クライアント IP アドレス、またはルール ID に対してデバッグログを収集できます。展開全体の詳細ログを有効にすることなく、対象を絞ったトラブルシューティングに役立ちます。 |
| イベント履歴 | 最近の接続、認証、サブスクリプションイベントを保持し、接続失敗、予期しない切断、認証失敗、サブスクリプションが反映されない問題の診断に利用できます。 |
| BigQuery データ統合 | ルールエンジンと BigQuery シンクを通じて MQTT データを BigQuery に書き込み、SQL 分析やレポートに活用できます。 |
| Snowflake ストリーミングデータ統合 | ルールエンジンと Snowflake ストリーミングシンクを通じて低レイテンシでデータを Snowflake テーブルに書き込みます。 |
ネームスペース
ネームスペースはマルチテナント管理とリソース分離を強化します。管理者はテナント、部門、事業部門ごとにリソース範囲を分割し、各ネームスペース内でルール、コネクター、アクションを独立して管理できます。複数のチームや顧客が一つの展開を共有する場合、ネームスペースは誤操作やテナント間の影響を減らします。
ログトレース
ログトレースは、特定の MQTT クライアント、トピック、クライアント IP アドレス、またはルール ID に対してコンソールからデバッグレベルのログを収集できます。展開全体の詳細ログを有効にするよりも影響範囲が限定され、特定のクライアントやトピック、ルール処理経路に関する問題の再現や診断に適しています。
イベント履歴
イベント履歴は最近のクライアント接続、認証、サブスクリプションイベントを記録します。以下の調査に利用可能です。
- クライアントの接続失敗や予期しない切断
- クライアントの認証失敗
- 作成に失敗した、または反映されないサブスクリプション
- 接続およびサブスクリプションのタイムライン
BigQuery データ統合
ルールエンジンが MQTT メッセージをフィルタリング・処理し、BigQuery シンクが Google BigQuery に書き込みます。この統合は大規模な IoT データの SQL 分析、データウェアハウジング、レポーティングに適しています。
Snowflake ストリーミングデータ統合
Snowflake ストリーミングシンクは MQTT データを低レイテンシで Snowflake テーブルに書き込みます。リアルタイムに近いデータ取り込み、分析、ビジネスインサイトに適しています。
MQTT ソースの強化
V6 の MQTT ソースは重複メッセージを減らす共有サブスクリプショントピックをサポートします。また、MQTT 5.0 のサブスクリプションオプションである No Local や Retain As Published に対応し、リモート MQTT サービスからのデータブリッジ時に柔軟性を向上させています。
アップグレードの確定
アップグレードの時間帯を確定し、関連するビジネスおよび運用担当者がアップグレード中に対応可能な状態であることを確認してください。アップグレードの成功を支援するため、プロセス全体を通じて技術サポートを提供いたします。