Skip to content

S3/OSS Forwarding

Archive device data to Amazon S3, Alibaba Cloud OSS, or any S3-compatible storage. Ideal for long-term data retention, compliance, and batch analytics.

Overview

Device data is automatically stored as JSON files in your object storage bucket, organized by date and device.

Quick Start

Step 1: Prepare Your Storage

  1. Create an S3 bucket (or OSS bucket)
  2. Create access credentials with write permissions
  3. Note your bucket name and region

Step 2: Create a Forwarding Profile

  1. Go to Org → Data Forwarding
  2. Click + New Profile
  3. Select S3/OSS as the type
  4. Enter your storage details
  5. Click Save

Configuration Options

OptionRequiredDescription
BucketYesYour bucket name
Access KeyYesAccess key ID
Secret KeyYesSecret access key
EndpointNoCustom endpoint (for OSS, MinIO, etc.)

Data Format

Data is stored as JSON files:

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"
    }
  ]
}

Security Tips

  • Create a dedicated user with write-only permissions
  • Use bucket policies to restrict access
  • Enable encryption for sensitive data

Troubleshooting

ProblemSolution
Access DeniedVerify access key and secret
Bucket not foundCheck bucket name and region
Connection failedVerify endpoint URL

Use Cases

  • Long-term Archival: Store data for compliance requirements
  • Batch Analytics: Process data with AWS Athena, Spark
  • Backup: Keep copies of all device data

Need Help?

Contact us at [email protected] for technical support.