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