Skip to main content

​
Overview

Connect an AWS S3 bucket to backfill historical telemetry data into Telemetron. This integration reads compressed CSV files from your bucket and imports them using the Backfill Manager, allowing your AI support agent to reference historical device data during conversations.

​
Prerequisites

  • An AWS S3 bucket containing historical telemetry data in compressed CSV format
  • An IAM user with an access key, or an IAM role that Telemetron can assume
  • The IAM role must have a trust policy allowing Telemetron to assume it, plus permissions to list and read objects in the bucket (s3:ListBucket, s3:GetObject)

​
Setup

1

Open the Integration Page

Go to Settings > Integrations > AWS S3 Bucket.
2

Enter AWS Credentials

Provide the following credentials:
  • AWS Access Key ID — The access key for your IAM user
  • AWS Secret Access Key — The corresponding secret key
  • IAM Role ARN — The ARN of the IAM role Telemetron will assume (e.g., arn:aws:iam::123456789012:role/TelemetronS3ReadRole)
The IAM role must include a trust policy that allows Telemetron to assume it. Example trust policy:
{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "AWS": "arn:aws:iam::TELEMETRON_ACCOUNT_ID:root"
      },
      "Action": "sts:AssumeRole"
    }
  ]
}
3

Configure Bucket Details

  • Bucket Name — The name of your S3 bucket
  • Region — Select the AWS region where the bucket is located
4

Test and Connect

Click Test Connection to verify Telemetron can access the bucket with the provided credentials. If the test succeeds, click Connect S3 Bucket to finalize the integration.

​
Configuration

After connecting, the integration page displays:
FieldValue
BucketYour connected bucket name
RegionThe bucket’s AWS region
Role ARNThe IAM Role ARN (masked for security)

​
Prefix Mappings

Configure prefix mappings to tell Telemetron how to interpret the directory structure in your bucket. This maps S3 key prefixes to device identifiers and telemetry types.

​
Backfill Manager

Use the Backfill Manager to import historical data from the connected bucket:
  1. Select the prefix or directory containing the files to import
  2. Choose a date range to filter which files to process
  3. Start the backfill — Telemetron reads and ingests the compressed CSV files

​
How It Works

Telemetron assumes the configured IAM role to access your S3 bucket with read-only permissions. It lists objects matching your prefix mappings, downloads compressed CSV files, parses the telemetry data, and imports it into your organization’s telemetry store. The AI support agent can then query this historical data when helping customers troubleshoot device issues.

​
Troubleshooting

IssueResolution
Connection test failsVerify the Access Key ID, Secret Access Key, and Role ARN are correct. Ensure the IAM role trust policy allows Telemetron to assume it.
Permission denied errorsConfirm the IAM role has s3:ListBucket and s3:GetObject permissions on the target bucket and objects.
No files found during backfillCheck that your prefix mappings match the actual directory structure in the bucket. Verify the CSV files are present in the expected paths.
Backfill fails on specific filesEnsure files are valid compressed CSV format. Check that the CSV schema matches the expected telemetry format.