デプロイメント設定

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

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

概要

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

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

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

  補足

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

一般設定

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

デプロイメント情報

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

項目	説明
デプロイメント名	デプロイメントの名前です。編集アイコンをクリックして直接編集、またはコピーアイコンでコピーできます。
デプロイメント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設定タブは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選択	sticky配信戦略使用時に最初のサブスクライバーを選ぶ方法を指定します。 選択肢： random：ランダムにサブスクライバーを選択。 local：ローカルノードのサブスクライバーを優先し、なければクラスター全体からランダム選択。 hash_clientid：パブリッシャーのクライアントIDのハッシュで選択。 hash_topic：パブリッシュされるトピックのハッシュで選択。 この設定は共有サブスクリプショングループがアクティブになった際の初期負荷分散動作を決定します。
ピア証明書をユーザー名として使用	EMQX Cloudがクライアントの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}として宣言でき、set_as_attr設定フィールドで指定した属性キー{NAME}を使用します。注意：属性名tnsは内部システム用に予約されており使用禁止です。 初期化された属性はclient_attrsプロパティに保存され、マウントポイントの動的レンダリングや認証・認可ルールで参照可能です。 クライアント属性の設定と使用方法の詳細はEMQXのクライアント属性を参照してください。

セッション設定

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

フラッピング検出設定

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

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

設定の更新

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