Soracom

Users

ドキュメント
フィードバック
Home ドキュメント SORACOM Harvest Getting Started with SORACOM Harvest Data

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

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

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

データ保持期間延長オプションを有効化するとデータエクスポート料金が発生します
  • データ保持期間延長オプションを有効化している場合は、データを確認するごとにデータエクスポート料金 (Harvest Data からの読み出しにかかる料金) が発生します。詳しくは、SORACOM Harvest Data のデータ保持期間を延長する を参照してください。
  • Harvest Data のデータ保持期間延長オプションを無効化している場合は、データを確認してもデータエクスポート料金は発生しません。
IoT SIM を利用するデバイスを例に操作を説明します

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

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

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

  1. ユーザーコンソール にログインし、データを送信したデバイスにあわせてカバレッジタイプを変更します。

    たとえば、plan01s の IoT SIM でデータを送信した場合は、グローバルカバレッジの表示に変更します。詳しくは、SORACOM ユーザーコンソールで表示するカバレッジタイプを変更する を参照してください。

  2. [メニュー] → [データ収集・蓄積・可視化] → [SORACOM Harvest Data] の順にクリックし、[リソース] で IoT SIM / LoRaWAN デバイス / Sigfox デバイス / Inventory のデバイスを選択します。

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

  1. ユーザーコンソール にログインし、データを送信した IoT SIM にあわせてカバレッジタイプを変更します。

    たとえば、plan01s の IoT SIM でデータを送信した場合は、グローバルカバレッジの表示に変更します。詳しくは、SORACOM ユーザーコンソールで表示するカバレッジタイプを変更する を参照してください。

  2. [メニュー] → [SORACOM AIR FOR セルラー] → [SIM 管理] の順にクリックします。

    SIM 管理画面が表示されます。

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

    SIM一覧 SIM一覧

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

    項目説明
    [Content Type]

    Harvest Data に保存されているデータの形式が表示されます。たとえば、以下のように表示されます。

    • Harvest Data に送信されたデータが JSON 形式のデータ として処理される場合は、「application/json」と表示されます。
    • Harvest Data に送信されたデータが テキストデータ として処理される場合は、「text/plain」と表示されます。
    • Harvest Data に送信されたデータが バイナリデータ として処理される場合は、JSON 形式に変換されたうえで保存されるため「application/json」と表示されます。
    [データ]

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

    • Harvest Data に送信されたデータが JSON 形式のデータ として処理される場合は、JSON 形式のまま保存されます。Harvest Data に保存される前に、バイナリパーサー や Orbit で処理された場合は、JSON 形式のデータとして Harvest Data に保存されます。

    • Harvest Data に送信されたデータが テキストデータ として処理される場合は、テキストデータのまま保存されます。

    • Harvest Data に送信されたデータが バイナリデータ として処理される場合は、以下の JSON 形式に変換されたうえで保存されます。たとえば、TCP や UDP で送信した場合は、JSON 形式のデータと同じフォーマットでも、バイナリデータとして Harvest Data に保存されます。

      payload の値 (eyJs...) は、デバイスから送信した JSON 形式のデータを Base64 形式でエンコードしたものです。これを、payload 変換と呼びます。

      {
  "payload": "eyJsYXQiOm51bGwsImxvbiI6bnVsbCwiYmF0IjozLCJycyI6MywidGVtcCI6MTkuOSwiaHVtaSI6NDcuNiwieCI6bnVsbCwieSI6bnVsbCwieiI6bnVsbCwidHlwZSI6MX0="
}

      payload 変換されたデータから元のデータを取り出すには、payload の値 (eYJs...) を Base64 形式でデコードしてください。

    [一次処理済みデータ]

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

    • [Content Type] が「application/json」で、[データ] に payload だけが含まれる場合は、payload 変換の逆変換が行われ、以下のようなデータが表示されます。

      {
  "value":"{\"lat\":null,\"lon\":null,\"bat\":3,\"rs\":3,\"temp\":19.9,\"humi\":47.6,\"x\":null,\"y\":null,\"z\":null,\"type\":1}"
}

      value の値 ({"value":"{\"lat\":null,...}"}) は、[データ] の payload の値 (eYJs...) を Base64 形式でデコードしたものです。

    • 上記以外の場合は、[データ] と同じデータが表示されます。

    [グラフ用データ]

    [一次処理済みデータ] に 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
}

    • [Content Type] が「text/plain」の場合や、値が数値のものが無い場合は、{} が表示されます。

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

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

    SORACOM 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 ごとに、ブラウザに保存されます。
  • 一度にグラフが表示できるデータの上限は 50、100、500、1000 から選択できます。[自動更新] が ON のときのみ設定した数以上のデータが追加で表示される場合がありますが、その状態で検索ボタンを押した場合やブラウザをリロードした場合は指定した期間内かつ設定した上限数のデータのみが表示されます。
  • LoRaWAN デバイス や Sigfox デバイスなどからデータを送信していて、seqNumber や rssi など、可視化に必要ないデータを非表示する場合は、左側の [DATA SERIES] でデータのチェックを外してください。
  • データにマウスポインタを合わせると、[グラフ用データ] が表示されます。
  • データをクリックすると、[選択中のデータ] が表示され、[一次処理済みデータ] の内容 (decodedData) と [グラフ用データ] の内容 (chartData) が結合された JSON 形式のデータが表示されます。このデータはダウンロードできません。

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

Harvest Data に位置情報 (緯度、経度) が保存されている場合は、[] をクリックすると、位置情報に基づいて地図に点が表示されます。

緯度と経度は、デフォルトでは [グラフ用データ] の以下のプロパティから取得されます。

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

  • 位置情報を取得するプロパティを指定するには、[データフォーマット] でプロパティを指定します。

  • データにマウスポインターを合わせると、リソース ID (IoT SIM の場合は IMSI)、リソースの種類 (Subscriber)、データ送信日時が表示されます。

  • データをクリックすると、[選択中のデータ] が表示され、[一次処理済みデータ] の内容 (decodedData) と [グラフ用データ] の内容 (chartData) が結合された JSON 形式のデータが表示されます。このデータはダウンロードできません。

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

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

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

© 2015-2023 SORACOM
最終更新日: 2023-11-13
Getting Started with SORACOM Harvest Data : デバイスのデータを SORACOM Harvest Data に保存する
Getting Started with SORACOM Harvest Data : SORACOM Harvest Data Intelligence で AI (ChatGPT API) に質問する
会社概要 プレスルーム お問い合わせ プライバシー 商標 特定商取引法 契約約款
Facebook Twitter Speaker Deck YouTube Blog