Ubidots and AWS have partnered to create a pre-built integration allowing users to easily forward sensor data from Ubidots to AWS S3, using Plugins.
Table of Contents
Retrieve an AWS User Access Keys
Creating AWS S3 Backup Plugin
Editing the Plugin's
Feedback & suggestions
1. Retrieve your AWS Access Keys
To retrieve your AWS Access Keys, go to your AWS IAM Management console, then click on the “Users” option at the left panel, and follow these steps:
Click on the "Add user" button.
Enter a name for the user, Select the option “Programmatic Access” and move to next page.
Click on the option "Attach existing policies directly". Look for "IAMFullAccess" and select it.
Skip the tags page and move to next page.
Click on the "Create user" button.
Copy the “Access key ID” and the “Secret access key” which will be used later to complete the AWS Plugin on Ubidots platform. You can also download the keys with the "Download .csv" button.
2. Creating an AWS S3 Backup Plugin
Step 1: In your Ubidots account, go to the "Devices" tab, click on "Plugins", then click on the "+" icon to create a new Plugin. Search for the AWS S3 Backup, click on it and follow the on-screen steps:
Step 2: An authentication window will appear. Enter your AWS Access Key ID and Secret Access Key created earlier in this guide. By entering your AWS Access Keys, Ubidots will automatically setup the required resources in AWS to complete the integration.
IMPORTANT NOTE: As a security measure, Ubidots does NOT store any AWS Access Key IDs or Secret Keys. The permission with Access Keys is used only once at the beginning of a Plugin's setup to create a restricted role in AWS and securely setup AWS resources to stream data to Ubidots. If you’d rather not provide your AWS keys, an advanced integration can be setup using AWS IAM Role and this user guide.
Step 3: After successful authentication, the plugin configuration options will appear:
Backup data from: This drop-down defines the source of the backup data. Possible options are: Devices, Organizations, Device Groups, and Device Types. The Devices option will backup data from all devices. The last three options backup data from one single entity.
AWS Region: The AWS region where you currently use AWS S3 storage, or plan to.
S3 Bucket Name: Your S3 bucket from your AWS Account. Please note: The bucket has to exist in your AWS account and the connected AWS account has to have permissions to access this S3 bucket, otherwise the plugin will fail.
Upload Path: The path in the S3 bucket to which the backup will be uploaded to. Please note: The Upload Path cannot start or end with a "/".
Date range: The time range of the data that is backed up and uploaded to S3.
Backup every: The frequency of the backup.
On: The day or day of month at which the backup is executed.
At: The time when the backup is executed.
Timezone: The timezone of the "At" field.
Ubidots Token: Select the Ubidots token you'd like to use for this plugin.
Ubidots will not create any resource in your AWS account. The plugin uploads a csv file to the specified location defined by the S3 bucket name and the upload path. Costs may arise due to the data transmission.
Step 4: Finish the process and a new plugin will appear in the Plugins list.
The plugin regularly collects and compiles the data from the selected Ubidots data entities into a csv file. This csv file is then uploaded to the upload path in the defined S3 bucket in your AWS Account.
3. Editing the Plugin's
To edit the Plugin, simply click on the Edit button in the Plugins list view:
The same "Input" fields that appeared during the creation process will appear. Please note that, every time the Plugin is updated, a provisioning script will run, overriding the current attributes.
4. Plugin costs
This plugin consumes dots out each time a backup is made. To learn how the data extraction is billed, please refer here.
5. Feedback and suggestions
Learn more about other plugins: