デプロイメント設定

デプロイメント設定ページでは、EMQX Cloudデプロイメントのデプロイメント情報、クラウドの詳細、MQTTプロトコルの動作など、主要な設定の閲覧および構成が可能です。

このページは、デプロイメントの左側ナビゲーションパネルのデプロイメント設定からアクセスできます。

概要

デプロイメント設定ページには、以下の2つのタブがあります。

• 一般設定：デプロイメントの詳細、請求情報、クラウドプラットフォームの設定を表示します。

• MQTT設定：パケットサイズ、共有サブスクリプション戦略、セッション動作、フラッピング検出など、MQTTパラメータを構成します。

一般設定

一般設定タブでは、デプロイメント情報とクラウド環境の概要を確認でき、プランや請求の管理オプションも提供します。

デプロイメント情報

このセクションでは、デプロイメントの基本情報を表示します。

項目	説明
デプロイメント名	デプロイメントの名前です。編集アイコンをクリックして直接編集、またはコピーアイコンでコピーできます。
デプロイメントID	デプロイメントの一意の識別子です。サポートへの問い合わせやAPI利用時に必要に応じてコピーアイコンでコピーできます。
プラン	現在のデプロイメントプラン（例：Dedicated FlexやServerless）です。
EMQXバージョン	現在デプロイメントで稼働しているEMQXのバージョンです。
ティア	最大サポートセッション数およびメッセージスループット（TPS）を示す現在のパフォーマンスティアです。対応するDedicated Flexデプロイメントでは、Change Tierをクリックして容量を変更できます。Oracle Cloud上のデプロイメントではティア変更はできません。詳細はChange Deployment Tierを参照してください。
請求方法	現在の請求方法（例：従量課金）です。年間契約やカスタム価格についてはEMQにお問い合わせください。
操作保護	操作保護が有効か無効かを示します。Oracle Cloud上のデプロイメントでは操作保護は利用できません。詳細は操作保護を参照してください。

ヒント: 専用容量や割引についてはEMQ営業担当にお問い合わせください。

操作保護

操作保護はOracle Cloud上のデプロイメントでは利用できません。

操作保護は、誤ってデプロイメントを削除、停止、スケール操作することを防止します。有効化されている場合、これらの操作は手動で保護を解除するまでブロックされます。

操作保護はデプロイメント作成時には無効で、90日間デプロイメントに書き込み操作が行われなかった場合に自動的に有効化されます。

注意

デプロイメントの状態や設定を変更する操作（名前変更、スケール、停止、アップグレードなど）は90日タイマーをリセットします。メトリクスやログ、設定の閲覧などの読み取り専用操作はリセットしません。

操作保護を無効にするには、一般設定タブの操作保護項目の横にある無効化をクリックしてください。

クラウド情報

このセクションでは、デプロイメントがホストされているクラウドインフラの情報を表示します。

項目	説明
クラウドプラットフォーム	デプロイメントをホストしているクラウドサービスプロバイダー（例：AWS、Azure、Google Cloud）です。
リージョン	クラウドインスタンスの地理的リージョン（例：N. Virginia (us-east-1)）です。

デプロイメントの削除

デプロイメントを完全に削除するには、ページ下部のデプロイメントの削除をクリックします。削除すると、関連するすべてのデータと設定が消去されます。

注意

この操作は取り消せません。詳細はデプロイメントの削除を参照してください。

MQTT設定

注意

MQTT設定タブは、EMQX 5.10.3以降を実行するDedicatedおよびDedicated Flexデプロイメントで利用可能です。このタブが表示されない場合は、チケットを提出してデプロイメントでの利用可否を確認してください。

MQTT設定タブでは、アプリケーションの要件に合わせてMQTTプロトコルのパラメータをカスタマイズできます。これらの設定は、EMQX Cloudがクライアントのセッション、サブスクリプション、メッセージ配信、パケット検証をどのように処理するかを制御します。

設定の閲覧や変更にはデプロイメントが稼働中である必要があります。管理者、プロジェクト管理者、プロジェクトユーザーは権限内で設定を変更可能です。読み取り専用ユーザーは設定を閲覧できますが変更はできません。詳細はサブアカウント管理を参照してください。

このタブに表示される設定は、デプロイメントの現在のEMQX構成を反映しています。

基本設定

設定項目	説明
最大パケットサイズ	EMQXが受け入れる最大MQTTパケットサイズを定義します。クライアントがこの制限を超えるパケットを送信した場合、EMQX Cloudはクライアントを切断します。パフォーマンスに影響を与える過大なペイロードを防ぐために使用します。
共有サブスクリプション戦略	EMQX Cloudが共有サブスクリプショングループ内のサブスクライバー間でメッセージをどのように分配するかを決定します。利用可能な戦略は以下の通りです。 random：各メッセージをランダムに選ばれたサブスクライバーに送信します。 round_robin：サブスクライバー間で順番に均等にメッセージを分配します。 round_robin_per_group：各共有サブスクリプショングループ内でラウンドロビン配信を行います。 sticky：同じサブスクライバーに配信を続け、そのサブスクライバーが切断されるまで維持します。 local：ローカルノードのランダムなサブスクライバーを優先し、いなければクラスター全体からランダムに選択します。 hash_topic：メッセージの送信元トピックのハッシュを使ってサブスクライバーを決定します。 hash_clientid：送信者のクライアントIDのハッシュを使ってサブスクライバーを決定します。この設定は、クラスター環境でのロードバランシングとメッセージ配信の一貫性を最適化します。 共有サブスクリプションの詳細は、EMQX Cloudの共有サブスクリプションおよびMQTT 5.0共有サブスクリプション入門を参照してください。
共有サブスクリプション初期Sticky選択	sticky配信戦略使用時に最初のサブスクライバーを選択する方法を指定します。 選択肢： random：ランダムにサブスクライバーを選択します。 local：ローカルノードのサブスクライバーを優先し、いなければクラスター全体からランダムに選択します。 hash_clientid：パブリッシャーのクライアントIDのハッシュでサブスクライバーを選択します。 hash_topic：パブリッシュ元のトピックのハッシュでサブスクライバーを選択します。 この設定は、共有サブスクリプショングループがアクティブになった際の初期負荷分散動作を決定します。
ピア証明書をユーザー名として使用	クライアントのTLS証明書からMQTTのユーザー名フィールドを抽出する機能を有効にします。証明書ベース認証に有用です。 サポートされる方法： cn：証明書のCommon Name (CN)フィールドを使用。 dn：Distinguished Name (DN)フィールドを使用。 crt：DERまたはPEM証明書の生データを使用。 pem：DERデータをPEM形式に変換して使用。 md5：DERまたはPEM証明書のMD5ハッシュを使用。 TLS接続時のみ有効です。
ピア証明書をクライアントIDとして使用	クライアントのTLS証明書からクライアントIDを導出する機能を有効にします。ユーザー名と同様の方法（cn、dn、crt、pem、md5）がサポートされています。 証明書ベース接続のクライアントIDを安全かつ決定的に生成する方法です。
クライアント属性	接続時にカスタムクライアント属性を初期化する方法を定義します。各属性はclient_attrs.{NAME}として宣言でき、{NAME}はset_as_attr設定フィールドで指定した属性キーです。なお、属性名tnsは内部システム用に予約されており使用できません。 初期化された属性はclient_attrsプロパティに保存され、マウントポイントの動的レンダリングや認証・認可ルールで参照可能です。 クライアント属性の設定と使用方法の詳細はEMQXのクライアント属性を参照してください。

セッション設定

設定項目	説明
セッション有効期限間隔	クライアント切断後にEMQX Cloudがセッションデータを保持する期間を指定します。MQTT 5.0以外の接続にのみ適用されます。オフラインメッセージやサブスクリプションの保持期間を制御するために使用します。
最大インフライト数	アックを待たずに同時に送信可能なQoS 1およびQoS 2メッセージの最大数を定義します。値を大きくするとスループットが向上する可能性がありますが、メモリ使用量も増加します。
最大メッセージキュー長	永続クライアントが切断された場合やインフライトウィンドウが満杯の場合にメッセージをキューイングする最大長を指定します。この制限に達すると古いメッセージから破棄されます。
QoS 0メッセージの保存	オフラインクライアントのQoS 0メッセージをセッション保持中にキューイングするかどうかを制御します。 有効にすると、クライアントがセッションを再開した際にメッセージが配信される可能性があります。 無効にすると、メッセージはキューに追加されず破棄されます。

オフラインのQoS 0メッセージを保存するには、クライアントが切断後もセッションを保持している必要があります。この設定はQoSの配信保証や保持メッセージ、ディスクパーシステンスには影響しません。

キューイングされたメッセージはメモリを消費し、最大メッセージキュー長にカウントされます。QoS 0メッセージ保存を有効にするとメモリ使用量が増加する可能性があります。オフラインセッション数やメッセージの数・サイズを考慮してキュー長制限やセッション保持期間を設定してください。キューが満杯またはセッション期限切れ時にはメッセージが失われることがあります。

フラッピング検出設定

フラッピング検出は、異常に頻繁に切断・再接続を繰り返すクライアントを特定し、一時的に禁止してクラスターへの過負荷を防ぎます。フラッピング検出は常に有効で、無効化できません。閾値のみ調整可能です。

設定項目	説明
最大切断回数	検出時間ウィンドウ内でクライアントが許容される最大切断回数です。この回数を超えると、禁止期間で指定された期間クライアントIDが禁止されます。
検出時間ウィンドウ	切断回数をカウントする時間の長さを指定します。
禁止期間	切断回数の閾値を超えたフラッピングクライアントIDが禁止される期間です。

設定の更新

必要なMQTT設定を変更した後、更新をクリックして保存してください。更新が成功すると、保存した設定がページに反映されていることを確認してください。