Overview

Soracom Harvest is a data collection and visualization service for Soracom Air and Soracom Inventory devices. Harvest provides data storage for your devices, and generates charts from numerical data that can be accessed directly from the User Console.


Entry Points

To send data to Harvest, simply configure your device to send data to one of the following entry points:

Air for Cellular

Entry Point Address
HTTP http://harvest.soracom.io
TCP tcp://harvest.soracom.io:8514
UDP udp://harvest.soracom.io:8514
SMS 901031
USSD *901031*{value}#

Air for Sigfox and Air for LoRaWAN

Data is captured automatically from the device. Configuring the device to send data to a specific entry point is not required.

Soracom Inventory

Entry Point Address
HTTP https://api.soracom.io/v1/devices/{DEVICE-ID}/publish?device_secret={DEVICE-KEY-SECRET}

Chart Types

Harvest automatically generates line, bar, and stacked bar charts for numerical data, as well as map charts for geographical location data.

When sending numerical data to Harvest using JSON format, Harvest will automatically plot each key in the JSON object as a separate series, using the time that each data point was received as the X-axis value, and the numerical value as the Y-axis value.

To generate map charts, your JSON data should include lat latitude and lng longitude keys.


Data Encryption

Harvest does not provide any encryption for received data. If you require encryption, please ensure that your data is encrypted before sending it to Harvest. Note that when data is encrypted, charts will not be generated.


Data Retention

By default, Harvest will provide data storage for up to 40 days. An extended data retention option of 2 years is available.