SORACOM Harvest is a service that collects and accumulates data from IoT devices using SORACOM Air mobile communication. It automatically adds received time and SIM ID to saved data, which can then be graphed and browsed in the SORACOM user console or accessed via API. The uploaded data is saved for 40 days. The document then provides steps to set up a group in the SORACOM console, turn on Harvest settings, send sensor data to Harvest via HTTP POST, and visualize the accumulated data in graphs and tables that automatically refresh every 5 minutes.

1. Hands-on Series
SORACOM Harvest

2. Introduction
SORACOM Harvest (Harvest) is a service to collect and accumulate data from IoT
devices.
By using mobile communication provided by SORACOM Air, sensor data, position
information, etc. can be easily accumulated on the "SORACOM" platform on the
cloud without troubles through mobile communication.
Received time and SIM ID are automatically added to the saved data and it can be
graphed and browsed in the user console of "SORACOM" or acquired via the API.
The uploaded data will be saved for 40 days.

3. Reading materials for BEAM:
• Service Overview
• Getting Started – Harvest
Resources
Laptop
Wi-Fi Hotspot/
Personal Hotspot
AIR SIM Global
SETUP
used
• Putty
• Packet Sender
• Command Prompt
• Internet browser
IoT Platform
Visualization
Simulation of
IoT Device (*)
Cellular
Network
* This setup is for demonstration & testing purpose only. The SIM should reside in the IoT device to secure communication.
Pre-requisite Hands-on Series:
• Getting Started
• SORACOM AIR
Now log on to https://console.soracom.io/

4. 1. Open the SORACOM console at https://console.soracom.io/ .
2. Check the Air SIM you want to communicate with SORACOM Harvest.
3. Select [Change group] from the [Action] button.
Create a group (via Actions menu)

5. Create a group (via Actions menu)
1. Select [Create…]
2. Enter the group name, e.g. “hello soracom” and click [Create]

6. Choose a group (via side bar)
1. From the console side menu bar
2. Select [Groups]
3. From the group list, choose “hello soracom”.

7. 1. Click the switch in the [SORACOM Harvest setting] group, change it to
ON, and click the Save button.
Turn on Harvest

8. Send data via HTTP
1. Open the terminal in your laptop
2. Send an HTTP POST request to the Harvest entry point. You need to
specify the data type with content-type.
----------------------------------
curl -v -X POST -H 'content-type:application/json' -d '{"temperature":20}' http://harvest.soracom.io

9. Visualize data accumulated in Harvest
1. Open the Air SIM management screen and check the air SIM that
communicated by SORACOM Harvest. Next, select [Harvest data] from
the [Action] button.

10. Visualize data accumulated in Harvest
1. The screen showed up, the data is not loaded yet.
2. Press the [Search] button, the saved data will be displayed.

11. Visualize data accumulated in Harvest
1. Send other sets of data in the terminal, for example, “temperature”:22,
“temperature”:21, etc;
curl -v -X POST -H 'content-type:application/json' -d '{"temperature":22}' http://harvest.soracom.io
curl -v -X POST -H 'content-type:application/json' -d '{"temperature":21}' http://harvest.soracom.io
2. Press the [Refresh] button, the saved data will be updated.

12. Visualize data accumulated in Harvest
1. The saved data are also shown in the table under the graph.

13. Visualize data accumulated in Harvest
1. Press [Auto refresh] button, your chart will be updated every 5 minutes.

14. Disable Harvest
1. Click the switch in the [SORACOM Harvest setting] group, change it to
OFF, and click the Save button.