AWS S3 Bucket

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

Open the Integration Page

Go to Settings > Integrations > AWS S3 Bucket.

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

Configure Bucket Details

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

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:

Field	Value
Bucket	Your connected bucket name
Region	The bucket’s AWS region
Role ARN	The 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:

Select the prefix or directory containing the files to import
Choose a date range to filter which files to process
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

Issue	Resolution
Connection test fails	Verify 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 errors	Confirm the IAM role has `s3:ListBucket` and `s3:GetObject` permissions on the target bucket and objects.
No files found during backfill	Check 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 files	Ensure files are valid compressed CSV format. Check that the CSV schema matches the expected telemetry format.

Getting Started

Support Platform

Integrations

Overview

Prerequisites

Setup

Configuration

Prefix Mappings

Backfill Manager

How It Works

Troubleshooting

​Overview

​Prerequisites

​Setup

​Configuration

​Prefix Mappings

​Backfill Manager

​How It Works

​Troubleshooting

Overview

Prerequisites

Setup

Configuration

Prefix Mappings

Backfill Manager

How It Works

Troubleshooting