Soracom

Users

スタートガイド

SORACOM Lagoon で高度に可視化する

当ガイドでは、ビーコン対応 GPS トラッカー GW (以下、ビーコン GW) から送信されたデータを SORACOM Lagoon (以下、Lagoon) で可視化する方法を説明します。SORACOM Lagoon ではよりカスタマイズされた可視化を実現でき、テンプレートのインポート機能もあります。当ドキュメントでは以下の画像のようなダッシュボードが作成できます。

当ガイドの前提は以下のとおりです。

ステップ 1: SORACOM Lagoon を有効化する 

SORACOM のユーザーコンソール にルートアカウントでログインし、サイドメニューの「データ収集・蓄積・可視化」>「SORACOM Lagoon」メニューをクリックします。

SAM ユーザーで Lagoon の利用開始はできません。必ずメールアドレス・パスワードでログインするルートアカウントで実施してください。

Lagoon を有効化する 

「SORACOM Lagoon の利用を開始する」ボタンをクリックします。

パスワードを設定します。 このパスワードは SORACOM コンソールのルートアカウントのメールアドレスで Lagoon へログインする時に必要なパスワードとなります。

Lagoon へログインする 

「SORACOM Lagoon にアクセス」ボタンをクリックします。

ルートアカウントのメールアドレスと先ほど設定したパスワードを入力しログインします。

以下のような画面が表示されていれば Lagoon の有効化・ログインは成功です。

ステップ 2: ビーコン対応 GPS トラッカー GW を設定する 

SORACOM Lagoon では SORACOM Harvest Data に格納されたデータをソースに可視化します。まだ SORACOM Harvest Data を設定していない場合は ビーコン対応 GPS トラッカー GW で BLE センサー情報を送信する にしたがって、ビーコン GW のデータを SORACOM Harvest Data へ格納してください。

当サンプルダッシュボードでは ビーコン対応 GPS トラッカー GW スターターキット (BLE 温湿度センサー 3 個セット) に付属する BLE センサーを使用しています。またキッティングツールの「データ送信の設定 - ビーコン項目」にて、以下のように設定しています。このように設定し、3 種のセンサーをそれぞれの場所へ配置してください。

スロット設定
1要素 1 (AdvA) : 冷蔵室用センサーの裏面の英数字, センサー: 温度
2要素 1 (AdvA) : 冷蔵室用センサーの裏面の英数字, センサー: 湿度
3要素 1 (AdvA) : 冷凍室用センサーの裏面の英数字, センサー: 温度
4要素 1 (AdvA) : 冷凍室用センサーの裏面の英数字, センサー: 湿度
5要素 1 (AdvA) : 野菜室用センサーの裏面の英数字, センサー: 温度
6要素 1 (AdvA) : 野菜室用センサーの裏面の英数字, センサー: 湿度

ステップ 3: SORACOM Lagoon のダッシュボード作成を準備する 

利用している ビーコン対応 GPS トラッカー GW のデータを可視化するため、ダッシュボードを準備します。

可視化する ビーコン対応 GPS トラッカー GW の IMSI を控える 

ユーザーコンソールの SIM 管理 メニューよりビーコン GW の SIM を選択、「詳細」をクリックします。

15 桁の数字の IMSI をテキストエディタなどに控えてください。ダッシュボードの作成に利用します。

サンプルダッシュボードを利用する 

Lagoon では JSON 形式で記述されたモデルをインポートできます。全てのパネルを自身で作成することも可能ですが、作成したいイメージに近いサンプルダッシュボードをインポートできれば作成の時間を短縮でき、その後カスタマイズできます。

ここでは、インポートのためのテンプレートを作成します。ビーコン対応 GPS ゲートウェイトラッカーのサンプルダッシュボード を開き、「このダッシュボードを使う」をクリックします。当ページでは、SIM の IMSI をもとに Lagoon ダッシュボードのテンプレートを作成します。

先ほど控えた IMSI を入力し、「テンプレートを作成する」をクリックします。

これでテンプレートを作成できました。次のステップでダウンロードします。

ステップ 4: SORACOM Lagoon のダッシュボードを作成する 

先ほど生成したテンプレートのダウンロード画面では「クリップボードへコピー」、「SORACOM Lagoon でインポート」をクリックしてください。なお、今後のために保存しておきたい場合は「JSON ファイルとしてダウンロード」利用してください。

「SORACOM Lagoon でインポート」をクリックすると、Lagoon のインポート画面に遷移します。「Or paste JSON」にて先ほどクリップボードにコピーした JSON を貼り付けてください。Windows の場合は Ctrl + V、Mac OS の場合は ⌘ (Command) + V で貼り付けできます。

JSON ファイルが貼り付けられなかった場合は、再度先ほどのサンプルダッシュボードのページよりコピーしてください。

インポートの詳細画面に遷移するので、「Import」をクリックします。

すでに Lagoon でダッシュボードを作成している場合、「作成数の上限に達しています」と表示される可能性があります。不要なダッシュボードがあれば削除した後、再度インポートしてください。削除できるダッシュボードがなければ、プランのアップグレードを検討してください。プランごとの料金は、SORACOM Lagoon のご利用料金 を参照してください。

インポートに成功すれば、ダッシュボードが表示されます。

応用: 今後のステップ 

ここまでで、カスタマイズされた可視化を実現できました。今後さらに Lagoon を活用する方法を紹介します。

パネルを追加・カスタマイズする 

当ドキュメントではダッシュボード設定をインポートしましたが、Lagoon ではコードを書くことなくパネルの追加やカスタマイズができます。詳細な方法は SORACOM Lagoon の仕組み を参照してください。また、参考: サンプルダッシュボードで使用しているパネルの解説 を参照してサンプルダッシュボードで使われているパネルがどのように設定されているか参考にしてください。

アラートを設定する 

Lagoon では閾値に応じてアラートを送信できます。たとえば温度が 10℃ を超えたらメールを送信するといったアラートを設定できます。詳細は SORACOM Lagoon を利用してアラートを設定する や アラートをカスタマイズする を参照してください。

ダッシュボードを共有する 

Lagoon のダッシュボードは PC に限らずタブレット端末などでもブラウザ上で閲覧できます。また、Maker 以上のプランにアップグレードすると、閲覧専用のユーザーも作成できます。詳細は ダッシュボードを作成する を参照してください。

参考: サンプルダッシュボードで使用しているパネルの解説 

各パネルについて解説します。なお、メトリックとは温度や湿度などの値を指します。

冷蔵庫の各室の温度 : SORACOM Image (イメージ) 

設定方法は パネルリファレンス: SORACOM Image パネル も参照してください。

画像 タブ 

  • 背景画像の URL では冷蔵庫の画像を設定し固定表示しています

なお、「画像を追加」することで、各センサーの値に応じて変化する画像を設置できます。ソラコムでは利用可能な アイコンを公開 しておりますのでご活用ください。

センサー タブ (画像は冷蔵室に設置したセンサーの例) 

  • メトリック では設定したいメトリックおよび単位を設定しています。
  • X/Y 座標 では値を表示する位置を指定しています。
  • リンク ではマウスホバー時のテキストを設定しています。

温度 : Graph (グラフ) 

設定方法は パネルリファレンス: グラフパネル も参照してください。

表示 タブ (画像は冷蔵室の例) 

  • 系列固有のオーバーライドを設定しています。
    • snsX (X はメトリックによって異なる) の Color を設定して各メトリックの折れ線グラフに色を付けています。

バッテリー残量 : Singlestat (シングルスタット) 

設定方法は パネルリファレンス: シングルスタットパネル も参照してください。

オプション タブ (画像はバッテリー残量の例) 

  • 色 では電波強度もバッテリー残量もしきい値に応じた色を設定し、高い値では明るい黄色、低い値では暗い黄色にしています。値 を有効にすることで、ゲージもここで設定した色に対応します。
  • スパークライン の 表示 を有効にすることで、メトリックの履歴を可視化できます。
  • ゲージ の 表示 を有効にすることで、メトリックの高低を分かりやすく可視化できます。最小値、最大値 は 送信されるデータフォーマット に記載されたペイロードの範囲に沿って設定しています。

値のマッピング タブ (画像はバッテリー残量の例) 

  • タイプ に 値をテキストにマッピング を指定して、メトリックの各数字を意味にマッピングしています。メトリックの各数字が固有の意味を持つ場合に有効です。

データの履歴 : Table (テーブル) 

当サンプルダッシュボードではテーブルパネルをカスタマイズしていません。カスタマイズしたい場合は パネルリファレンス: テーブルパネル 参照してください。設定方法は パネルリファレンス: グラフパネル も参照してください。

各パネル設定の解説 : Text (テキスト) 

設定方法は パネルリファレンス: テキストパネル も参照してください。

Options タブ 

  • Mode に html を指定して、Content に当ドキュメントへのリンクを記載しています。
最終更新日: 2021-09-24
Getting Started : BLE センサー情報を送信する
トラブルシューティングとサポート : よくあるお問い合わせ