Skip to content

Data Forwarding ​

YenGear IoT Cloud can automatically forward device data to external systems in real-time. This enables seamless integration with your existing infrastructure, analytics tools, and business applications.

Overview ​

When devices send data to YenGear IoT Cloud, the platform can simultaneously push that data to one or more external destinations. Each forwarding configuration is called a Forwarder Profile.

Key Features ​

  • Multiple Destinations: Forward data to webhooks, databases, message queues, or cloud storage
  • Per-Organization: Each organization manages its own forwarding rules
  • Priority Control: Set execution order when multiple forwarders are active
  • Real-time Delivery: Data is forwarded as soon as it arrives
  • Activity Tracking: Monitor sent counts and monthly statistics

Supported Forwarding Types ​

TypeDescriptionDocumentation
HTTP PostSend data via HTTP POST to any webhook endpointHTTP Post Forwarding
MongoDBStore data directly in MongoDB collectionsMongoDB Forwarding
MQTTPublish data to MQTT brokersMQTT Forwarding
InfluxDBWrite time-series data to InfluxDBInfluxDB Forwarding
S3/OSSArchive data to object storageS3 Forwarding
AMQPSend messages to RabbitMQ or other AMQP brokersComing soon
NATSPublish to NATS messaging systemComing soon
ElasticsearchIndex data for search and analyticsComing soon

Getting Started ​

Prerequisites ​

  • An organization with at least one device sending data
  • Access to Org → Data Forwarding in the sidebar
  • Target system credentials (URL, API keys, etc.)

Create a Forwarder Profile ​

  1. Navigate to Org → Data Forwarding
  2. Click + New Profile
  3. Enter a Name (optional but recommended)
  4. Select a Type from the dropdown
  5. Set Priority (higher values execute first)
  6. Configure the Target Config for your chosen type
  7. Ensure Enabled is on
  8. Click Save

Managing Profiles ​

  • Toggle: Enable/disable forwarding without deleting the profile
  • Edit: Update configuration at any time
  • Delete: Remove the profile permanently
  • Monitor: Check Sent Count and Monthly Sent statistics

Data Format ​

All forwarding types receive data in a consistent JSON format:

json
{
  "device_id": "d-1000-abc",
  "project_id": "proj-xyz",
  "timestamp": 1709856000,
  "factors": [
    {
      "agri_id": "d-1000-abc-1-00",
      "value": 25.5,
      "unit": "°C"
    },
    {
      "agri_id": "d-1000-abc-1-01",
      "value": 65.2,
      "unit": "%"
    }
  ]
}

Troubleshooting ​

IssueSolution
No data deliveredVerify the profile is Enabled and target is reachable
Wrong execution orderIncrease Priority value to run earlier
Authentication errorsDouble-check credentials in Target Config
Invalid JSON configUse a JSON validator to check syntax

Need Help? ​

Contact us at [email protected] for technical support.