Message Queue クイックスタート
このページでは、Message Queue 機能の簡単な使い方を説明します。MQTTX を使ってクライアントをシミュレートし、EMQX ダッシュボードからメッセージキューを作成・管理し、メッセージがどのように確実に保存・配信されるかを確認します。
目的
このクイックスタートでは、EMQX Message Queue が以下のことを実現できることを紹介します。
- サブスクライバーがオフラインでもメッセージを永続化する
- 設定可能なディスパッチ戦略をサポートする
- メッセージの圧縮に Last-Value Semantics を有効にする
前提条件
開始する前に、以下を準備してください。
- EMQX 6.0 以上が稼働していること(Message Queue 機能が有効)
- MQTTX(または MQTT 5.0 対応のクライアント)
- EMQX ダッシュボードへのアクセス(デフォルト:
http://localhost:18083)
Message Queue の基本機能を試す
このセクションでは、EMQX Message Queue がメッセージをどのように永続化し配信するかを示します。MQTTX を使って MQTT クライアントをシミュレートし、サブスクライバーがオフラインの間もメッセージが保持・配信される様子を観察します。
ステップ 1: キューの作成
左メニューの Queues に移動します。
ページ右上の Create ボタンをクリックします。
Create Queue ダイアログで以下の設定を行います。
- Name:
my_queue - Topic Filter:
demo/topic - Dispatch Strategy:
Random - Data Retention Period:
7日 - Last Value Semantics:
Disabled
- Name:
Create をクリックします。
ステップ 2: メッセージのパブリッシュ
MQTTX を使って パブリッシャー としてクライアントをシミュレートします。
- MQTTX を開き、クライアントを作成(例:
publisher)。 - EMQX に接続(
mqtt://localhost:1883)。 - トピック
demo/topicに QoS 1 でメッセージをパブリッシュします。
例:
Topic: demo/topic
QoS: 1
Payload: {"msg": "Hello 1"}{"msg": "Hello 2"} など、ペイロードを変えて複数回繰り返します。
この時点ではサブスクライバーはいません。メッセージは EMQX によってキューに保存され永続化されます。
ステップ 3: サブスクライブしてメッセージを消費
MQTTX を使って サブスクライバー としてクライアントをシミュレートします。
2つ目のクライアントを開く(例:
worker-a)。EMQX に接続します。
キュートピックにサブスクライブします。
jsonTopic: $queue/my_queue/demo/topic QoS: 1
これで、キューに保存されていた過去のメッセージをすべて受信できます。

複数サブスクライバーとディスパッチ戦略のシミュレーション
このセクションでは、同じ Message Queue に複数のサブスクライバーが接続した場合をシミュレートし、異なるディスパッチ戦略がメッセージの配信にどのように影響するかを確認します。
publisherクライアントで、元のトピック($queue/プレフィックスなし)に複数のメッセージをパブリッシュします。bashfor i in {1..10}; do mqttx pub -t demo/topic -m "message-$i" -q 1 done別の MQTTX クライアントを作成(例:
worker-b)。EMQX に接続し、同じキュートピックにサブスクライブします。
jsonTopic: $queue/my_queue/demo/topic QoS: 1
これで worker-a と worker-b の両方が同じキューからメッセージを消費します。
- 両方のサブスクライバーでメッセージの流れを観察してください。
ディスパッチ戦略が配信に与える影響
キューの Dispatch Strategy によってメッセージの配信動作は異なります。
| Dispatch Strategy | 挙動 | 利用ケース |
|---|---|---|
Least Inflight Subscriber | 未アック(未確認)メッセージが少ないサブスクライバーを優先 | 不均一な消費者間の負荷分散 |
Round Robin | サブスクライバーに順番にメッセージを配信 | 速度に関係なく公平に配信したい場合 |
Random (デフォルト) | ランダムにサブスクライバーを選択してメッセージを送信 | 予測不能な動作やデモ用 |
worker-a と worker-b でのメッセージ配信の様子を見て、これらの挙動を確認できます。
ディスパッチ戦略の変更
戦略は動的に変更可能です。
- ダッシュボードの Queues に移動します。
- 対象キューの Edit をクリックします。
- 新しい Dispatch Strategy を選択し、保存します。
ただし、サブスクライバーがオンラインの間は新しい戦略は適用されません。クライアントを切断して再接続する必要があります。
切り替え後、再度メッセージパブリッシュを行い、サブスクライバー間の配信パターンの違いを観察してください。
Last-Value Semantics のテスト
このセクションでは、Last-Value Semantics を有効にする方法を示します。これはキーごとに最新のメッセージのみをキューに保持する機能で、デバイス設定の更新などに適しています。
ステップ 1: 既存キューの削除
- EMQX ダッシュボードの Queues に移動します。
- トピックフィルターが
demo/topicのキューを探します。 - Actions 列の Delete をクリックします。
- 確認ダイアログで削除を承認します。
- キュー一覧から削除されるまで待ちます。
EMQX 6.3.3 以降では、削除を承認するとキューは削除マークが付けられ、バックグラウンドでクリーンアップが開始されます。クリーンアップ完了までキューは一覧に残ります。
ステップ 2: Last-Value Semantics を有効にしたキューを作成
- Queues ページで Create をクリックします。
- Create Queue ダイアログで以下を設定します。
- Name:
my_queue - Topic Filter:
device/config - Dispatch Strategy:
Random(または任意) - Data Retention Period:
7日 - Last Value Semantics: 有効にする
- Queue Key Expression:
message.from(またはキーとして使う任意のフィールド名)
- Name:
- Create をクリックします。
「Queue Key Expression」は、EMQX がメッセージからキーを抽出し、Last-Value Queue の重複排除に使う方法を定義します。このフィールドは Variform expressions による設定をサポートしています。
このクイックスタートでは message.from を使い、メッセージパブリッシャーのクライアント ID からキーを抽出しています。
キューキー式の高度な使い方やカスタムキー、メッセージ構造の例については、Queue Key Expression を参照してください。
ステップ 3: メッセージのパブリッシュ
- MQTTX を開き、クライアントを選択または作成(例:
publisher)。 - EMQX に接続(
mqtt://localhost:1883)。 device/configにメッセージをパブリッシュします。
例:
| フィールド | 値 |
|---|---|
| Topic | device/config |
| QoS | 1 |
| Payload | {"ssid": "wifi1"} |
- 同じクライアント(同じクライアント ID)で内容を更新したメッセージをパブリッシュします。
Payload: {"ssid": "wifi2"}Queue Key Expression が message.from に設定されているため、EMQX は各メッセージからクライアント ID を自動的に抽出し、キューキーとして使用します。同じクライアントからのメッセージは、未消費の古いメッセージを上書きします。
ステップ 4: キューにサブスクライブ
- 2つ目の MQTTX クライアント(例:
subscriber)を作成し、EMQX に接続します。 - キュートピックにサブスクライブします。
Topic: $queue/my_queue/device/config
QoS: 1期待される動作:
最新のメッセージのみが配信されます。この例では {"ssid": "wifi2"} のみが受信されます。