Soracom

Users

ドキュメント
Home ドキュメント SORACOM Harvest はじめに

SORACOM Harvest Data の特徴

Harvest Data を利用すると、サーバーやクラウドサービスを用意することなく、デバイスが送信したデータを蓄積したり確認したりできます。

Harvest Data を使用して短い間隔 (1 秒に 1 リクエスト等) でデータ送信することを検討されている場合は、ユースケースを添えて セールスチーム にお問い合わせください。

HTTP/TCP/UDP セッションは切断されることがあります

SORACOM のメンテナンスに伴い、任意のタイミングで HTTP/TCP/UDP セッションが切断される場合があります。メンテナンスに伴うセッション切断は、SORACOM Status Dashboard などで告知されません。ご了承ください。

データ保管の仕様について
  • データは、リソース ID (*1) ごとに、データの保存日時 (ミリ秒) をキーとして保存されます。そのため、同一リソース ID から同一タイムスタンプでデータを保存した場合、過去のデータは上書きされます。詳しくは、リソース ID とタイムスタンプが一致した場合の処理について を参照してください。

    (*1) たとえば、IoT SIM を利用した場合は SIM ID のこと。

  • データ保存期間: 40 日間。保存期間を経過したファイルは自動的に削除され、復旧できません。

    なお、データ保持期間延長オプション を利用することで 731 日間に延長できます。この場合も、保存期間を経過したファイルは自動的に削除され、復旧できません。

  • Harvest Data 側での暗号化機能: なし。暗号化が必要な場合はクライアント側でご対応ください。

  • 1 回に保存できるデータサイズの最大値: 100 KB

データを保存する

Harvest Data の エントリポイント、または Unified Endpoint にデータを送信すると、Harvest Data にデータを保存できます。詳しくは、デバイスのデータを SORACOM Harvest Data に保存する を参照してください。

データ保持期間延長オプションも利用できます

データ保持期間延長オプション を利用することで、データ保存期間を 731 日間に延長できます。

ユーザーコンソールでデータを確認する

デバイスから送信され Harvest Data に保存されたデータは、ユーザーコンソールで、表、グラフ (折れ線、棒グラフ、積み上げ)、地図で簡易的に可視化できます。詳しくは、Harvest Data に保存したデータを確認する を参照してください。

項目イメージ
表 表
折れ線グラフ折れ線グラフ 折れ線グラフ
棒グラフ棒グラフ 棒グラフ
積み上げグラフ積み上げグラフ 積み上げグラフ
地図地図 地図
Harvest Data は RDBMS のようなデータ検索に対応していません
  • Harvest Data は、簡易的なストレージサービスです。Harvest Data におけるデータの検索は、以下の情報を利用したフィルタリングにのみ対応しています。フィルタリングについて詳しくは、DataEntry:getDataEntries を参照してください。

    • SIM ID などのリソース ID。
    • データの登録日時。
    • 取得するデータエントリ数。

    Harvest Data では、これ以外のデータ検索機能は提供されていません。たとえば、特定の値に基づくフィルタリング機能 (SQL の where 句に相当) や、データの集約機能 (SQL の group by 句に相当) など、リレーショナルデータベースマネジメントシステム (RDBMS) に見られるような検索操作はサポートされていません。

  • ユーザーコンソールの Harvest Data 画面で提供される折れ線グラフ、棒グラフ、積み上げグラフでは、系列ごとにデータを非表示にできます。これは、リソース ID とデータの登録日時でフィルタリングしたデータを取得したあとで、系列ごとにデータを非表示にしています。

Lagoon 3 を利用すると複数のグラフを組み合わせた Dashboard を作成できます

Lagoon 3 を利用すると、複数のグラフ、テーブル、リスト、地図などを組み合わせた Dashboard を作成し、ほかの Lagoon ユーザーや任意の第三者と共有できます。また、値がしきい値を超えたときに通知することもできます。