Eagle.io (Target)
Export data from IMSURGE pipelines into Eagle.io’s environmental monitoring platform.
Important: Eagle.io requires a unique target integration for each source integration mapped in a pipeline. Unlike other targets, sending multiple sources into a single Eagle.io target will result in automatic creation of new parameters, but not new data source nodes.
Setup Instructions
1. Prerequisites
To use Eagle.io as a target, you must first create a data source node in Eagle.io and obtain the three-word passphrase generated for that node.
- Log in to your Eagle.io account.
- Create or identify the workspace and location where you want the data to appear.
- Right-click the location and select Create → Source → Data.
- Under Source Type, choose File → JSON Time Series.
- Under Transport Type, choose one of:
- Upload via HTTP (recommended)
- Publish to mqtt.eagle.io
- Upload to ftp.eagle.io
- Finish the setup and note the three-word passphrase for the node.
- For HTTP nodes, the passphrase is at the end of the upload URL (e.g.,
https://upload.eagle.io/source/three-random-words). - For MQTT nodes, this appears at the end of the topic string.
- For FTP nodes, this is shown as the Username on the Connection tab.
- For HTTP nodes, the passphrase is at the end of the upload URL (e.g.,
FTP filename requirement – Eagle.io FTP nodes must match a specific filename. IMSURGE always uploads data.jts, so the Eagle.io data source must be configured to accept data.jts as the incoming file name.
2. Creating the Integration
When adding your Eagle.io (Target) integration in IMSURGE, you will enter the following details directly into the integration:
- Upload protocol – Choose
http,mqtt, orftpdepending on the transport type set in Eagle.io data source node. - Three-word passphrase – The identifier assigned to the Eagle.io node (must match exactly).
Concerns & Limitations
- Units of measure – The JSON Time Series (JTS) format has capability of providing unit of measure for metrics, however providing this information to eagle.io does not result in the unit of measure being automatically assigned. Unfortunately this step needs to be performed manually by the user in the node configuration interface.
- Manual node creation required – Eagle.io does not support automatic creation of data source nodes. Each source integration in IMSURGE must be mapped to its own unique Eagle.io target integration on a one-to-one basis. For every source you configure, you will need to create a separate data source node in Eagle.io to keep data for different sensors separated.
Reference
Tips
Prefer HTTP uploads where possible, as they are the most reliable and straightforward to configure.