EMQX Cloud

日本語

简体中文
English

日本語

简体中文
English

Appearance

お問い合わせ
お問い合わせ

Things ​

Thingは、EMQX Fleetsに登録された個別のデバイス識別子です。各Thingは名前とMQTTクライアントIDを持ち、オプションでスキーマを定義するThing Typeに関連付けることができます。

Thingの登録 ​

  1. Fleetsのデプロイメントで、デバイス管理 > Things に移動します。
  2. + Register Thing をクリックします。
  3. 以下の項目を入力します：
    • Name（必須）：デプロイメント内で一意のデバイス識別子です。MQTTトピックやAPI呼び出しで {thingName} として使用されます。
    • MQTT Client ID（必須）：このデバイスが使用するMQTTのCONNECTパケットのクライアントIDです。物理デバイスがEMQXブローカーに接続する際に送信するクライアントIDと一致している必要があります。
    • Thing Type（任意）：このデバイスにThing Typeを関連付け、そのスキーマを継承します。
    • Group（任意）：デバイスをThingグループに割り当てます。
    • Tags（任意）：このデバイスに関連付けるタグです。
  4. Confirm をクリックします。

register_thing

Thingは初期状態でオフラインとして作成されます。設定したMQTTクライアントIDを使ってデバイスがEMQXブローカーに接続すると、オンラインになります。

Thingの識別フィールド ​

各Thingには異なる用途の3つの識別フィールドがあります：

フィールド用途
Thing IDシステム生成のUUID。内部処理およびAPIパスパラメータで使用されます。
Nameすべての$emqx/things/{thingName}/... MQTTトピックおよびAPIリクエストボディでの{thingName}として使用されます。
MQTT Client IDMQTTのCONNECTパケットのクライアントID。接続のライフサイクル管理（オンライン／オフライン状態）に使用されます。

NameとMQTT Client IDは同じでも問題ありませんが、独立したフィールドです。例えば、Thing名がsensor-001で、MQTTクライアントIDもsensor-001の場合があります。

Thingのステータス ​

ステータス意味
onlineデバイスが現在EMQXブローカーに接続中です。
offlineデバイスが現在接続していません。

ステータスはMQTTの接続・切断イベントに基づいて自動的に更新されます。

Thingの詳細表示 ​

リスト内のThing名をクリックすると詳細ページが開きます。ページ上部には4つのサマリーカードが表示されます：

  • Status：現在の接続ステータスと最終オンライン日時。
  • Thing Type：関連付けられたThing Typeの名前とID。
  • Schema：Thing Typeから継承したプロパティ、イベント、コマンドの数（properties / events / commands）。
  • Relationships：タグとThingグループの数（tags / groups）。

view_thing_details

詳細ページには以下のタブがあります：

Details ​

Thingの識別情報とタイムスタンプを表示します：

フィールド説明
Thing IDシステム生成の一意の識別子
MQTT Client ID登録時に設定されたMQTTクライアントID
Status現在の接続ステータス
Updated AtThingレコードが最後に更新された日時
Last Offlineデバイスが最後に切断された日時
NameThing名
Thing Type関連付けられたThing Type
Created AtThingが登録された日時
Last Onlineデバイスが最後に接続した日時

Properties ​

Thing Typeスキーマで定義されたプロパティを一覧表示します。以下の列があります：

列説明
Nameプロパティ名
Typeデータ型（string、int、float、boolean、enum）
Details書き込み可能かどうか、単位、値の範囲（該当する場合）
Descriptionプロパティの説明

thing_details_properties

Events ​

Thing Typeスキーマで定義されたイベントを一覧表示します。以下の列があります：

列説明
Nameイベント名
Severityinfo、warn、error
Descriptionイベントの説明

thing_details_events

Commands ​

Thing Typeスキーマで定義されたコマンドを一覧表示します。+ Send Command をクリックすると、この詳細ページから直接デバイスにコマンドを送信できます。

列説明
Nameコマンド名
Typeコマンドタイプ（sync）
Details入力パラメータ、出力パラメータ、タイムアウト
Descriptionコマンドの説明

thing_details_commands

Relationships ​

デバイスが所属するThingグループと割り当てられたタグを表示します：

  • Thing Groups：名前と説明でグループを一覧表示。
  • Tags：タグはチップ形式で表示。

thing_details_relationships

Jobs ​

このデバイスを対象としたジョブ実行の一覧です。Statusフィルターで絞り込みが可能です。

列説明
Job IDジョブ実行の詳細へのリンク
Attempt実行試行回数
Status現在の実行ステータス
Shadow Version実行時のシャドウバージョン
Error Message実行失敗時のエラー詳細
Updated At実行が最後に更新された日時

thing_details_jobs

Thingsのエクスポートとインポート ​

ThingsをJSONファイルとしてエクスポートするには、チェックボックスで1つ以上のThingを選択し、Exportをクリックします。

JSONファイルからThingsをインポートするには、Importをクリックしてファイルを選択します。

Thingの編集 ​

  1. Thingsリストで、Actions列の編集アイコンをクリックします。
  2. 以下の項目を更新します：
    • Name（必須）
    • MQTT Client ID（必須）
    • Thing Type（任意）
    • Group（任意）：選択したグループのタグがGroup Tagsに表示され、読み取り専用です。
    • Tags（任意）
  3. Confirmをクリックします。

フィルターと検索 ​

Thingsリストは以下の条件でフィルター可能です：

  • Thing Type：特定のタイプのThingのみ表示。
  • Group：特定のThingグループに所属するThingのみ表示。
  • Tags：特定のタグを持つThingのみ表示。
  • Status：onlineまたはofflineで絞り込み。

検索アイコンを使ってThing名で検索できます。

Thingの削除 ​

  1. Thingsリストで、Actions列の削除アイコンをクリックします。
  2. 削除を確認します。

Thingを削除すると、その登録情報、シャドウ状態、グループ所属情報がすべて削除されます。

次のステップ ​