Skip to main content

​
Overview

Connect AWS IoT Core to automatically forward device telemetry data to Telemetron using IoT Rules. Telemetron provides a downloadable Terraform package that provisions all required AWS resources, including the IoT Rule, IAM roles, and HTTPS destination.

​
Prerequisites

  • An active AWS account with permissions to create IoT Rules, IAM roles, and rule destinations
  • Terraform v1.0+ installed locally
  • AWS CLI configured with appropriate credentials
  • Devices publishing telemetry to MQTT topics in AWS IoT Core

​
Setup

1

Generate Configuration

Go to Settings > Integrations > AWS IoT Core and configure the following:
  • AWS Region — Select your target region:
    Region CodeRegion Name
    us-east-1US East (N. Virginia)
    us-east-2US East (Ohio)
    us-west-1US West (N. California)
    us-west-2US West (Oregon)
    af-south-1Africa (Cape Town)
    ap-east-1Asia Pacific (Hong Kong)
    ap-south-1Asia Pacific (Mumbai)
    ap-south-2Asia Pacific (Hyderabad)
    ap-southeast-1Asia Pacific (Singapore)
    ap-southeast-2Asia Pacific (Sydney)
    ap-southeast-3Asia Pacific (Jakarta)
    ap-southeast-4Asia Pacific (Melbourne)
    ap-northeast-1Asia Pacific (Tokyo)
    ap-northeast-2Asia Pacific (Seoul)
    ap-northeast-3Asia Pacific (Osaka)
    ca-central-1Canada (Central)
    eu-central-1Europe (Frankfurt)
    eu-central-2Europe (Zurich)
    eu-west-1Europe (Ireland)
    eu-west-2Europe (London)
    eu-west-3Europe (Paris)
    eu-south-1Europe (Milan)
    eu-south-2Europe (Spain)
    eu-north-1Europe (Stockholm)
    me-south-1Middle East (Bahrain)
    me-central-1Middle East (UAE)
    sa-east-1South America (São Paulo)
  • IoT Rule Name — Enter a name using only letters, numbers, and underscores (e.g., telemetron_forward_rule)
  • MQTT Topic Filters — Add one or more topic filters that match your device telemetry topics (e.g., device/+/telemetry). Click Add Filter to include additional patterns.
  • Enable CloudWatch Error Logging — Optionally toggle this on to log rule execution errors to CloudWatch for debugging.
Click Download Terraform Package (ZIP) to generate and download the configuration files.
2

Deploy with Terraform

Extract the downloaded ZIP file and deploy from your terminal:
unzip telemetron-iot-terraform.zip
cd telemetron-iot-terraform
terraform init
terraform plan
terraform apply
Review the plan output and type yes to confirm the deployment. Terraform will create the IoT Rule, IAM role, and HTTPS rule destination in your AWS account.
3

Confirm Destination

After Terraform completes, you must manually confirm the HTTPS rule destination:
  1. Open the AWS IoT Rule Destinations console in your selected region
  2. Find the destination created by Terraform and click on it
  3. Click Confirm and activate
  4. AWS sends a confirmation request to the Telemetron endpoint — a confirmation token will appear in the Telemetron integration page
  5. Copy the confirmation token from Telemetron
  6. Paste the token back into the AWS console confirmation dialog and submit
The destination status should change to Enabled once confirmed.
4

Test Connection

Return to the Telemetron integration page and click Test Integration to verify that telemetry data flows correctly from AWS IoT Core to Telemetron.You can also publish a test message via the AWS CLI:
aws iot-data publish \
  --topic "device/my-device-123/telemetry" \
  --payload '{"temperature":25.5,"humidity":60}' \
  --region us-east-1

​
Configuration

Once connected, the integration page displays your organization’s configuration:
FieldDescription
Webhook URLhttps://admin.telemetron.ai/api/telemetry — the endpoint receiving forwarded telemetry
API KeyYour organization’s API key used to authenticate incoming telemetry data

​
How It Works

When a device publishes a message to an MQTT topic that matches one of your configured filters, the AWS IoT Rule forwards the payload to Telemetron’s webhook endpoint over HTTPS. Telemetron ingests the telemetry data, associates it with the correct device, and makes it available to the AI support agent for diagnostics and troubleshooting.

​
Troubleshooting

IssueResolution
Rule name validation errorIoT Rule names can only contain letters, numbers, and underscores. Remove any hyphens, spaces, or special characters.
Destination not confirmingEnsure you complete the confirmation step manually in the AWS console. The destination will remain in a “Pending confirmation” state until the token exchange is completed.
Confirmation token not appearingCheck that the Terraform deployment completed successfully and that the destination URL points to https://admin.telemetron.ai/api/telemetry.
Token validation failedCopy the token exactly as displayed in Telemetron — do not include any leading or trailing whitespace.
No telemetry data arrivingVerify your MQTT topic filters match the topics your devices publish to. Use the AWS IoT MQTT test client to confirm devices are publishing.
SSL/TLS errorsEnsure your AWS region supports TLS 1.2+. Check that no corporate proxy or firewall is blocking outbound HTTPS traffic from AWS IoT.
Authentication failuresVerify the API key in the Terraform configuration matches the key shown on the Telemetron integration page. Regenerate the key if needed.