SORACOM Harvest Data に保存したデータを確認 / 削除する

Harvest Data に保存したデータを確認する

Harvest Data に送信されたデータを確認したりダウンロードしたりします。数値データや位置情報は、グラフや地図で確認できます。

IoT SIM を利用するデバイスを例に操作を説明します

LoRaWAN デバイス、Sigfox デバイス、Inventory のデバイスで Harvest Data に送信したデータも、同様の操作で確認できます。

SORACOM Harvest Data 画面を表示してからデバイスを選択することもできます

SORACOM Harvest Data 画面を表示してからデバイスを選択する方法でも、データを確認したりダウンロードしたりできます。

ユーザーコンソールにログインし、データを送信したデバイスにあわせてカバレッジタイプを変更します。
たとえば、plan01s の IoT SIM でデータを送信した場合は、グローバルカバレッジの表示に変更します。詳しくは、SORACOM ユーザーコンソールで表示するカバレッジタイプを変更するを参照してください。
[メニュー] → [データ収集・蓄積・可視化] → [SORACOM Harvest Data] の順にクリックし、[リソース] で IoT SIM / LoRaWAN デバイス / Sigfox デバイス / Inventory のデバイスを選択します。

デバイスが表示されないときは、手順 1 で選択したカバレッジタイプを確認してください。

ユーザーコンソールにログインし、データを送信した IoT SIM にあわせてカバレッジタイプを変更します。
たとえば、plan01s の IoT SIM でデータを送信した場合は、グローバルカバレッジの表示に変更します。詳しくは、SORACOM ユーザーコンソールで表示するカバレッジタイプを変更するを参照してください。
[メニュー] → [SORACOM AIR FOR セルラー] → [SIM 管理] の順にクリックします。
SIM 管理画面が表示されます。

データを送信した IoT SIM にチェックを入れ、[操作] → [データの確認] の順にクリックします。

SIM一覧

SORACOM Harvest Data 画面が表示され、Harvest Data に保存されたデータや、一次処理済みデータ、グラフ用データとして、以下のデータが表示されます。

項目説明

項目	説明
[データ]	Harvest Data に保存されたデータが表示されます。 Harvest Data に送信された JSON 形式のデータは、JSON 形式のまま保存されます。Harvest Data に保存される前に、バイナリパーサーや Orbit で処理された場合は、JSON 形式のデータとして Harvest Data に保存されます。 Harvest Data に送信されたデータがバイナリデータとして処理される場合は、以下の JSON 形式に変換されたうえで保存されます。たとえば、TCP や UDP で送信した場合は、JSON 形式のデータと同じフォーマットでも、バイナリデータとして Harvest Data に保存されます。 `payload` の値 (`eyJs...`) は、デバイスから送信した JSON 形式のデータを Base64 形式でエンコードしたものです。これを、payload 変換と呼びます。 `{ "payload": "eyJsYXQiOm51bGwsImxvbiI6bnVsbCwiYmF0IjozLCJycyI6MywidGVtcCI6MTkuOSwiaHVtaSI6NDcuNiwieCI6bnVsbCwieSI6bnVsbCwieiI6bnVsbCwidHlwZSI6MX0=" }` payload 変換されたデータから元のデータを取り出すには、`payload` の値 (`eYJs...`) を Base64 形式でデコードしてください。
[一次処理済みデータ]	[データ] の内容によって異なります。 [データ] に `payload` だけが含まれる場合は、以下のようなデータが表示されます。`value` の値 (`{"value":"{\"lat\":null,...}"}`) は、[データ] の `payload` の値 (`eYJs...`) を Base64 形式でデコードしたものです。 `{ "value":"{\"lat\":null,\"lon\":null,\"bat\":3,\"rs\":3,\"temp\":19.9,\"humi\":47.6,\"x\":null,\"y\":null,\"z\":null,\"type\":1}" }` [データ] に `payload` 以外が含まれる場合は、[データ] と同じデータが表示されます。
[グラフ用データ]	[一次処理済みデータ] に JSON 形式のデータが表示されている場合に、値が数値のものだけを抽出したデータが表示されます。 `{"bat":3,"rs":3,"temp":19.9,"humi":47.6,"type":1}` ただし、以下の場合は特別なデータ変換が行われます。 [一次処理済みデータ] に `value` だけが含まれる場合は、`value` の値 (例: `{"value":"{\"lat\":null,...}"}`) を JSON 形式のデータとみなして、値が数値のものだけを抽出します。 [一次処理済みデータ] の任意のキーに JSON オブジェクトが含まれる場合は、以下のようにデータ構造が変換されます。 [一次処理済みデータ] のデータ: `gps` に JSON オブジェクトが含まれています。 `{ "time": 123455656, "gps": { "lat": 23.354, "lon": 2.0, "speed": 123 } }` [グラフ用データ] のデータ: `gps` に含まれていた JSON オブジェクトのキーに、`gps.` (プレフィックス) が付与されて、JSON オブジェクトが含まれない形に変換されています。 `{ "time": 123455656, "gps.lat": 23.354, "gps.lon": 2.0, "gps.speed": 123 }`

[データ]

Harvest Data に保存されたデータが表示されます。

Harvest Data に送信された JSON 形式のデータは、JSON 形式のまま保存されます。Harvest Data に保存される前に、バイナリパーサーや Orbit で処理された場合は、JSON 形式のデータとして Harvest Data に保存されます。
Harvest Data に送信されたデータが バイナリデータ として処理される場合は、以下の JSON 形式に変換されたうえで保存されます。たとえば、TCP や UDP で送信した場合は、JSON 形式のデータと同じフォーマットでも、バイナリデータとして Harvest Data に保存されます。
payload の値 (eyJs...) は、デバイスから送信した JSON 形式のデータを Base64 形式でエンコードしたものです。これを、payload 変換と呼びます。
```
{
  "payload": "eyJsYXQiOm51bGwsImxvbiI6bnVsbCwiYmF0IjozLCJycyI6MywidGVtcCI6MTkuOSwiaHVtaSI6NDcuNiwieCI6bnVsbCwieSI6bnVsbCwieiI6bnVsbCwidHlwZSI6MX0="
}
```
payload 変換されたデータから元のデータを取り出すには、payload の値 (eYJs...) を Base64 形式でデコードしてください。

[一次処理済みデータ]

[データ] の内容によって異なります。

[データ] に payload だけが含まれる場合は、以下のようなデータが表示されます。value の値 ({"value":"{\"lat\":null,...}"}) は、[データ] の payload の値 (eYJs...) を Base64 形式でデコードしたものです。
```
{
  "value":"{\"lat\":null,\"lon\":null,\"bat\":3,\"rs\":3,\"temp\":19.9,\"humi\":47.6,\"x\":null,\"y\":null,\"z\":null,\"type\":1}"
}
```
[データ] に payload 以外が含まれる場合は、[データ] と同じデータが表示されます。

[グラフ用データ]

[一次処理済みデータ] に JSON 形式のデータが表示されている場合に、値が数値のものだけを抽出したデータが表示されます。

{"bat":3,"rs":3,"temp":19.9,"humi":47.6,"type":1}

ただし、以下の場合は特別なデータ変換が行われます。

[一次処理済みデータ] に value だけが含まれる場合は、value の値 (例: {"value":"{\"lat\":null,...}"}) を JSON 形式のデータとみなして、値が数値のものだけを抽出します。
[一次処理済みデータ] の任意のキーに JSON オブジェクトが含まれる場合は、以下のようにデータ構造が変換されます。
[一次処理済みデータ] のデータ:
gps に JSON オブジェクトが含まれています。
```
{
  "time": 123455656,
  "gps": {
    "lat": 23.354,
    "lon": 2.0,
    "speed": 123
  }
}
```
[グラフ用データ] のデータ:
gps に含まれていた JSON オブジェクトのキーに、gps. (プレフィックス) が付与されて、JSON オブジェクトが含まれない形に変換されています。
```
{
  "time": 123455656,
  "gps.lat": 23.354,
  "gps.lon": 2.0,
  "gps.speed": 123
}
```

たとえば、TCP や UDP で文字列の 123 や hello を送信した場合 (バイナリデータとして保存された場合) は、ユーザーコンソールでは以下のように表示されます。

送信したデータ (文字列)	データ	一次処理済みデータ	グラフ用データ
`123`	`{"payload":"MTIz"}`	`{"value":"123"}`	`{"value":123}`
`hello`	`{"payload":"aGVsbG8="}`	`{"value":"hello"}`	`{}`

SORACOM Harvest Data 画面の主な機能:

[自動更新 (5 秒)] を ON にすると、5 秒おきに新しいデータを取得します。ただし複数のデバイスのグラフを表示させる場合は 60 秒ごとに更新されます。
グラフで確認する手順については、[グラフ用データ] (数値データ) をグラフ化するを参照してください。
地図で確認する手順については、[グラフ用データ] (数値データ) の位置情報を地図にマッピングするを参照してください。
[ダウンロード] をクリックすると、JSON 形式でダウンロードできます。詳しくは、Harvest Data に格納されたデータをダウンロード (バックアップ) するを参照してください。

Harvest Data へ送信するデータの種類に制限はありませんが、上記のルールで [グラフ用データ] にデータが表示されない場合は、グラフ化したり、地図にマッピングしたりできません。

SORACOM CLI / SORACOM API の場合

SORACOM CLI または SORACOM API を利用しても、Harvest Data に保存したデータを確認できます。

SORACOM CLI を利用する場合:
- IoT SIM で送信したデータを確認するには、soracom subscribers get-data を使用します。
- LoRaWAN デバイスで送信したデータを確認するには、soracom lora-devices get-data を使用します。
- Sigfox デバイスで送信したデータを確認するには、sigfox-devices get-data を使用します。
- Inventory のデバイスで送信したデータを確認するには、devices get-data を使用します。
SORACOM API を利用する場合:
- IoT SIM で送信したデータを確認するには、Sim:getDataFromSim API を使用します。
- LoRaWAN デバイスで送信したデータを確認するには、LoraDevice:getDataFromLoraDevice API を使用します。
- Sigfox デバイスで送信したデータを確認するには、SigfoxDevice:getDataFromSigfoxDevice API を使用します。
- Inventory のデバイスで送信したデータを確認するには、Device:getDataFromDevice API を使用します。

[グラフ用データ] (数値データ) をグラフ化する

ユーザーコンソールでは、[グラフ用データ] に表示されるデータをグラフ化できます。グラフの種類は「折れ線グラフ」「集合棒グラフ」「積み上げ棒グラフ」から選択できます。

縦軸は値に応じて自動的に調整されます。任意の最大値と最小値を指定することもできます。
凡例で系列のチェックボックスの設定で、系列ごとにグラフの表示 / 非表示を切り替えられます。絞り込み状態の設定は IoT SIM ごとに、ブラウザに保存されます。
一度にグラフが表示できるデータの上限は 50、100、500、1000 から選択できます。[自動更新] が ON のときのみ設定した数以上のデータが追加で表示される場合がありますが、その状態で検索ボタンを押した場合やブラウザをリロードした場合は指定した期間内かつ設定した上限数のデータのみが表示されます。
LoRaWAN デバイスや Sigfox デバイスなどからデータを送信していて、seqNumber や rssi など、可視化に必要ないデータを非表示する場合は、左側の [DATA SERIES] でデータのチェックを外してください。
データにマウスポインタを合わせると、[グラフ用データ] が表示されます。
データをクリックすると、[選択中のデータ] が表示され、[一次処理済みデータ] の内容 (decodedData) と [グラフ用データ] の内容 (chartData) が結合された JSON 形式のデータが表示されます。このデータはダウンロードできません。

[グラフ用データ] (数値データ) の位置情報を地図にマッピングする

位置情報 (緯度、経度) は、地図アイコンをクリックすると地図にマッピングできます。緯度と経度は、デフォルトでは [グラフ用データ] の以下のプロパティから取得されます。

緯度: lat または latitude
経度: lon、longitude、lng、または long

SORACOM Harvest Data 位置情報の確認

位置情報を取得するプロパティを指定するには、[データフォーマット] でプロパティを指定します。
データにマウスポインタを合わせると、[グラフ用データ] が表示されます。
データをクリックすると、[選択中のデータ] が表示され、[一次処理済みデータ] の内容 (decodedData) と [グラフ用データ] の内容 (chartData) が結合された JSON 形式のデータが表示されます。このデータはダウンロードできません。

Harvest Data に保存したデータを削除する

SORACOM Harvest Data に格納されたデータはデータ保持期間の経過後、自動で削除されます。またデータ保持期間中においても SORACOM Harvest Data からデータを削除できます。SORACOM Harvest Data 画面下部より対象のデータを選択し [削除] をクリックしてください。

また、SORACOM API では deleteDataEntry API、SORACOM CLI では soracom data delete-entry コマンドで削除できます。

Soracom

Users

SORACOM Harvest Data に保存したデータを確認 / 削除する

Harvest Data に保存したデータを確認する

IoT SIM を利用するデバイスを例に操作を説明します

SORACOM Harvest Data 画面を表示してからデバイスを選択することもできます

SORACOM CLI / SORACOM API の場合

[グラフ用データ] (数値データ) をグラフ化する

[グラフ用データ] (数値データ) の位置情報を地図にマッピングする

Harvest Data に保存したデータを削除する