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.