デバイス管理

デバイス管理アプリケーションは、デバイスの管理および監視する機能を提供し、デバイスをリモートで制御およびトラブルシューティングができるようにします。

概要

以下のセクションでは、デバイス管理アプリケーションのすべての機能について詳しく説明します。このドキュメントの内容の概要については、以下を参照してください。

セクション コンテンツ
デバイスの接続 デバイスをアカウントに接続するための1つ以上のデバイスを手動で登録する方法およびデバイスの一括登録方法。
デバイスの表示 デバイスリストに表示される内容、およびデバイスの検索デバイスのフィルタリングによるデバイスの並べ替え方法。
デバイスのグループ化 デバイスを最上位レベルのグループ、サブグループ、およびスマートグループにグループ化する理由と方法。
デバイスの詳細 各種の各種の情報デバイス。
デバイスの監視と制御 デバイスの接続品質およびサービスステータスの監視方法、デバイスからのアラームの処理方法、遠隔制御の方法、およびトラブルシューティングデバイスの方法。
デバイスタイプの管理 デバイスプロトコルを使用してさまざまなデバイスタイプのデータを処理する方法。
デバイスデータの管理 デバイスのファームウェアとソフトウェアの取得と管理方法および構成スナップショットの処理方法。
SmartRESTテンプレートの使用 SmartRESTテンプレートの操作方法は、CSVデータとCumulocity Rest API呼び出しの変換に使用される要求テンプレートと応答テンプレートの集合です。
シミュレーターを使用する シミュレーターを使用してデバイスをモデリングし、接続されているハードウェアデバイスと同じレベルの機能を持たせる方法。

デバイスの接続

このセクションでは、デバイスをThings Cloudアカウントへ手動または一括登録により接続する方法を説明します。

Things Cloudアカウントにデバイスを接続するには、以下の手順に従ってください:

ナビゲータのデバイス下にある登録をクリックし、デバイスの登録をクリックします。

デバイス登録の画面で、次のいずれかのオプションを選択できます。

特定のアプリケーションを登録している場合は、3番目のオプションであるカスタムデバイス登録が表示されます。 LoRaやSigfoxなど、特定のタイプのデバイスを登録するには、これらのオプションサービスのマニュアルを参照してください。

Register devices

デバイスを手動で接続する

次の手順では、デバイスを手動で接続する方法を説明します。接続するデバイスの種類によっては、プロセスのすべての手順が関連するとは限りません。

デバイスをThings Cloudアカウントに手動で接続するには、次の手順に従います。

  1. ナビゲータのデバイスにある登録をクリックし、デバイスの登録をクリックします。

  2. デバイスの登録画面で、一般デバイス登録を選択します。

    General device registration

  3. デバイスID欄に、デバイスの固有IDを入力します。IDを確認するには、デバイスのマニュアルを参照してください。モバイルデバイスの場合IDは通常、デバイスの背面にあるIMEI(International Mobile Equipment Identity[国際移動装置識別)となります。

  4. 必要に応じて、登録後にデバイスを割り当てるグループを選択します。グループ割り当ての詳細については、デバイスのグループ化を参照してください。
  5. 他のデバイスを追加をクリックして、デバイスを追加登録します。再度、デバイスIDを入力し、オプションでグループを選択します。これにより、1回の操作で複数のデバイスを追加できます。
  6. 次へをクリックして、デバイスを登録します。

登録に成功すると、デバイスがデバイス登録ページ接続待機中というステータスで表示されます。

デバイスの電源を入れ、接続が確立されるまで待ちます。 デバイスが接続されると、そのステータスは承認保留中に変わります。 承認をクリックして、接続を確認します。デバイスのステータスが 「承認済」に変わります。

Info:問題が発生した場合は、ご使用のデバイスタイプに該当する部分をデバイスガイドで参照し、 デバイスタイプは開発センターまたはデバイスのマニュアルを参照してください。

デバイス登録画面

デバイス登録画面では、現在登録処理中のすべてのデバイスがリストまたはグリッドで表示されます。

Device registration page

各デバイスについて、次の情報が表示されます。

  • 登録プロセスで指定されたデバイス名
  • デバイスのステータス(下記参照)
  • 作成日
  • 機器が登録されたテナント

デバイスのステータスは、次のいずれかになります。

  • 接続待機中-デバイスは登録されていますが、指定されたIDのデバイスは接続を試行していません。
  • 承認保留中-指定されたIDを持つデバイスからの通信がありますが、資格情報がデバイスに送信されるためには、登録を行っているユーザーが明示的に承認する必要があります。
  • 承認済み-ユーザーは資格情報をデバイスに送信することを承認しました。

デバイスの一括登録

多数のデバイスを接続するために、Things Cloudはデバイスを一括登録するオプションを提供しています。つまりCSVファイルをアップロードすることで多数のデバイスを登録することができます。

  1. ナビゲータのデバイスにある登録をクリックし、デバイスの登録をクリックします。
  2. 次のウィンドウで、一括登録を選択します。

    Bulk registration

  3. アップロードするファイルを選択をクリックし、コンピュータで参照してアップロードするCSVファイルを選択します。


アップロードされたCSVファイルの形式に応じて、次の登録タイプのいずれかの処理が行われます。

簡易登録

CSVファイルに、IDとPATHという2つの列がある場合:IDがデバイス識別子(シリアル番号)で、PATHがスラッシュで区切られたグループ名の一覧(登録後にデバイスを割り当てるグループへのパス)です。

    ID;PATH
    Device1;Group A
    Device2;Group A/Group B

ファイルがアップロードされると、必要なグループが新規作成され、ステータスが「接続待機中」の新規登録が作成されます。通常の登録プロセスを続行する必要があります(上記参照)。

完全登録

CSVファイルには、少なくともデバイス識別子としてのIDとデバイスの認証情報が含まれている必要があります。

    ID;Credentials;PATH;ICCID;NAME;TYPE
    006064ce800a;LF2PWJoLG1Fz;Sample_Dusseldorf;+491555555;Sample_Device1;c8y_Device
    006064ce8077;OowoGKAbiNJs;Sample_Dusseldorf;+491555555;Sample_Device2;c8y_Device

それとは別に、上記の例のようにICCID、NAME、TYPEのような他の列を含むこともあります。

デバイスを接続するために、これらは関連情報とともに事前登録されます。具体的に、各デバイスは次のような構成設定になります。

  • ユーザー名-Things Cloudにアクセスするためのユーザー名のフォーマットは<tenant>/device_<id>でなければなりません。<tenant>は、CSVファイルのインポート元であるテナントを示し、<id> は、CSVファイルで該当する値を参照します。
  • パスワード-Things Cloudにアクセスするためのパスワードで、CSVファイルにおける「Credentials」の値と同じです。
  • マネージドオブジェクトとして表わされるデバイス-CSVファイルにおけるTYPE、NAME、ICCID、IDTYPE、PATH、SHELL。

データがインポートされると、事前登録されたデバイスの数と、発生したエラーに関するフィードバックが表示されます。

上記両方の形式のテンプレートファイルが用意されておりますので、ダウンロードして表示またはコピーができます。

ファイルフォーマットおよび許容されるCSVの種類について詳しくは、一括デバイス認証情報をご覧ください。

デバイスの表示

アカウントに接続されているすべてのデバイスを表示するには、ナビゲータのデバイスメニューで全てのデバイスをクリックします。

詳細なデバイスリストが表示されます。

Device List

デバイスリスト

デバイスリストの列にはデバイスごとに、次の情報が表示されます。

説明
ステータス 接続状態を表すアイコン。詳細は接続の監視を参照してください。
名前 デバイスの固有の名前です。
モデル デバイスのモデルの種類です。ブラウザの幅によっては、表示されない場合があります。
シリアル番号 デバイスのシリアル番号。ブラウザの幅によっては、表示されない場合があります。
グループ デバイスが割り当てられているグループ (存在する場合)。
登録日 デバイスがアカウントに登録された日付です。
システムID デバイスのシステムIDです。
IMEI デバイスのIMEIです。
アラーム デバイスのアラームの状態。現在解決されていないアラームの数と種類が表示されます。アラームの操作の詳細については、アラームの操作を参照してください。

デバイスリストには、最大100行が表示されます。リストに100を超えるデバイスが含まれている場合は、リストの一番下にあるさらにロードするをクリックすると、次の100個のエントリーが表示されます。

リストの行にカーソルを合わせると、右側に削除ボタンが表示されます。デバイスを完全に削除するには、このボタンをクリックします。

重要:デバイスを削除するということは、Things Cloudデータベースから、デバイスと生成されたすべてのデータを削除するということです。対応策として、廃棄したすべてのデバイスを単一のグループに配置することもできます(デバイスのグループ化を参照)。これをすると、すべてのレポートが正しく維持されます。撤去されたデバイスでアラームが発生しないようにするには、接続監視を無効にします。デバイスを削除しても、その子デバイスのデータは削除されません。

デバイスの検索

Things Cloudはデバイスの全文検索機能を備えています。

右上の検索ボタンをクリックし、テキストボックスに検索語を入力します。Things Cloudは、あらゆるプロパティ(名前、モデル、フラグメントなど)にこの用語を含む全てのデバイスを戻り値として表示します。

以下の例では、「IoTゲートウェイ」を検索します。

Info:フィルタとは異なり、検索でのワイルドカードの使用はサポートされていません。

検索機能の詳細については、はじめに>GUIの機能を参照してください。

Device Management Search

デバイスのフィルタリング

デバイスリストには、リスト内のデバイスを特定の条件でフィルタリングする機能を備えています。

フィルタリングはすべての列で行えます。フィルタを設定する列の名前の横にあるフィルタアイコンをクリックします。

Filtering

フィルタオプションを指定するためのウィンドウが表示されます。

Filter Options

ほとんどの列はテキスト欄を表します。検索欄のように、テキストボックスに任意のテキストを入力するだけで、これらの列にフィルタを適用できます。複数の語句を抽出する場合は、 [+Or] をクリックしてテキストボックスを追加します。

テキストのフィルタリング以外にも、いくつかのオプションがあります。

  • 日付欄の場合 (例:登録日)、フィルタする日付範囲を指定します。
  • ステータス列では、デバイスの送信、プッシュ、またはメンテナンスのステータスを表すさまざまな基準をフィルタリングできます。
  • Alarm列で選択できるフィルタリングオプションは、アラームタイプ(クリティカル、メジャー、マイナー、警告、アラームなし)に対応します。

デバイスを特定の順序で並べ替える場合は、フィルタオプションウィンドウで昇順または降順をクリックします。最後に、適用をクリックしてフィルタを実行します。

これでデバイスリストには、フィルタオプションに一致するデバイスのみが表示されます。

すべてのフィルタをクリアしてすべてのデバイスを表示するには、トップメニューバーの右側にあるフィルタをクリアをクリックします。

Info:デバイス名などのテキスト欄を昇順または降順で並べ替える場合、アルファベット順の並べ替えはASCII/UTF: A < B < ... < Z < ... < a < b ... < zに基づいて行われます。小文字で始まる名前は、すべての大文字から始まる名前の下(昇順)または上(降順)にソートされます。

デバイスのグループ化

デバイスは、特定のユースケースに従って任意にグループ化できます。デバイスは複数のグループに配置でき、グループ自体も複数のグループに含めることができます。

Things Cloudは、最上階層グループとサブグループを区別します。

最上階層グループは、ナビゲータの最上階層にあるグループメニューに表示されます。サブグループは、最上階層のグループをさらに分割するために使用されます。

グループの表示

アカウント内のすべてのグループ一覧を表示するには、ナビゲータでグループをクリックします。

Groups list

グループごとに、名前と子の数が表示されます。

グループをクリックすると、その詳細が表示されます。

Group details

情報タブ

情報タブには、次の情報が表示されます。

カード 説明
備考 現在のアクティビティに関する備考が記載しています。通常、備考は管理者のみが編集できます。注記を追加または編集するには、編集をクリックし、テキストボックスに注記または変更内容を入力し、テキストボックスの右側にある緑色のチェックマークをクリックして編集内容を保存します。
グループデータ グループに関する編集可能な情報を表示します(名前、説明)。
アクティブなクリティカルアラーム グループ内のデバイスのアクティブなクリティカルアラームを表示します。

サブアセット

サブアセットタブには、グループに割り当てられているすべてのデバイスの一覧が表示されます。デバイスごとに、名前と子の数が表示されます。

Sub-assets

デバイスをグループに割り当てるには、トップメニューバーの右側にあるデバイスを割り当てる(既存のグループにデバイスを割り当てる方法を参照)をクリックします。

デバイスの割り当てを解除するには、デバイスエントリのメニューアイコンをクリックし、メニューから割り当て解除を選択します。

一括操作

一括操作タブでは、グループに対して作成された一括操作を管理できます。一括操作では、1つのグループ内の各デバイスに対して一度に操作を実行することができます。詳細は、一括操作を参照してください。

新規グループの作成方法

新規グループを作成するには、次の手順に従ってください:

  1. トップバーの右側にあるプラスボタンをクリックし、メニューから新規グループを選択します。
  2. 表示されたウィンドウで、グループを識別するための一意のグループ名を入力します。
  3. デバイス検索欄に、グループに追加するデバイスの検索条件を入力します(例:「ublox」)。検索条件に一致するデバイスの一覧が表示されます。
  4. リストから追加するデバイスにチェックマークを付けます。
  5. X個のデバイスのグループを作成」 をクリックして、新しいグループを作成します。

Info:グループには「0」デバイスを含めることができます。

既存のグループにデバイスを割り当てる方法

デバイスを既存のグループに割り当てるには、2つの方法があります。

デバイスの観点より:

  1. デバイスリストからデバイスを選択して開きます。
  2. 情報タブで、グループ割り当てカードまでスクロールダウンします。ドロップダウン・フィールドから、デバイスを割り当てるグループを選択します。ここにグループ名を直接入力することも、名前の一部のみを入力してリストをフィルタし、一致するグループ名のみを表示することもできます。
  3. 割り当てるをクリックします。<!--

存在しないグループ名を入力して検索すると、新規ボタンが表示されますので、ここで入力した名前の新規グループを作成し、その新規グループにデバイスを割り当てることができます。

新規グループを作成するには、ユーザーに次の権限が必要です。

  • ROLE_INVENTORY_CREATE
  • ROLE_INVENTORY_ADMIN

new group

グループの観点より:

  1. ナビゲータで、グループメニューからグループを選択し、サブアセットタブを開きます。サブアセットタブには、各グループに割り当てられているすべてのデバイスが表示されます。
  2. トップメニューバーの右側にあるデバイスを割り当てるをクリックします。次のウィンドウで、グループに追加するデバイスを検索します(例:「ublox」)。検索条件に一致するデバイスのリストが表示されます。
  3. リストから追加するデバイスにチェックマークを付けます。
  4. X デバイスを割り当てるをクリックして、選択したデバイスを割り当てます。

Assign devices to a group

サブグループの作成方法

  1. ナビゲータで、グループをクリックして開きます。
  2. トップメニューバーの右側にあるグループを追加をクリックします。
  3. 次のウィンドウで、サブグループの名前を入力し、グループを追加をクリックします。

グループの編集方法

  1. ナビゲータで、グループをクリックして開きます。
  2. 情報タブから編集をクリックします。これにより、グループの名前を編集し、グループにユーザー権限を割り当てることができます。 権限の詳細については、管理ガイドを参照してください。

スマートグループの使用方法

スマートグループは、フィルタ条件に基づいて動的に作成されるグループです。グループメンバーは常に変更することができるので、一時的な要素を持っています。スマートグループには固定メンバーリストはありません。代わりに固定基準があります。このタイプのグループは、たとえば、特定のタイプのデバイスを新しいソフトウェアまたはファームウェアバージョンに一括アップグレードする場合に使用できます。

Adding top-level groups

スマートグループは、デバイスリストから作成できます。

  1. デバイスリストを開くには、ナビゲータでデバイス一覧をクリックします。
  2. リスト内のデバイスをフィルタリングして、目的のデバイスを選択します。フィルタリングの詳細については、デバイスのフィルタリングを参照してください。
  3. トップメニューバーの右側にあるスマートグループを作成をクリックします。
  4. グループの名前を入力し、作成をクリックします。

Create a smart group

新規グループは、ナビゲータのグループメニューの最上階層グループとして表示されます。スマートグループは、フォルダアイコン内の小さな歯車で区別できます。

Smart groups

サブアセットタブでは、選択内容を調整したり、フィルタ設定を変更することができます。

スマートグループを削除するには、三点リーダーマークをクリックし、メニューから削除を選択します。

Adding top-level groups

重要:スマートグループを削除すると、元に戻すことはできません。

Info:コックピットアプリケーションの使用時にはスマートグループは表示されません。

デバイスの詳細

デバイスごとに詳細な情報が表示されます。デバイスに対して実際に提供される情報の種類は、デバイスの種類、デバイスの使用状況、およびユーザーインターフェースの構成によって異なります。

デバイスの詳細情報を表示するには、デバイスリストでデバイスをクリックします。

Device details

デバイスの詳細はタブに分かれています。タブの数は動的であり、情報量によって異なります。つまり、その特定デバイスの提供可能な情報のタブのみが表示されます。

最初に、Infoタブが表示されます。このタブには、デバイスに関する一般的な情報が表示され、各デバイスで使用できます。

各デバイスには少なくとも、情報、アラーム、制御、イベント、サービス監視、IDの各タブが表示されます。(以下のタブリストも参照してください。)

次のタブは最も一般的なタブで、それぞれ別途詳細に説明しています。

タブ 説明
情報 デバイスの一般情報を表示します。各デバイスで使用できます。
子デバイス 現在のデバイスに接続されているデバイスを一覧表示します。
メジャーメント デバイスが提供する数値データを既定のグラフ形式で表示します。
アラーム デバイスのアラームに関する情報を表示します。アラームの操作も参照してください。各デバイスで使用できます。
構成 テキスト形式で入力されたデバイスパラメータと設定を手動で構成できます。バイナリ構成については、設定リポジトリも参照してください。
コントロール デバイスに送信されている操作を表示します。オペレーションの操作も参照のこと。各デバイスで使用できます。
ネットワーク デバイスのネットワーク情報を表示します。
ソフトウェア デバイスのファームウェアおよびデバイスにインストールされているソフトウェアを管理します。
イベント デバイスに関連するイベントを表示します。低レベルのトラブルシューティングに役立ちます。デバイスのトラブルシューティングも参照のこと。各デバイスで使用できます。
所在地 デバイスがある場合、その場所を表示します。
ログ デバイスのログ情報の要求を許可します。
サービス監視 マシンのサービス監視を許可します。監視サービスも参照してください。各デバイスで使用できます。
シェル コマンドプロンプトからリモートデバイスと対話できます。
トラッキング 使用可能な場合、デバイスの動きを表示します。
アイデンティティ 特定のデバイスに対して記録されたIDを表示します。各デバイスで使用できます。

Info:ここに記載されていない個々のタブについては、別の文脈で記述されている可能性があるため、Things Cloudドキュメントの別の場所に記載されています。検索機能を使用して、関連するセクションに切り替えてください。Modbusタブの詳細な説明は、それぞれのデバイスガイドにあります。

名前の下にブレッドクラムリストが表示されます。デバイスがアセット階層(グループなど)の一部である場合は、ブレッドクラムを使用して階層を上に簡単に移動できます。デバイスは複数の階層に所属している場合があるので、複数行のブレッドクラムが表示されることがあります。

デバイスのタイプと使用状況に応じて、もっと見るをクリックすると、メニューに追加のアクションが表示されます。トップメニューバーの右側に表示されます。

More menu

これらの追加メニュー項目の詳細は、必要に応じて提供されます。

情報

情報 タブでは、管理に関連するデバイス情報の概要をダッシュボードに表示します。

Info dashboard

この情報は、次のカードに記載されています。

カード 説明
メモ 現在のアクティビティを通知するメモを提供します。通常、メモは管理者のみが編集できます。メモを追加または編集するには編集をクリックし、テキストボックスに注記または修正を入力し、テキストボックスの右側にある緑色のチェックマークをクリックして編集内容を保存します。
デバイスステータス 接続関連の情報を表示します。詳細については 接続監視を参照してください。
デバイスと通信 特定のメジャーメントのリアルタイムデータを表示するデータポイントグラフを表示します。データポイントグラフの詳細については、コックピットのマニュアルのデータエクスプローラの使用方を参照してください。
以下のメジャーメントが表示される場合があります。
データポイント: c8y_Battery.level, c8y_SignalStrength.rssi, c8y_MemoryMeasurement.Used, c8y_CPUMeasurement.Workload, c8y_NetworkStatistics.Upload, c8y_SignalStrength.RCSP, c8y_SignalStrength.ber, c8y_SignalStrength.ECN0, c8y_NetworkStatistics.Download, c8y_MemoryMeasurement.Total
アラーム: c8y_UnavailabilityAlarm
イベント: c8y_LocationUpdate
デバイスデータ デバイスに関する編集可能な情報を表示します(名前、タイプ、ID、所有者、最終更新日). IDおよび最終更新日は編集できません。さらに、ハードウェア(編集可)およびファームウェア(編集不可)に関する情報があれば、ここに表示されます。
アクティブなクリティカルアラーム デバイスのアクティブなクリティカルアラームを表示します。
グループの割り当て デバイスが属するグループを表示します。さらに、ここでデバイスをグループに追加したり、グループから解除したりできます。デバイスのグループ化の詳細についてはデバイスのグループ化を参照してください。
位置 デバイスによって報告された、または手動で設定されたマップ上のデバイスの位置を表示します。 詳細は位置を参照してください。

子デバイス

子デバイスタブには、現在表示されているデバイスに接続されているデバイスの一覧が表示されます。たとえば、ゲートウェイを見ると、タブにはそのゲートウェイに接続されているすべての機器が一覧表示されます。

子デバイスリストの詳細については デバイスの表示を参照してください。

メジャーメント

メジャーメントタブでは、デバイスが提供する数値データをチャート形式で表示します。チャートは、複数のグラフまたは「シリーズ」を含むことができるメジャーメントのタイプにグループ化されます。たとえば、次のスクリーンショットは、3次元での加速度のグラフを含む動作メジャーメントのグラフと、信号強度とビットエラー率の形式でのモデム統計を含むグラフを示しています。

Measurements

チャートに異なる単位のグラフが含まれている場合は、単位ごとに1つのY軸が表示されます。上の例では、動作メジャーメントは単位「メートル/平方秒」を持つ3つのパラメータで構成されているため、レンダリングされる軸は1つだけです。モデムの統計情報は、デシベルミリワット単位の信号強度とパーセント単位のビットエラー率で構成されているため、グラフごとに1つの軸が描画されます。

メジャーメントの詳細情報を表示するには、グラフにカーソルを合わせます。カーソルの横に、メジャーメントの詳細情報を示すツールチップが表示されます(ツールチップが最も近いメジャーメントに「スナップ」します)。

時間範囲と集計

デフォルトでは、グラフには過去1時間分の原データが表示されます。X軸の時間範囲を変更するには、右上のドロップダウンメニュー「過去1時間」を開き、時間範囲を選択します。

時間範囲を増やすと、集計フィールドの値が自動的に「毎時」または「毎日」に切り替わります。これで、グラフは個々の原データポイントではなく範囲が表示されるようになります。「毎時」の場合、グラフには1時間で測定された最小値と最大値の範囲が表示されます。「毎日」の場合、チャートには1日のメジャーメントの最小値と最大値が表示されます。同様に、ツールチップに個々の値ではなく値の範囲が表示されるようになります。

これにより、より広い時間範囲にわたって効率的に概要を把握できます。グラフには、デスクトップブラウザの過負荷を避けるために、最大5.000個のデータポイントしか表示されません。データ・ポイントが5.000を超える細かい焦点を選択すると、 「データが切り捨てられました。集計を変更するか、短い日付範囲を選択してください」という警告文が表示されます。

リアルタイムをクリックすると、接続されたデバイスからシステムに新しいデータが送信される度、グラフのリアルタイムでのユーザーインタフェース更新を行います。

いわゆる「KPI」を設定して、グラフィック表示と軸制限に影響を与えることができます。管理ガイドを参照してください。

メジャーメント形式

メジャーメントグラフを表示するには、デバイスは特定のフラグメント形式でメジャーメントを送らなければならない。

"fragment_name" : { "serie_name" : { "value" : ... "unit" : ... } }

例:

"c8y_SpeedMeasurement": { "Speed": { "value": 1234, "unit": "km/h" } }

フラグメント_name and serie_は、別の有効なjsonプロパティ名に置き換えることができますが、空白や、[]、*などの特殊文字は使用できません。構造は、上記とまったく同じ2階層のjsonオブジェクトでなければなりません。

アラーム

アラームタブには、デバイスのアラームに関する情報が表示されます。アラームの詳細については、アラームの操作を参照してください。

構成

デバイスの構成タブにあるテキスト構成設定では、デバイスのパラメータと初期設定をテキスト形式で設定できます。

デバイス構成設定を手動で追加または編集するには、次の手順に従います。

  1. 目的のデバイスの詳細を開きます。
  2. 構成タブをクリックします。
  3. テキスト欄では、必要に応じてデバイス構成設定を追加または編集できます。
  4. 保存をクリックして編集内容を保存します。

Device details

この他に、構成設定スナップショットを使用することもできます。詳細は、構成スナップショットを参照してください。

制御

制御タブには、デバイスに送信されるオペレーションが一覧表示されます。操作方法については、オペレーションの操作を参照してください。

Operations

ネットワーク

ネットワークタブでは、デバイスのネットワークの構成設定ができます。

ソフトウェア

ソフトウェアタブでは、デバイスのファームウェアとデバイスにインストールされているソフトウェアを管理および更新できます。

新しいファームウェアをインストールするには、ファームウェアのインストールをクリックし、ファームウェアリポジトリからファームウェアイメージを選択し、インストールをクリックします。

同様に、デバイスにソフトウェアをインストールするには、ソフトウェアのインストールをクリックし、ソフトウェア・リポジトリからソフトウェアパッケージを選択し、インストールをクリックします。

Software

ソフトウェアおよびファームウェアのインストールには、通常、デバイスの再起動が必要になります。制御タブよりインストールの進行状況を監視することができます。

デバイスからソフトウェアを削除するには、特定のソフトウェアパッケージの上にカーソルを置き、削除ボタンをクリックします。

イベント

イベントタブには、デバイスに関連するイベントが表示されます。これにより、デバイスの低レベルのトラブルシューティングが可能になります。詳細は、デバイスのトラブルシューティングを参照してください。

位置

位置タブには、デフォルトとして、デバイスから送信されるマップ上でのデバイスの位置と座標が表示されます。位置を送信しないデバイスの場合は、手動で位置を設定できます。表示されたマップの正しい位置に「ピン」を配置するだけで設定されます。

位置タブは、デバイスにc8y_Positionプロパティが含まれる場合にも表示されます。新しいc8y-positionイベントを送信する時に、同じc8y-Positionフラグメントをデバイスに設定すれば、マップ上のその位置に自動的にマークを付けることができます。

ログ

ログタブでは、デバイスからのログ情報を要求できます。ログ情報は、日付範囲、ログタイプ、キーワード、および転送する最大行数に基づいてフィルタリングできます。

ログタブで、トップメニューバーの右側にあるログファイルをリクエストをクリックします。

次のウィンドウで、ログ情報の以下の設定を指定します。

  • 日付と時刻の範囲。
  • ログのタイプ。リストにあるサポートされているログは、通常はデバイス固有です。
  • ログをフィルタするための任意的なテキスト。たとえば、「user」と入力すると、「user」という単語を含む行のみが返されるログ情報に表示されます。
  • 表示する最終行を指定します。デフォルト値は1000です。

ログを要求をクリックして、指定したデバイスのログ情報を要求します。

Request Logs

デバイスからのログの要求には時間がかかる場合があります。

ログがデバイスからThings Cloudに転送されると、画面に一覧表示されます。一覧の内容には、要求されたログの時間範囲が含まれます。

内容をクリックすると、ログ情報が画面に表示されます。

一覧の内容の一つの上にカーソルを置くと、ダウンロードボタンと削除ボタンが表示されます。ダウンロードボタンをクリックして、ログの抜粋をローカルPCにダウンロードします。削除ボタンをクリックして、ログファイルを削除します。

サービス監視

接続監視に加えて、Things Cloudでは機器に対しての個別のサービス監視を提供しています。詳細については、サービス監視を参照してください。

シェル

デバイスシェルを使用すると、リモートデバイスを対話的に操作できます。多くの産業用機器は、モデム用のATコマンド、多くの追跡装置用のCSV形式のコマンド、あるいはTixi TiXMLのような精巧なスクリプト機構など、何らかの形式のコマンド言語をサポートしています。シェルでは、デバイスの各言語でコマンドを送信し、コマンドの結果をインタラクティブに表示できます。

シェルタブには、コマンドを入力するためのコマンドプロンプトが表示されます。

コマンドプロンプトには、任意のコマンドテキストを入力できます。コマンドテキストをデバイスに送信するには、実行をクリックします。このボタンは、デバイスがオンラインの場合にのみアクティブになります。

トップメニューバーの右側にある履歴を表示をクリックして、以前に実行したコマンドを一覧表示します。既定では、最新の3つのコマンドが表示されます。 一覧には、コマンドのステータス、日付、およびテキストが表示されます。一覧の項目をクリックすると、コマンドの結果が表示されます(実行された場合)。

Device shell

Things Cloudにはいくつかのデバイスで頻繁に使用されるコマンドが用意されています。トップメニューバーの右側にある>_定義済みのコマンドを取得をクリックすると、使用可能な事前定義済みコマンドのリストを含むウィンドウが開きます。目的のコマンドを選択し、使用をクリックしてそのコマンドをコマンドプロンプトにコピーするか、または、実行をクリックしてコマンドをすぐに実行することができます。ここに新規コマンドを追加して再利用することも可能です。

シェルコマンド

トラッキング

デバイスはThings Cloudでの移動の履歴を記録することができます。この移動はトラッキングタブに表示されます。

注記: トラッキングタブは、デバイスにc8y_Positionプロパティが含まれている場合にのみ表示されます。

右上のドロップダウンリストより、期間を選択(または、リストから「カスタム」を選択して期間を指定)し、その期間中のデバイスの動きを表示できます。動きは、赤い線としてマップ上に表示されます。

Tracking

マップの横に、個々の記録とその時間が一覧表示されます(「位置更新イベント」)。録画をクリックすると、マップ上の「ピン」に録画時の場所が表示されます。

デバイスのタイプとThings Cloudへの統合方法に応じて、デバイス側のジオフェンシングとモーション検出を設定できます。

Info:この機能が有効で、デバイスに互換性がある場合、セルID情報を使用してデバイスの位置を特定できます。現在、CombainおよびGoogleのサービスがサポートされています。ユーザーは、両方のデータに基づいてトラックを見ることができ、あるいはGPSベースのデータまたはセルIDベースのデータを除外することができる。

固有情報

Things Cloud は、デバイスとアセットを複数の外部IDに関連付けることができます。たとえば、多くの場合、デバイスはモデムのIMEI、マイクロコントローラのシリアル番号、または資産タグによって識別されます。固有情報タブには、特定のデバイスについて記録されたすべてのIDが一覧表示されます。

これは、機能しないハードウェアがあり、記録されたデータを失わずにハードウェアを交換する必要がある場合などに便利です。新しいハードウェアをアカウントに接続し、古いハードウェアのIDを変更して、新しいハードウェアのIDを含めることで対応できます。

デバイスの監視と制御

デバイスの特定

Things Cloudには、アカウント内のすべてのデバイスをマップ上に表示するオプションがあります。

ナビゲータのデバイスメニューで地図をクリックすると、すべてのデバイスをリアルタイムで示す地図が表示されます。

デバイスは「ピン」として表されます。ピンをクリックすると、各デバイスの名前が表示されます。デバイス名をクリックして、デバイスの詳細に切り替えます。

Device Map

接続監視

デバイス管理アプリケーションには、デバイスへの接続を監視するオプションがあります。

これは、個々のデバイス(下記参照)の階層で実行することも、デバイスリスト内の複数のデバイスにわたって実行することもできます。

複数のデバイスの接続を監視するには、任意のデバイスリストを開きます。

接続ステータスは、デバイスリストのステータス列に矢印で示されます。

Connection Status

接続の送信

上矢印は、送信接続(デバイスからThings Cloudへのトラフィック)を表します。送信接続のステータスは、次のいずれかになります。

  • オンライン(要求された間隔でデータが送信されている):緑色の矢印で示されます。
  • オフライン(要求された間隔内でデータの送信がされていない):赤い矢印で示されます。
  • 不明または監視されていない(間隔が設定されていない):灰色の矢印で示されます。

矢印にカーソルを合わせると、デバイスからサーバーへの最後の要求のタイムスタンプが表示されます。

デバイスがオフラインであることが検出されると(要求された間隔内でのデータ送信が停止され、上矢印が赤色に変わっている)、「要求された間隔内にデバイスからデータを受信しませんでした」という、デバイスの使用不可アラームが作成されます。

プッシュ接続

下矢印は、(Things Cloudからデバイスへの)プッシュ接続を表します。プッシュ接続のステータスは、次のいずれかになります。

  • オンライン(接続確立):緑色の矢印で示されます。
  • オフライン(接続が確立されていない):赤い矢印で示されます。
  • 監視されていない:灰色の矢印で示されます。

Info:プッシュ接続とは、Things Cloudから/devicecontrol/notifications APIへの接続であり、リアルタイムAPIへの接続ではありません。

メンテナンスモード

デバイスは、ステータス列にツールアイコンで示される「メンテナンス」モードである場合があります。これは、デバイスが現在メンテナンス中で監視できないことを示す特殊な接続ステータスです。メンテナンス中のデバイスは、アラームが発生しません。

デバイスのメンテナンスモードのオン/オフを切り替えるには、情報タブにある接続監視カードのスライダを使用します。

「情報」タブでの接続監視

特定のデバイスの接続を監視するには、このデバイスの情報タブに移動します。デバイスのステータスの下に、デバイスの接続ステータスが表示されます。

Device Status

送信接続状態、プッシュ接続状態の下に前回の通信時刻が表示されます。

Info:「最終更新日」と「前回の通信」はまったく異なるタイムスタンプです。「前回の通信」は、デバイスが最後にデータを送信した日時を示します。「最終更新日」は、デバイスのインベントリのエントリが最後に更新された日時を示します。この更新は、デバイス、Webユーザーインタフェース、または別のアプリケーションから行われる場合があります。

で、必要な間隔の欄では、間隔を指定できます。このパラメータは、デバイスからの受信頻度を定義します。例えば、必要な間隔を60に設定した場合、デバイスは少なくとも1時間に一度はThings Cloudと通信することになります。この間隔は、デバイスがデータの送信を試みる頻度に基づいてデバイス自体が設定するか、ユーザーが手動で設定します。

間隔を設定すると、その下にメンテナンススライダが表示されます。

メンテナンススライダを使用して、デバイスのメンテナンスモードをオンまたはオフにすることができます。このモードは、接続ステータスに即座に反映されます。

Device status maintenance

Info:接続監視はリアルタイムではありません。つまり、デバイスの電源を切っても、接続状態はすぐには変更されません。ネットワークによっては、切断された接続が検出されるまでに約20分かかることもあります。これは、ネットワークがかなりの時間データ送信を再試行するためです。

サービス監視

Things Cloudは、接続監視とサービス監視を区別します。前述にある接続監視は、デバイスがThings Cloudと通信しているかどうかを示すだけで、デバイスが機能しているかどうかを自動的に示すわけではありません。

サービス監視とは、デバイスがサービス中かどうかを示します。たとえば、商品を販売する準備ができていれば、自動販売機はサービス中となります。自動販売機はThings Cloudとは無関係に現金で商品を販売することができるので、商売人の立場から言うと、サービス中となるのです。同様に、ゲートウェイの電源をオフにしても、ゲートウェイの背後にあるデバイスは引き続き動作できます。

Things Cloudは、機器にクリティカルな未解決アラームが存在しないかぎり、デバイスが使用中であると見なします。そして、そのようなクリティカルアラームが存在した時間の割合を表示します。たとえば、ある期間中もし機器にクリティカルアラームがまったくない場合は、その機器のサービス稼働率は100%とされ、もし半分の時間にクリティカルな未解決アラームが発生していた場合は、その機器のサービス稼動率は50%とされます。

機器がオフラインの間、既定としてThings Cloudは、

  • 接続が切断される前の状態がサービス中であれば、接続が切断されても機器はサービスを継続します。
  • 接続が切断される前の状態がサービス停止中であれば、機器はサービスを停止し続けます。

この規則には例外もあります。たとえば、自動販売機がキャッシュレス決済のみに依存している場合、ネットワークへの接続が失われると、自動販売機のサービスが停止し、販売が停止します。この場合、機器の使用不可アラームは、メジャーではなくクリティカルアラームがあるアドミニストレーションアプリケーションで設定する必要があります。

Things Cloudは個々のデバイスの階層、およびすべてのデバイスにわたってサービスの可用性を表示します。

特定のデバイスのサービス監視を確認するには、そのデバイスの詳細にあるサービスの監視タブをクリックします。

すべてのデバイスにわたるサービス全体を表示するには、ナビゲータでサービスの監視をクリックします。

Service monitoring

サービスの監視画面には、最終日、先週、先月のデバイスの可用性の割合が表示されます。

アラームの操作

デバイスは、アラームを発生させて、介入が必要な問題があることを示すことができます。

Things Cloudは個々のデバイスの階層、およびすべてのデバイスにわたってアラームを表示します。

  • ナビゲータの 「概要」 メニューで 「アラーム」 をクリックし、すべてのデバイスのアラームを確認します。
  • デバイスの詳細画面でアラームタブに切り替えて、そのデバイスのアラームを確認します。

Alarms

デフォルトでは、

  • 未解決のアラームのみが表示されます。トップメニューバーの右側にあるクリアされたアラームを表示をオンにすると、アラーム履歴全体が表示されます。
  • デバイスからのアラームはリアルタイムで表示されます。トップメニューバーのリアルタイムをクリックして、リアルタイム更新を使用不可にします。

アラームは、その重要度に従って分類されます。Things Cloudには、次の4種類のアラームがあります。

重要度 説明
クリティカル デバイスは使用できません。すぐに修復する必要があります。
メジャー デバイスに問題があり、解決する必要があります。
マイナー デバイスに問題があり、解決できる可能性があります。
警告 警告があります。

アラームタブは、これらのアラームタイプに対応する4つのセクションに分かれています。

上部のボタンをクリックすると、対応するセクションが非表示になります。もう一度クリックすると、再度表示されます。

各セクション内で、アラームは発生順にソートされ、最新のアラームが最初に表示されます。

各行には、アラームに関する次の情報が表示されます。

情報 説明
重要度 クリティカル、メジャー、マイナー、警告(上記参照)のいずれかです。
カウント このアラームがデバイスによって送信された回数です。特定のデバイスに対してアクティブにできるアラームの種類は1つだけです。同じ種類の別のアラームがデバイスから送信されると、番号は1ずつ増加します。
説明 アラームを説明する任意のテキスト。
ステータス アラームのステータス。アラームには次のようなものがあります。
アクティブ:アラームが発生した時点で、誰もそのアラームに取り組んでいません。
了承済み:誰かがステータスを「了承済み」に変更した場合、その人がアラームの対応中であることを示します。
クリア:誰かが手動でステータスを「クリア」に設定した場合、またはデバイス自体が問題の解決を認識した場合。
最後の発生時 アラームが最後に発生したタイムスタンプ(デバイス時刻)。
デバイス デバイスの名前です。名前をクリックすると、デバイスの詳細画面に移動します。

行の右側にある矢印をクリックして展開し、アラームの詳細を表示します。

  • ステータス:アラームのステータスに関する詳細情報とアラームのタイプを表示します。タイプの情報は、アラームの複製と、アドミニストレーションアプリケーションでのアラームの優先順位の設定に使用されます。
  • 変更ログ:アラームが作成されたサーバー時刻 (デバイス時刻と異なる場合があります) を提供します。

アラームのステータスを変更するには、アラームの上にカーソルを置き、目的のステータスのボタンをクリックするか、メニューアイコンをクリックして、目的のステータスを選択します。

Alarm change status

すべてのアラームのステータスを一度に「クリア」に変更することもできます。トップメニューバーの全てをクリアをクリックして、選択した重要度のすべてのアラームをクリアします。

オペレーションの操作

オペレーションは、デバイスのリモート制御に使用されます。

Things Cloudは個々のデバイスの階層、およびすべてのデバイスにわたって操作を表示します。

  • ナビゲータの概要メニューでデバイス制御をクリックし、すべてのデバイスの操作を表示します。
  • デバイスの詳細画面で制御タブに切り替えて、このデバイスの操作を確認します。

Device Control

操作は、次の4つの状態のいずれかになり、それぞれのアイコンで示されます。

状態 説明
保留中 操作は作成されたばかりで、デバイスが操作を取得するのを待っています。
実行中 操作はデバイスによって取得され、実行中です。
成功 操作はデバイスによって正常に実行されました。
失敗 デバイスで操作を実行できませんでした。

上部のステータスボタンの1つをクリックすると、対応する操作が非表示になります。もう一度クリックすると、操作が再度表示されます。

トップメニューバーの右側にあるリアルタイムをクリックすると、デバイスからの操作がリアルタイムで表示されます。

操作は時間の降順で一覧表示されます。操作はこの順序に従って厳密に実行されます。

操作ごとに、次の情報が表示されます。

情報 説明
状態 承認待ち、実行中、成功、失敗のいずれかです(上記参照)。
名前 操作の名前。
デバイス デバイスの名前です。名前をクリックすると、デバイスの詳細画面へ移動します。

行をクリックすると展開され、操作の詳細が表示されます。

  • 詳細:操作名とステータスに関する情報を提供します。status=FAILEDの場合は、失敗の理由が表示されます。
  • 変更履歴:操作の過去の変更に関する情報を提供します。

Operation Details

一括操作

デバイスの扱いを容易にするため、Things Cloudでは一括操作が行えます。一括操作では、1つのグループ内に所属する複数デバイスに対して一度に操作を実行できます。

グループに対して一括操作を実行するには、次の手順に従います。

  1. デバイスを選択し、制御タブを開きます。
  2. 操作を作成します。
  3. 実行する操作にカーソルを合わせます。
  4. メニューアイコンをクリックします。
  5. コンテキストメニューで、グループ全体に対して実行をクリックします。

Execute bulk operations

操作のステータスと進行状況を表示するには、目的のグループを選択して、一括操作タブをクリックします。

Bulk operations tab

一括操作を編集するには、次の手順に従います。

  1. 編集する一括操作にカーソルを合わせ、メニューアイコンをクリックします。
  2. コンテキストメニューで、操作スケジュールの編集をクリックします。
  3. 次のウィンドウで、開始日遅延の値を変更できます。
  4. 操作の詳細を変更するには、操作の詳細を表示をクリックします。
  5. 再スケジュール」をクリックして変更を適用します。

Edit bulk operations

一括操作を削除するには、削除する一括操作の上にカーソルを置き、メニューアイコンをクリックします。コンテキストメニューで、操作をキャンセルをクリックします。

デバイスのトラブルシューティング

デバイスのトラブルシューティングをより詳細なレベルで行うには、イベントを使用します。イベントは通常、アプリケーション固有の処理に使用されるデバイスから送信される低レベルのメッセージです。たとえば、自動販売機は、イベントの形式でリアルタイムの売上を送信します。

Things Cloud は個々のデバイスの階層で、すべてのデバイスにわたってイベントを表示します。

  • デバイスのイベントを表示するには、イベントタブをクリックします。
  • すべてのデバイスの操作を表示するには、ナビゲータの 「概要」 メニューで 「イベント」 をクリックします。

Events

デフォルトでは、イベントはリアルタイムでデバイスから受信したものとして表示されます。リアルタイム更新を無効にするには、トップメニューバーの右側にあるリアルタイムをクリックします。

イベントごとに、次の情報が表示されます。

情報 説明
タイムスタンプ イベントが実行されたときのタイムスタンプ。
名前 イベントの名前。
デバイス イベントを送信しているデバイスの名前です。名前をクリックすると、デバイスの詳細画面に移動します。

イベントリストの一番上に最新のエントリが表示されます。

行をクリックすると、その行が展開され、(デバイスのタイプと位置として)イベントの詳細が表示されます。

デバイスから大量のイベントデータが送信される場合があるため、データを日付別にフィルタリングして表示できます。

トップメニューバーのフィールドから開始日と終了日を選択し、フィルタボタンをクリックしてフィルタを適用します。フィルタを再度クリアするには、クリアボタンをクリックします。

デバイスタイプの管理

さまざまなデバイスタイプからのデータを処理するために、Things Cloudはデバイスプロトコルを使用します。

デバイスタイプメニューのデバイスデータベースをクリックして、デバイスプロトコル画面にアクセスします。

デバイスデータベース画面には、アカウントで使用可能なすべてのデバイスプロトコルの一覧が表示されます。

Device protocols

デバイスプロトコルの一覧には、各デバイスに関する次の情報が表示されます。

  • デバイスのプロトコル・タイプ(IMPACT, LWM2M)
  • デバイスタイプ名
  • デバイスのリソース数(右)

新規デバイス・プロトコルを追加するには、トップバーのデバイスプロトコルを追加をクリックします。デバイスプロトコルの追加の詳細については、追加する特定のデバイスタイプのマニュアルを参照してください。

デバイスプロトコルを編集するには、プロトコルをクリックするか、行の右側にあるメニューアイコンをクリックしてコンテキストメニューで編集をクリックします。

デバイスプロトコルを削除するには、コンテキストメニューで削除をクリックします。

デバイスデータの管理

デバイスのファームウェアとソフトウェアの管理

Things Cloudは、ファームウェアとソフトウェアリポジトリにて、各デバイスの参照ファームウェアとソフトウェアを収集しています。

以下では、ファームウェアを例示していますが、デバイスソフトウェアにも適用されます。

ナビゲータの管理メニューからファームウェアリポジトリを開きます。

利用可能なファームウェアオブジェクトが表示され、グリッド内にカードとして表示されます。

Firmware List

特定のオブジェクトのカードを「裏返し」にするには、そのオブジェクトの詳細をクリックし、詳細を表示します。

オブジェクト名とバージョンのほかに、ファームウェアが格納されているファイルの名前も表示されます。

さらに、複数のボタンより情報を更新することができます(下記の「ファームウェアオブジェクトを追加する方法」も参照してください。)。

ファームウェアオブジェクトの追加方法

ファームウェアオブジェクトを追加するには、以下の手順に従ってください。

  1. ファームウェアファイルを管理アプリケーションにアップロードします。製造元によってはファームウェアをオンラインで提供しているため、この手順は必ずしも必要ではありません。
  2. ファームウェアリポジトリ画面で、トップバーメニューの右側にあるファームウェアを追加をクリックします。
  3. 表示されるウィンドウで、ファームウェアの名前とバージョンを入力します。
  4. ファームウェアのファイルを選択またはアップロードして指定するか、デバイスがファームウェアをダウンロードできるURLを入力します。
  5. 保存をクリックして設定を保存します。

同様に、新しいソフトウェアオブジェクトをソフトウェアリポジトリに追加できます。

デバイスへのファームウェアのインストール方法

ナビゲータですべてのデバイスをクリックしてデバイスリストを開き、デバイスリストからデバイスを選択します。

デバイスのソフトウェアタブを開き、ファームウェアをインストールをクリックします。

これらの手順の詳細については、ソフトウェアタブの説明を参照してください。

Info:Things Cloudに他の種類のバイナリを保存するには、管理アプリケーションに切り替えてください。

複数のデバイスへのファームウェアのインストール方法

Things Cloudには、複数のデバイスのファームウェアまたはソフトウェアのアップデートを同時に実行することができます。 次の手順に従ってください。

  1. 1つのデバイスでソフトウェアアップデートを実行し、新バージョンが実際に動作することをテストしてください。
  2. 操作に移動し、グループ全体に対して実行を選択します。
  3. 表示されたフォームに入力して一括操作をスケジュールし、作成をクリックします。

選択したグループの一括操作タブに操作のステータスが表示されます。詳細は、一括操作を参照してください。

デバイス資格情報の管理

デバイス資格情報タブには、接続されているデバイスに対して生成されたすべての資格情報が表示されます。登録済みの各デバイスは、「device_<id>」という命名規則でここに表示されます。

デバイスのグローバルロール列にある矢印をクリックすると、使用可能なグローバルロールのリストが開きます。ロールを選択または選択解除して個々のデバイスの権限を割り当てまたは削除し、適用をクリックして設定を保存します。

デバイスの右側にあるメニューアイコンをクリックして、次の機能にアクセスします。

  • 編集-デバイス資格情報の詳細を開きます(下記参照)。

  • 無効化-デバイスを一時的に切断します。

  • 削除-デバイスの資格情報を削除します。これは、デバイスの出荷時リセットを実行した場合に必要になることがあります。この場合、デバイスに割り当てられた資格情報が失われることがよくあります。デバイスを一度削除し、通常の登録処理を続行してデバイスを再登録します。

デバイス資格情報の詳細画面で、次の操作を実行できます。

  • アクティブスライダを使用してデバイスを無効/有効にします。
  • デバイスのパスワードを変更します。
  • グローバルロールリストでロールを選択または選択解除することにより、個々のデバイスの権限を割り当てまたは削除します。

Bulk provisioning

デバイスの資格情報は、CSVファイルからも提供できます。矢印の付いたボタンを使用してファイルをアップロードできます。ファイル構造の詳細については、上記のデバイスの一括登録を参照してください。-->

構成リポジトリ

Things Cloudでは、構成データを取得し、構成リポジトリに格納して管理することができます。構成データには、デバイスのパラメータと初期設定が含まれます。

構成スナップショットは、たとえば、次に説明するように、同じ構成を複数のデバイスに適用する場合に役立ちます。

ナビゲータの 「管理」 メニューから開く 「構成リポジトリ」 ページには、使用可能なすべての構成が表示されます。各エントリには、構成名、設定がアップロードされたデバイス、アップロードのタイムスタンプが表示されます。

Configuration Repository

リスト内の構成をクリックして開きます。ここで構成を変更し、保存をクリックして適用できます。フィールドの詳細については、次のセクションを参照してください。

Configuration Repository

ファイルから構成スナップショットを追加する方法

ファイルから新しい構成を追加するには、次の手順に従います。

  1. トップメニューバーの右側にある構成スナップショットを追加をクリックします。
  2. 次のウィンドウで、構成設定の固有の名前と説明を入力します。
  3. デバイスタイプ欄にデバイスタイプを入力します。デバイスタイプは、対象デバイスの情報タブに表示されます。
  4. ファイルをアップロードするか、選択するか、または外部URLを入力して、構成スナップショットファイルを指定します。
  5. 構成スナップショットを追加をクリックして設定を保存します。

スナップショットが構成リポジトリに追加されます。

Configuration Snapshot Repository

デバイスから現在のスナップショットを取得する方法

ファイルから構成を追加するだけでなく、デバイスから構成を取得して追加することもできます。

デバイスから現在の構成スナップショットを取得するには、次の手順に従います。

  1. 目的のデバイスに移動し、構成タブを開きます。
  2. 構成スナップショットで、右上にあるデバイスより新規スナップショットを取得をクリックします。

取得したスナップショットは、ナビゲータの管理メニューからアクセスできる構成リポジトリにあります。

Retrieve Configuration Snapshot

構成スナップショットをデバイスに適用する方法

構成設定スナップショットをデバイスに適用するには、次の手順に従います。

  1. 目的のデバイスに移動し、構成タブを開きます。
  2. 構成スナップショットで、ドロップダウンフィールドから構成を選択します。
  3. 新規スナップショットをデバイスに追加をクリックして、選択したスナップショットをデバイスに適用します。

Apply new snapshot to a device

あるデバイスから別のデバイスへ構成スナップショットを適用する方法

あるデバイスから別のデバイスに構成スナップショットを適用するには、次の手順に従います。

  1. 目的の構成を持つデバイスに移動し、構成タブを開きます。
  2. 構成スナップショットで、右上にあるデバイスより新規スナップショットを取得をクリックします。
  3. 他のデバイスに移動し、その構成タブを開きます。
  4. 構成スナップショットで、ドロップダウンフィールドから新しい構成を選択し、新規スナップショットをデバイスに加えるをクリックします。

Info:あるデバイスから別のデバイスへ構成設定スナップショットを適用する際、構成設定内にデバイス固有のデータが含まれる場合があります。

SmartRESTテンプレート

はじめに

SmartRESTテンプレートとは、CSVデータとThings Cloud Rest APIコールを変換するために使用される要求テンプレートと応答テンプレートのコレクションです。たとえば、毎回手動で要求を作成する代わりに、SmartRESTテンプレートを使用することでデバイスをプラットフォームに簡単に追加できます。

デバイスの統合を容易にするために、Things Cloudは独自のテンプレートを作成することなく使用できる静的テンプレートに対応しています。これらのテンプレートは、デバイス管理に最もよく使用されるメッセージのみに焦点を当てています。 ナビゲータのデバイスタイプメニューからSmartRESTテンプレートリストを開きます。

template view

テンプレートごとに、次の情報が表示されます。

  • テンプレート名 (例:Camel)
  • テンプレートID (例:99)
  • 送信メッセージ数
  • 応答数

SmartRestテンプレートを追加するには、次の2つの方法があります。

  • 既存のテンプレートをインポート。
  • 新規テンプレートを作成。

既存のSmartRESTテンプレートをインポートする方法

  1. トップメニューバーの右側にあるインポートをクリックします。
  2. 次のウィンドウで、アップロードするファイルをブラウズして選択します。
  3. テンプレート名と固有テンプレートID(両方必須)を入力します。
  4. インポートをクリックして、テンプレートをインポートします。

Import template

新規SmartRESTテンプレートの作成方法

  1. トップメニューバーの右側にある新規をクリックします。
  2. 次のウィンドウで、テンプレート名と固有テンプレートID(両方必須)を入力します。
  3. 続行をクリックして、メッセージまたは応答の追加を続行します。

Create template

メッセージの追加方法

メッセージテンプレートには、SmartRest要求を対応するRest API呼び出しに変換し、プラットフォームに送信するために必要なすべての情報が含まれています。

新しいメッセージを追加するには、希望するSmartRESTテンプレートのメッセージタブに移動し、メッセージを追加をクリックします。次のフィールドに入力します。

フィールド 説明
メッセージID メッセージ識別子として使用される一意の整数。すべてのメッセージテンプレートと応答テンプレートで一意である必要があります。
名前 メッセージの名前。必須。
対象REST API ターゲットのREST API。ドロップダウンリスト。メジャーメント、インベントリ、アラーム、イベント、操作のいずれかです。
方法 Requestの方法です。選択したターゲットREST APIに応じて、POST、PUT、GETのいずれかになります。
応答を含める 要求の結果を応答テンプレートで処理する場合は、このチェックボックスを選択します。
REST API組み込みフィールド これらのフィールドはオプションであり、選択したターゲットREST APIによって異なります。値が提供されない場合、デバイスは、実際のメッセージを送信するときに設定できます。
REST APIカスタムフィールド フィールドを追加するには、フィールドを追加をクリックします。APIキーを入力し、目的のデータ型を選択します。

Message

プレビューより、要求メッセージのプレビューが見れます。

保存をクリックして設定を保存します。

メッセージを削除するには、メッセージを開き、一番下にある削除をクリックします。

レスポンスを追加する方法

レスポンステンプレートには、プラットフォームREST APIコールの応答からデータ値を抽出するために必要な情報が含まれており、そのデータ値はCSVデータフォーマットでクライアントに送り返されます。

新規のレスポンスを追加するには、目的のSmartRESTテンプレートのレスポンスタブに移動し、レスポンスを追加をクリックします。次のフィールドに入力します。

Response

フィールド 説明
レスポンスID レスポンスIDとして使用される一意の整数です。
名前 レスポンスの名前。必須。
基本パターン レスポンスの基本パターン。
条件 レスポンスの条件値。
パターン 少なくとも1つのパターンが必要です。パターンを追加をクリックし、パターン値を入力します。

保存をクリックして設定を保存します。

レスポンスを削除するには、応答を開き、一番下にある削除をクリックします。

SmartRESTテンプレートの編集または削除方法

SmartRESTテンプレートを編集するには、目的のテンプレートをクリックするか、メニューアイコンをクリックしてコンテキストメニューで編集をクリックします。

SmartRESTテンプレートを削除するには、コンテキストメニューで削除をクリックします。

SmartRESTテンプレートのエクスポート方法

SmartRESTテンプレートをエクスポートするには、メニューアイコンをクリックし、メニューにあるエクスポートをクリックします。テンプレートは自動的にダウンロードされます。

SmartRESTテンプレートをCSVファイルとしてエクスポートするには、次の手順に従います。

  1. 選択したテンプレートを開き、CSVプレビュータブを選択します。
  2. メッセージと応答に関する追加情報を提供するCSVプレビュータブにある、CSVエクスポートをクリックします。
  3. 次のウィンドウで、フィールド区切り記号、小数点区切り記号および文字セットの優先オプションを指定します。
  4. ダウンロードをクリックして、テンプレートをCSVファイルとしてダウンロードします。

シミュレーターの操作

Things Cloudシミュレーターを使用して、IoTデバイスのすべての側面をシミュレートすることができます。

  • シミュレートされたデバイスまたはシミュレートされたデバイスのネットワークの設定。
  • デバイスが処理できる操作の指定。
  • 事前定義のメッセージテンプレートまたはユーザー定義のテンプレートに基づいて作業指示を作成し、作業ステップをスケジュールします。
  • 定義されたタイプのデバイスを最大10個作成
  • メジャーメント、アラーム、イベント、およびインベントリに関するメッセージの生成
  • シミュレーションの問題をアラームとして表示

シミュレーターとは?

シミュレーターを使用すると、接続されたハードウェアデバイスと同じレベルの機能を持つ擬似的なデバイスを作成できます。

シミュレーターは、デバイスがThings Cloudプラットフォームに送信するメッセージをシミュレートするためにプレイリストを使用します。プレイリストとは、シミュレーターが次々に実行する一連の命令文のことです。最後の命令文に達すると、シミュレーターは最初の命令文へ戻り、再開します。

命令文とは、メッセージ(メジャーメント、アラーム、イベント、インベントリ)を送信するか、または、指定された時間待機をします(スリープ)。

メッセージを定義するには、メッセージテンプレート(温度を送る、など)を選択し、このテンプレートの値を入力します(23.0度)。メジャーメントの作成、イベントの送信、アラームの作成とキャンセルなど、多くの定義済みメッセージテンプレートが用意されています。これらのテンプレートはMQTT静的テンプレートに基づいています。さらに、SmartRESTテンプレートエディタを使用して、カスタム・メッセージ・テンプレートを定義できます。

シミュレーター タブ

ナビゲータで、デバイスメニューのシミュレーターをクリックし、シミュレーターページを開きます。

ここには、アクセスできるすべてのシミュレーターが表示されます。シミュレーターカードの右上にあるメニューアイコンをクリックすると、シミュレーターを編集、複製、または削除できるコンテキストメニューが開きます。

Simulator card

シミュレーターの作成方法

新規のシミュレーターを設定するには、次の手順に従います。

1. トップメニューバーの右側にある新しいシミュレーターをクリックします。 2. 次のウィンドウで、プリセットフィールドのドロップダウンリストからシミュレーターのタイプを選択します。「空のシミュレーター」を選択してシミュレーターを最初から作成するか、定義済みシミュレーターのいずれかを選択します。 3. シミュレーターにわかりやすい名前を入力します。 4. このシミュレーターのインスタンス数を選択します(最大10)。 5. 続行をクリックして、次のダイアログに進みます。

Add Simulator

命令

シミュレーターをセットアップした後、シミュレーターの動作を定義する命令文を追加できます。命令文はプレイリストに追加される1つのタスクで、シミュレーターはこのタスクに従って動作します。

命令文は、シミュレーターの「命令」タブで表示および編集できます。

Add Instructions

プリセット内には、サンプル説明がすでに追加されています。たとえば、「温度計測」プリセットには、「計測を作成する」と「スリープ」の手順がすでに含まれています。

右側のパネルは、左側で選択した説明のタイプに応じて変わります。

Add Instructions Step 2

メジャーメントの説明はフラグメントを参照します。フラグメントは、マネージドオブジェクトの機能を識別するために使用されます。フラグメントの詳細については、次を参照してください。 センサー・ライブラリ

「スリープ」には、継続時間の値が秒単位で必要です。

Add Instructions Step 3

サポートされている操作

シミュレーターのサポートされている操作タブでは、構成設定やソフトウェア/ファームウェアの更新などの特定のオペレーションをオンまたはオフにできます。

Operations Off

カスタム操作を追加をクリックして、カスタマイズしたオペレーションを指定し、一覧に追加します。

アラーム(シミュレーター)

シミュレーターのアラームタブには、(シミュレートされたデバイスではなく)シミュレーター自体に関するアラームが表示されます。つまり、シミュレーター自体が正しく動作しない場合は、ここにアラームが表示されます。アラームについては、アラームの操作を参照してください。

Simulator Alarm