デバイス位置の特定
Things Cloud は、アカウント内のすべてのデバイスを地図上で表示するオプションを提供します。
ナビゲータの デバイス メニューで 地図 をクリックすると、リアルタイムで表示されているすべてのデバイスを示す地図が表示されます。
デバイスは「ピン」として表示されます。ピンをクリックすると、対応するデバイスの名前が表示されます。デバイス名をクリックすると、そのデバイスの詳細に切り替わります。
接続監視
デバイス管理アプリケーションでは、デバイスへの接続を監視することができます。
これは、個々のデバイス（下記参照）の階層で実行でき、デバイス一覧の複数のデバイスにわたって実行することもできます。
複数デバイスの接続監視
デバイス一覧を開き、複数のデバイスの接続を監視します。
接続ステータスは、デバイス一覧の ステータス 列で矢印として示されます。
送信接続
上矢印は、送信接続（デバイスから Things Cloud へのトラフィック）を表します。送信接続のステータスは、次のいずれかになります。
- オンライン（必要な間隔内でデータが送信されている）：緑色の矢印 で示されます。
- オフライン（必要な間隔内でデータが送信されていない）： 赤い矢印 で示されます。
- 不明または監視されていない（間隔が設定されていない）： 灰色の矢印 で示されます。
矢印にカーソルを合わせると、デバイスからサーバーへの最後のリクエストのタイムスタンプが表示されます。
デバイスがオフラインであることが検出されると（必要な間隔内でのデータ送信が停止され、上矢印が赤色に変わる）、「指定間隔内にデバイスからの応答がありませんでした」という、デバイスの使用不可アラームが作成されます。
送信接続は、アラーム、イベント、メジャーメントなど、デバイスから何かが送信された場合、または空の更新がデバイス自体に送信された場合に更新されます。詳細については、デバイスの可用性を参照してください。
備考
デバイスのマネージドオブジェクトへの空の PUT リクエストによっても、送信接続が更新されます。このようなリクエストは、サーバーのステータスを監視するハートビート サービスを実装する場合の推奨方法です。
プッシュ接続
下矢印は（Things Cloud からデバイスへの）プッシュ接続を表します。プッシュ接続のステータスは、次のいずれかになります。
- オンライン（接続確立）： 緑の矢印 で示されます。
- オフライン（接続が確立されていない）： 赤の矢印 で示されます。
- 監視されていない： 灰色の矢印 で示されます。
プッシュ接続とは、/notification/operations API エンドポイントへのアクティブな HTTPS ロング ポーリング接続、または Things Cloud の MQTT エンドポイントへのアクティブな MQTT 接続です。デバイスが接続されている場合は、データがなくても常に緑色になります。
備考
接続監視はリアルタイムではありません。表示された接続ステータスは、デバイスの電源をオフにした直後には変更されるわけではありません。プッシュ接続の監視に使用されるプロトコルによっては、これに数分かかる場合があります。
メンテナンスモード
デバイスは、「メンテナンス」モードである場合があり、ステータス 列にツールアイコン で示されます。これは、デバイスが現在メンテナンス中で監視できないことを示す特殊な接続ステータスです。メンテナンス中のデバイスは、アラームが発生しません。
デバイスのメンテナンスモードのオン/オフを切り替えるには、情報 タブにある 接続監視 カードのトグルを使用します（下記参照）。
特定デバイスの接続監視
特定のデバイスの接続を監視するには、このデバイスの 情報 タブに移動します。デバイスステータスの下に、デバイスの接続ステータスが表示されます。
データ送信接続、プッシュ接続のステータスの下に前回の通信時刻が表示されます。
備考
「前回の通信（最終通信）」と「最終更新日」はまったく異なるタイムスタンプです。「前回の通信（最終通信）」は、デバイスが最後にデータを送信した日時を示します。「最終更新日」は、デバイスのインベントリのエントリが最後に更新された日時を示します。この更新は、デバイス、Webユーザーインターフェース、または別のアプリケーションから行われる場合があります。
必要な間隔 フィールドでは、間隔を指定できます。このパラメータで、デバイスからの受信頻度を定義します。例えば、必要な間隔を 60 に設定した場合、デバイスは少なくとも 1 時間に一度は Things Cloud と通信することになります。この間隔は、デバイスがデータの送信を試みる頻度に基づいてデバイス自体が設定するか、ユーザーが手動で設定します。
間隔を設定すると、その下に メンテナンス トグルが表示されます。
メンテナンス トグルを使用して、デバイスのメンテナンスモードをオンまたはオフにすることができます。このモードは、デバイスステータスに即座に反映されます。
稼働率
Things Cloud は、接続監視と稼働率を区別します。前述にある接続監視は、デバイスが Things Cloud と通信しているかどうかを示すだけで、デバイスが機能しているかどうかを自動的に示すわけではありません。
稼働率とは、デバイスが稼働中かどうかを示します。例えば、商品を販売する準備ができていれば、自動販売機は稼働中となります。自動販売機は Things Cloud とは無関係に現金で商品を販売することができるので、商売人の立場から言うと、稼働中となるのです。同様に、ゲートウェイの電源をオフにしても、ゲートウェイの背後にあるデバイスは引き続き動作できます。
Things Cloud は、デバイスにクリティカルな未解決アラームが存在しない限り、デバイスが稼働中であると見なします。そして、そのようなクリティカルアラームが存在した時間の割合を表示します。例えば、ある期間中、もしデバイスにクリティカルアラームがまったくない場合、そのデバイスのサービス稼働率は 100% となり、もし期間中の半分はクリティカルな未解決アラームが発生していた場合、そのデバイスのサービス稼動率は 50% となります。
デバイスがオフラインの間、Things Cloud はデフォルトで次のように想定します。
- 接続が切断される前の状態が稼働中であれば、接続が切断されてもデバイスは稼働を継続していると認識します。
- 接続が切断される前の状態が稼働停止中であれば、デバイスは稼働を停止中とします。
この規則には例外もあります。例えば、自動販売機がキャッシュレス決済のみに依存している場合、ネットワークへの接続が失われると、自動販売機の稼働が停止し、販売が停止します。この場合、デバイスの使用不可アラームを、メジャーではなくクリティカルアラームとして、管理アプリケーション で設定する必要があります。
Things Cloud は個々のデバイスの階層、およびすべてのデバイスにわたってサービスの稼働率を表示します。
特定デバイスの稼働率を表示する
特定のデバイスの稼働率を確認するには、そのデバイスの詳細にある 稼働率 タブをクリックします。
すべてのデバイスの稼働率を表示する
すべてのデバイスにわたる全体の稼働率を表示するには、ナビゲータの デバイス メニューで 稼働率 をクリックします。
稼働率 ページには、過去 24 時間、過去 7 日間、過去 30 日間のデバイスの稼働率の割合が表示されます。
アラームの操作
デバイスは、アラームを発生させて、介入が必要な問題があることを示すことができます。
アラームの表示
Things Cloud は個々のデバイスレベル、およびすべてのデバイス全体にわたってのアラームを表示します。
- すべてのデバイスのアラームを確認するには、ナビゲータの 概要 メニューで アラーム をクリックします。
- 特定のデバイスのアラームを確認するには、デバイスの詳細画面で アラーム タブに切り替えます。
デフォルトでは、
- 未解決のアラームのみが表示されます。画面上部の フィルターアラーム ドロップダウンメニューで クリアされたアラームを表示 をオンにすると、すべてのアラーム履歴が表示されます。
- アラームリストは 30 秒ごとに自動的に更新されます。アラームリストの自動更新を停止するには、自動更新の無効化 をクリックします。
アラームは、その重大度に従って分類されます。Things Cloud には、次の 4 種類のアラームタイプがあります。
| 重大度 | 説明 |
|---|---|
| クリティカル | デバイスは使用できません。すぐに修復する必要があります。 |
| メジャー | デバイスに問題があり、解決する必要があります。 |
| マイナー | デバイスに解決可能な問題があります。 |
| 警告 | 警告があります。 |
トップメニューバーには、フィルターアラーム ドロップダウン リストが用意されています。表示する重大度を選択し 適用 をクリックします。
備考
フィルター ドロップダウンに表示される数字は、特定の重大度のアクティブなアラーム数を示します。一方、アクティブなアラームの横に青い円で表示されるカウントは、同じアラームが発生した回数を示します（以下の表も参照）。
アラームリスト 内では、アラームは発生順に並べられ、最新のアラームが最初に表示されます。
アラームリスト には、アラームに関する次の情報が表示されます。
| 情報 | 説明 |
|---|---|
| 重大度 | クリティカル、メジャー、マイナー、警告のいずれかです（上記参照）。 |
| カウント（青い円内に数字で表示） | このアラームがデバイスによって送信された回数。特定のデバイスに対してアクティブにできるアラームのタイプは 1 つだけです。同じタイプの別のアラームがデバイスから送信されると、数値は 1 つずつ増加します。 |
| 説明 | アラームを説明する任意のテキスト |
| ステータス | アラームのステータス。アラームには次のようなものがあります。 アクティブ： アラームが発生した時点で、誰もそのアラームに取り組んでいない状態 承認済み： 誰かがステータスを「承認済み」に変更し、アラームが対応中であることを示します クリア： 誰かが手動でステータスを「クリア」に設定、またはデバイス自体が問題の解決を検出した状態です。 |
| 最終発生日時 | アラームが最後に発生したタイムスタンプ（デバイス時間） |
| デバイス | デバイスの名前 |
アラームの詳細情報を表示するには、アラームリスト で該当するアラームをクリックします。
- ステータス： アラームのステータスに関する詳細情報を提供し、アラームのタイプを表示します。タイプ情報は、アラームの複製と、アラームマッピング によるアラームの優先順位の設定に使用されます。
- 監査ログ： アラームが作成されたサーバー時間を表示します。デバイス時間と異なる場合があります。
- 初回発生日時： アラームが最初に発生した時間に関する情報を提供します。
アラームのステータス変更
アラームのステータスを変更するには、対象アラームを選択し、目的のステータスをクリックします。
すべてのアラームのステータスを一度に「クリア」に変更することもできます。トップメニューバーの すべてをクリア をクリックして、選択した重大度のすべてのアラームをクリアします。
オペレーションの操作
操作は、デバイスをリモートで制御するために使用されます。
個々のデバイスレベル、およびすべてのデバイス全体にわたってオペレーションを表示することができます。
- すべてのデバイスの操作を表示するには、ナビゲータの概要メニューでデバイス制御をクリックします。
- 特定のデバイスの操作を表示するには、そのデバイスの詳細で制御タブに切り替えます。
デバイス制御には2種類の操作があり、それぞれタブで表されます。
- 単一操作は単一デバイスで実行されます。詳細については単一操作の表示を参照してください。
- 一括操作は、一連のデバイスで実行される同じ単一操作で構成されます。詳細については一括操作の表示を参照してください。
単一操作の表示
単一操作タブにある単一操作のリストを参照してください。
単一操作は、次の 4 つのステータスのいずれかになります。
| ステータス | 説明 |
|---|---|
| 保留中 (PENDING) | 操作が作成されたばかりで、デバイスが操作を取得するのを待っています |
| 実行しています (EXECUTING) | 操作がデバイスによって取得され、実行中です |
| 成功 (SUCCESSFUL) | 操作がデバイスによって正常に実行されました |
| 失敗 (FAILED) | 操作がデバイスによって実行できませんでした |
各行には、次の操作の情報が表示されます。
| 情報 | 説明 |
|---|---|
| ステータス | 保留中、実行しています、成功、失敗のいずれかになります（上記参照） |
| 名前 | 操作の名前 |
| デバイス | デバイス名。名前をクリックすると、デバイスの詳細画面に移動します |
行をクリックすると展開され、操作の詳細が表示されます。
- 詳細： 操作名とステータスに関する情報を提供します。ステータスが失敗の場合、失敗の理由が提供されます。単一操作が一括操作の一部である場合、一括操作の詳細も表示されます。
- 変更履歴： 操作の過去の変更に関する情報を提供します。
ステータス別に単一操作のリストをフィルタリングするには、トップメニューバーにあるステータスボタンのいずれかをクリックします。フィルターをクリアするには、すべてをクリックします。
トップメニューバーの右にある リアルタイム をクリックすると、デバイスからリアルタイムで送信される操作が表示されます。再読み込み をクリックして、リストを手動で更新します。
備考
操作は時間の降順で一覧表示されます。操作は厳密にこの順序に従って実行されます。
単一操作を追加して実行する
単一操作は、一括操作またはデバイスがサポートするさまざまなタイプの操作（ファームウェア、ソフトウェア、構成 の管理など）によって作成できます。
一括操作を作成すると、一括操作に含まれる単一操作も単一操作のリストに追加されます。
特定のデバイスの操作は、デバイスの シェル タブで作成および実行できます。詳細は、シェルを参照してください。
重要
Things Cloudを使用してデバイスをリモート操作する際は、すべてのリモート操作が安全基準に従い、危害を及ぼさないようにしてください。
保留中の単一操作をキャンセルする
特定の保留中の単一操作をキャンセルするには、該当する単一操作のエントリの右側にあるメニューアイコン をクリックし、操作をキャンセルを選択します。
単一操作からスマートルールを作成する
スマートルールを作成する単一操作の右側にあるメニューアイコン をクリックし、スマートルールを作成 を選択します。
詳細な手順については、スマートルールの作成を参照してください。
一括操作の表示
一括操作タブにある一括操作のリストを参照してください。
一括操作は、操作タイプとステータスがあります。
一括操作ウィザードを使用して、次の操作タイプの一括操作を追加できます。
| 操作タイプ | 説明 |
|---|---|
| 構成の更新 | 一括操作により、選択したデバイスの構成が更新されます。 |
| ファームウェア更新 | 一括操作により、選択したデバイスのファームウェアが更新されます。 |
| ソフトウェア更新 | 一括操作により、選択したデバイス上のソフトウェアが更新されます。 |
| デバイスプロファイルを適用 | 一括操作により、選択したデバイスにデバイスプロファイルが適用されます。 |
一括操作には他の操作タイプも含めることができます。例えば、単一操作を一括操作としてスケジュールする 場合、その単一操作には異なる操作タイプが指定されます。
一括操作は、次のいずれかのステータスになります。
| ステータス | 説明 |
|---|---|
| スケジュール済み (SCHEDULED) | 一括操作が作成され、スケジュールされた時間まで保留されています。 |
| 実行しています (EXECUTING) | 一括操作が実行中です。 |
| キャンセル済み (CANCELED) | 一括操作が作成されましたが、スケジュールされた時間の前にキャンセルされました。 |
| 完了しましたがエラーがあります (COMPLETED WITH FAILURES) |
一括操作は完了しましたが、一部のデバイスで失敗しました。 |
| 正常に完了 (COMPLETED SUCCESSFULLY) |
一括操作がすべてのデバイスで正常に実行されました。 |
各行には、一括操作に関する次の情報が提供されます。
| 情報 | 説明 |
|---|---|
| ステータス | スケジュール済み、実行中、キャンセル済み、失敗あり完了、正常終了のいずれか（上記参照） |
| 名前 | 操作の名前 |
| 進行状況バー | 実行および完了した一括操作のみ。操作の進行状況をパーセントで表示します。 |
| 開始日と終了日 | 実行および完了した一括操作のみ。一括操作を実行する場合、完了日は一括操作の設定に基づく、おおよその日付になります。 |
| 更新ボタン | 一括操作の実行専用。進行状況バーを更新します。 |
行の右側にある矢印ボタンをクリックすると、行が展開され、一括操作の詳細が表示されます。
- 詳細： 一括操作の開始日、遅延、ステータス、結果に関する情報を提供します。結果には、成功した操作、失敗した操作、保留中の操作の数が一覧表示されます。一括操作が 失敗した操作を再試行する 場合、再試行元の一括操作のインデックスを示す追加の行が存在します。インデックスをクリックして、その一括操作までスクロールします。一括操作を作成する ときに説明が追加された場合、この説明を示す追加の行が表示されます。
- 操作： JSONオブジェクトの形式で操作に関する情報を提供します。
- 操作（下段）： 一括操作を実行または完了する場合にのみ存在します。一括操作に伴う単一操作のステータスとデバイスに関する情報を提供します。ステータスごとにフィルタリングできます。また、操作 セクションの右上にある 失敗した操作を再試行 をクリックして、失敗したすべての操作を再試行するか、単一操作の上にカーソルを合わせてそのすぐ隣に表示される 操作を再試行 ボタンをクリックして、単一操作を再試行することもできます。失敗した操作の再試行 も参照してください。
- 変更履歴: 2 番目のタブに、一括操作の過去の変更に関する情報が表示されます。
一括操作のリストを操作タイプ別にフィルタリングするには、トップメニューバーのドロップダウンリストをクリックし、操作タイプのセットを選択し、適用 をクリックします。 フィルターをクリアするには、ドロップダウンリストですべてを選択し、もう一度適用をクリックします。
ステータス別に一括操作のリストをフィルタリングするには、トップメニューバーにあるステータスボタンのいずれかをクリックします。すべてのステータス をクリックしてフィルターをクリアします。
一括操作のリストを日付でフィルタリングするには、開始日時 と 終了日 の両方の日付ピッカーで日付を選択し、適用 をクリックします。フィルターをクリアするには、その隣にある クリア をクリックします。
両方のフィルターをクリアするには、リストの下部にある フィルターをリセット をクリックします（フィルターが適用されている場合のみ表示されます）。
一括操作の追加
一括操作を作成するには 2 つの方法があります。
ウィザードを使用して一括操作を追加する
次の手順を実行します。
- 一括操作タブで、トップメニューバーの右側にある 一括登録を追加 をクリックします。
- 表示されたダイアログで、操作タイプを選択します。
- 結果のウィザードには 4 つのステップがあります。 最初の 2 つのステップは操作のタイプによって異なります。
- 構成の更新
- リストから構成を選択します。リストは構成タイプまたは構成名でフィルタリングできます。次へ をクリックします。
- 選択した構成のプレビューを確認します。次へ をクリックします。
- ファームウェア更新
- リストからファームウェアを選択します。リストはファームウェア名でフィルタリングできます。次へ をクリックします。
- バージョンを展開し、パッチを選択します。次へ をクリックします。
- ソフトウェア更新
- リストからソフトウェアを展開し、バージョンを選択し、ドロップダウンリストからソフトウェアのインストール/更新または削除を選択します。利用可能なソフトウェアのリストは。デバイスタイプ、ソフトウェアタイプ、ソフトウェア名でフィルタリングできます。次へ をクリックします。複数のデバイスタイプのソフトウェアを選択した場合、サポートされていないソフトウェアが原因で一部の操作が失敗する可能性があるという警告ダイアログが表示され、確認が求められます。
- 選択内容を確認し、次へ をクリックします。
- デバイスプロファイルを適用
- リストからデバイスプロファイルを選択します。リストはデバイスタイプまたはプロファイル名でフィルタリングできます。次へ をクリックします。
- 選択内容を確認し、次へ をクリックします。
- すべてのデバイスのページ分割されたリストにフィルターを適用して、ターゲットデバイスを選択します。ステータス、名前、タイプ、モデル、グループ、登録日、アラームでフィルタリングできます。複数のフィルターを適用できます。フィルターを適用するには、列ヘッダーをクリックし、コンテキストメニューでフィルターオプションを選択し、適用 をクリックします。グループフィルターでは、サブグループでフィルタリングすることもできます。サブグループがある場合は、グループの右側にある矢印ボタンをクリックし、ドロップダウンから目的のサブグループを選択します。リストの上にあるフィルターをクリアをクリックすると、すべてのフィルターをクリアできます。操作タイプ「構成の更新」、「ソフトウェア更新」、「デバイスプロファイルを適用」については、リストはすでに該当するデバイスタイプでフィルタリングされています。次へ をクリックします。
- 新しいタイトルを入力するか、あらかじめ設定されているタイトルを使用します。必要に応じて説明を入力します。開始日と遅延を選択します。遅延は秒またはミリ秒のいずれかで、一括操作の各単一操作の間に費やされる時間です。一括操作をスケジュールをクリックして一括操作を作成します。
単一操作を一括操作としてスケジュールする
単一操作を一括操作としてスケジュールするには、単一操作 タブまたは特定のデバイスの 制御 タブから実行します。 次の手順を実行します。
- 一括操作としてスケジュールしたい単一操作の右側にあるメニューアイコン をクリックし、一括操作としてスケジュールをクリックします。
- 表示されるウィザードは、ウィザードを使用して一括操作を追加する に記載されている新しい一括操作ウィザードに似ています。ただし、操作タイプは一括操作としてスケジュールされた操作から推測されるため、ステップは 2 つだけです。ウィザード全体 の説明を参照し、その手順に従ってください。
一括操作スケジュールの編集
一括操作のスケジュールを編集できるのは、ステータスが「スケジュール済み」の場合のみです。
- 編集したい一括操作の右側にあるメニューアイコン をクリックし、スケジュールを編集 をクリックします。
- 表示されたダイアログボックスで、開始日と遅延の値を変更できます。
- 保存 をクリックして変更を適用します。
変更は、対応する一括操作に適用されます。
一括操作のキャンセル
一括操作をキャンセルできるのは、ステータスが「スケジュール済み」または「実行しています」の場合のみです。実行中の場合、単一操作がすべて作成されるまでに限って、操作をキャンセルできます。 これにより、残りの単一操作の作成をキャンセルできます。
キャンセルしたい一括操作の右側にあるメニューアイコン をクリックし、一括操作をキャンセル をクリックします。
失敗した操作の再試行
実行中または失敗して完了した一括操作の失敗した操作を再試行できます。
そのためには、目的の一括操作を展開し、操作 の下にある 失敗した操作を再試行 をクリックして、すべての失敗した操作を含む新しい一括操作を作成します。 単一操作を再試行するには、操作にカーソルを合わせて 操作を再試行 をクリックします。 これにより、新しい単一操作が作成されます。
一括操作が失敗して完了した場合は、操作の右側にあるメニューアイコン をクリックし、失敗した操作を再試行 をクリックすることもできます。
失敗した一括操作を手動で成功に設定する
失敗した一括操作を手動でステータス「成功」に設定できます。
そのためには、一括操作の右側にあるメニューアイコン をクリックし、操作を成功に設定 をクリックします。
これは、操作が通常は成功しているものの、それほど重要ではないデバイスでの操作の失敗が含まれている場合に便利です。これらの不具合が発生すると、一括操作は「失敗」ステータスのままになります。
備考
完了率の計算
完了率は、開始された操作の総数と、最終ステータス（成功または失敗）に達した操作の数を比較することによって決定されます。総計は操作作成時に確定し、その後は静的のままです。この静的な値は、操作の総数がその後変更された場合、完了率が不正確になる可能性があります。
- 操作の削除： 操作は関連付けられたデバイスが削除されると、暗黙的に削除されることがあります。この削除は、完了率の計算では考慮されません。
- 操作の追加： 失敗した操作を再試行すると、元の総数を変更せずに新しいエントリが追加されることがあります。これにより、完了率が誤って表示されます。
完了率は、操作が作成された時点で利用可能な情報に基づいて計算され、その後の変更は適用されません。
デバイスのトラブルシューティング
デバイスのトラブルシューティングをより詳細なレベルで行うには、イベントを使用します。イベントは通常、アプリケーション固有の処理に使用されるデバイスから送信される低レベルのメッセージです。例えば、自動販売機は、イベントの形式でリアルタイムの売上を送信します。
イベントの表示
Things Cloud は、個々のデバイスのレベルおよびすべてのデバイス全体を通じてイベントを表示します。
- すべてのデバイスのイベントを表示するには、ナビゲータの 概要 メニューで イベント をクリックします。
- 特定のデバイスのイベントを表示するには、デバイスの詳細画面で イベント タブに切り替えます。
デフォルトでは、イベントはデバイスからリアルタイムで受信される形式で表示されます。リアルタイム更新を無効にするには、トップメニューバーの右側にある リアルタイム をクリックします。
イベントごとに、次の情報が表示されます。
| 情報 | 説明 |
|---|---|
| タイムスタンプ | イベントが実行されたタイムスタンプ |
| 名前 | イベント名 |
| デバイス | イベントを送信しているデバイス名。名前をクリックすると、デバイスの詳細画面に移動します。 |
イベントリストの一番上に最新のエントリが表示されます。
行をクリックすると展開され、イベントの詳細（デバイスタイプや位置など）が表示されます。
デバイスから大量のイベントデータが送信される場合があるため、データを日付別にフィルタリングして表示できます。
トップメニューバーのフィールドから開始日と終了日を選択し、適用 をクリックしてフィルターを適用します。フィルターをクリアするには クリア をクリックします。