This describes when you should use an IoT SDK or the IoT REST API, get an EUM App Key, and direct you to instructions for capturing and reporting data.

SDKs Versus REST API

The IoT SDKs use the REST API to transmit data to the EUM Server. By handling HTTP requests, serializing JSON, and managing events in memory, the SDKs make it easier to capture and report data, so you can focus on instrumenting your application. For platforms other than C++ or Java, you can take advantage of the wide variety of HTTP(S) and JSON libraries to use the IoT REST API to report data. 

Get an EUM App Key

To get an EUM App Key, you need to either create an IoT app manually or use the Getting Started Wizard, which is recommended if you are a new user. You will need the EUM App Key to use the IoT REST API or IoT SDKs to report device information and events to the EUM Server. Multiple IoT applications can share the same key.

Create an IoT Application with the Getting Started Wizard

From the Controller:

  1. Click User Experience from the top navigation bar.
  2. Select the Connected Devices tab.
  3. Click Get Started.
  4. From the Create Application dialog, select Create an Application using the Getting Started Wizard.
  5. Click OK.
  6. For step one of the Getting Started Wizard - Connected Devices page, select Create a new Application.
  7. Enter a name for your IoT app.
  8. Click Continue.
  9. From step two, select which method you want to use to report IoT data (Java SDK, C/C++ SDK, REST API).
  10. Copy the values for the App Key and the Collector URL. You'll be using both to report IoT data.
  1. Click User Experience from the top navigation bar.
  2. Select the Connected Devices tab.
  3. Click Get Started.
  4. From the Create Application dialog, select Create an Application using the Getting Started Wizard.
  5. Click OK.
  6. For step one of the Getting Started Wizard - Connected Devices page, select Use an existing Application.
  7. Choose one of the existing applications from the dropdown.
  8. From step two, select which method you want to use to report IoT data (Java SDK, C/C++ SDK, REST API).
  9. Copy the values for the App Key and the Collector URL. You'll be using both to report IoT data.

IoT applications created from existing applications cannot be deleted. You would need to delete the existing IoT application that was used to create the application.

Manually Create an IoT Application

From your Controller:

  1. Click User Experience from the top navigation bar.
  2. Select the Connected Devices tab.
  3. Click Get Started.
  4. From the Create Application dialog, select Create an Application manually.
  5. Enter a name for your IoT app.
  6. Click OK.
  7. From the Connected Devices tab, select IoT app and click Copy Iconto copy the App Key to your clipboard.

Report IoT Data

Based on the method you plan on reporting data, use your App Key and follow the instructions for one of these tutorials: