デプロイメント設定

デプロイメント設定ページでは、EMQX Cloudデプロイメントの主要な設定（デプロイメント情報、クラウドの詳細、MQTTプロトコルの動作など）を表示および構成できます。

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

概要

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

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

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

  補足

  MQTT設定タブは、Dedicated v5およびDedicated Flexデプロイメントでのみ利用可能です。

一般設定

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

デプロイメント情報

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

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

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

操作保護

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

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

補足

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

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

クラウド情報

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

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

デプロイメントの削除

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

注意

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

MQTT設定

補足

MQTT設定タブはDedicated v5およびDedicated Flexデプロイメントでのみ利用可能です。このオプションが表示されない場合は、チケットを提出してアップグレードについてお問い合わせください。

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

基本設定

設定項目	説明
最大パケットサイズ	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配信戦略を使用する際に最初のサブスクライバーを選択する方法を指定します。 オプション： 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メッセージの最大数を定義します。値を大きくするとスループットが向上する可能性がありますが、メモリ使用量も増加します。
最大メッセージキュー長	永続クライアントが切断された場合やインフライトウィンドウが満杯の際にメッセージをキューイングする最大長を指定します。キューがこの制限に達すると古いメッセージから破棄されます。

フラッピング検出設定

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

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

設定の更新

MQTT設定を変更した後、更新をクリックして変更を適用してください。新しい設定は即時に反映されます。