Panel の共通機能: Panel に表示するデータを選択する (Query) | SORACOM Lagoon 3

Panel で可視化するデータは、「Edit Panel」画面のデータセクションの [Query] タブで選択します。

Data source は「Harvest」を選択してください

Lagoon では、そのほかの Data source は利用できません。

1 つの Panel に複数のデータを表示できます

複数の Query を設定したり、Expression 機能を利用したりすると、1 つの Panel に複数のデータを表示できます。

Query を設定する

Dashboard のヘッダーの [ (Add panel)] → [Add a new panel] の順にクリックします。

空の Panel が追加され、「Edit Panel」画面が表示されます。
[Query] タブで、Query の設定を変更できます。

以下の項目を設定します。

項目説明

[Resource Type]

リソースの種類を選択します。

項目	説明
Air	Air for セルラーの IoT SIM、または Arc のバーチャル SIM/Subscriber から、Harvest Data に保存されたデータ
LoRa	Air for LoRaWAN の LoRaWAN デバイスから、Harvest Data に保存されたデータ
Sigfox	Air for Sigfox の Sigfox デバイスから、Harvest Data に保存されたデータ
Device	Inventory の Inventory デバイスから、Harvest Data に保存されたデータ
Demo	サンプルデータソース (Demo)
$resource_types などの Variables (変数)	画面上部で Variables を選択したときに、この Panel の表示が変わるように設定されます。詳しくは、Variables (変数) を利用して Panel に表示する対象データを切り替えるを参照してください。

Harvest Data にデータが保存されていないリソースの種類は表示されません。たとえば、Sigfox を利用していない場合は、「Sigfox」は表示されません。
$resource_types 以外の項目を選択した場合は、画面上部で Dashboard の [resource_types] を変更しても、この Panel の表示は変わりません。
以下の Variables は選択できません。
- $groups
- $properties
- $resource

[Group]

リソースが所属するグループ (SIM グループなど) を選択します。

項目	説明
All Groups	すべてのグループを対象にします。[Resources] では、グループに関わらずすべてのリソースを選択できます。
(グループ)	任意のグループを選択できます。[Resources] では、選択したグループに所属するリソースだけを選択できます。
$groups などの Variables (変数)	画面上部で Variables を選択したときに、この Panel の表示が変わるように設定されます。詳しくは、Variables (変数) を利用して Panel に表示する対象データを切り替えるを参照してください。

$groups 以外の項目を選択した場合は、画面上部で Dashboard の [groups] を変更しても、この Panel の表示は変わりません。
以下の Variables は選択できません。
- $resource_types
- $properties
- $resource

[Resources]

リソースを最大 5 つ選択します。

項目	説明
(リソース)	任意のリソースを選択できます。
$resources などの Variables (変数)	画面上部で Variables を選択したときに、この Panel の表示が変わるように設定されます。詳しくは、Variables (変数) を利用して Panel に表示する対象データを切り替えるを参照してください。

リソースを選択した場合は、画面上部で Dashboard の [resources] を変更しても、この Panel の表示は変わりません。
以下の Variables は選択できません。
- $resource_types
- $groups
- $properties

リソースが正しく表示されない場合は

Harvest Data にデータを保存していないリソースは表示されません。Harvest Data のデータを確認する操作については、Harvest Data に保存したデータを確認するを参照してください。
Harvest Data にデータが保存されていても、そのデータを Lagoon 3 が取得するまではリソースは表示されません。詳しくは、デバイスが Harvest Data にデータを保存した時刻と Lagoon 3 でデータを利用できる時刻についてを参照してください。
Lagoon コンソールを表示しているときにリソースが追加されたり、リソースの名前が変更されたりすると、タイミングによってはリソースの最新情報が表示されないことがあります。一度 Lagoon コンソールからログアウトして、再度ログインしてください。
Panel の種類によっては、Harvest Data にデータが保存されていても、表示不可能なデータの場合はリソースが表示されないことがあります。Table を選択して、リソースが表示されるかどうか確認してください。
SAM デフォルト権限設定で特定の API の利用を禁止 (deny) していると、リソースが表示されない場合があります。詳しくは、自動的に作成される SAM ユーザーについてを参照してください。

IoT SIM やデバイスの名前を設定するには

SORACOM ユーザーコンソールで設定します。たとえば、IoT SIM の名前を変更する操作については、IoT SIM の名前を設定するを参照してください。

[Data Format]

可視化するデータの種類を選択します。

項目	説明
Standard	系列を指定して可視化します。この場合は、[Properties] で、可視化する系列を複数選択します。(1) (2)
Table	Harvest Data に保存されたすべての系列を可視化します。
Map	Soracom Map Panel を利用する際に選択します。[Latitude] で緯度として扱う系列を選択し、[Longitude] で経度として扱う系列を選択します。(1) (2)

(*1) 選択できる系列は、Harvest Data に保存された系列のうち、数値が保存された系列のみです。詳しくは、系列が表示される条件について
(*2) [Properties]、[Latitude]、[Longitude] で「$properties」などの Variables (変数) を選択すると、画面上部で Variables を変更したときに、この Panel の表示が変わるように設定されます。詳しくは、Variables (変数) を利用して Panel に表示する対象データを切り替えるを参照してください。

[Properties] で系列を選択した場合は、画面上部で Dashboard の [properties] を変更しても、この Panel の表示は変わりません。
[Properties] では、以下の Variables は選択できません。
- $resource_types
- $groups
- $resources

系列が表示される条件について

「Standard」または「Map」を選択した場合は、Harvest Data に保存されている系列のうち、数値が保存されている系列のみが表示されます。

Harvest Data に保存したデータの例:

{
  "number-value": 12.3,
  "string-value": "Hello",
  "object-value": {
    "number-value-in-an-object": 1000,
    "string-value-in-an-object": "Bye"
  }
}

たとえば、上記のデータを Harvest Data に保存した場合、「Standard」または「Map」を選択したときは、以下の系列のみが表示されます。

12.3 (数値) を含む number-value
1000 (数値) を含む object-value.number-value-in-an-object

Harvest Data に保存された文字列を表示するには

Harvest Data に保存された文字列を表示する場合は、以下のいずれかを利用します。
- [Data Format] で「Table」を選択し、Panel の種類で Table を選択します。
- Panel の種類で Logs を選択します。
Text は、Lagoon コンソールで指定した文字列を表示する Panel です。Harvest Data に保存されたデータを表示することはできません。

Query の名称変更、複製、表示 / 非表示切り替え、追加 / 削除する

[Query] タブでは Query の名称変更、複製、表示 / 非表示の切り替え、追加 / 削除ができます。

操作	説明
Panel ごとに表示する時間範囲を設定する	[Query options] を設定します。詳しくは、Panel ごとに時間範囲を設定する (Query options) を参照してください。
データソースへのリクエストとレスポンスを確認する	[Query inspector] をクリックすると、データソース (Harvest Data) へのリクエストとレスポンスを確認できます。
Query 名を変更する	Query 名 (デフォルトでは A、B、C...) は、Expression 機能や Panel の可視化に関する共通オプションの [Overrides] を利用するときに指定します。 Query 名を変更するには、Query 名 (A など) をクリックします。半角英数字 (`a` ～ `z`、`A` ～ `Z`、`0` ～ `9`) または記号 (`_`) を使用してください。それ以外の文字を使用すると、Expression 機能などで正しく参照できない場合があります。
Query を複製する	をクリックします。
Query の表示 / 非表示を切り替える	をクリックします。
Query を削除する	をクリックします。
Query を並べ替える	をドラッグします。
Query を追加する	[＋Query] をクリックします。
Expression を追加する	[＋Expression] をクリックします。詳しくは、Query を加工して新しい Query を作成する (Expression) を参照してください。