---
title: AWS SiteWise Integration Guide
slug: litmusedge/litmusedge-with-aws-iot-sitewise
description: Learn how to set up the AWS SiteWise connector. 
docTags: 
createdAt: 2024-01-25T21:35:04.621Z
---

Review the following guide for setting up an integration between Litmus Edge and AWS SiteWise. 

# Before You Begin

You need to create an AWS account. See [Setting up an AWS account](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/set-up-aws-account.html) to learn more. 

Refer to the following AWS resources to learn more about AWS SiteWise:

- [What is AWS IoT SiteWise](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/what-is-sitewise.html)
- [Key Components](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/feature-overview.html)
- [Ingesting data to AWS IoT SiteWise](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/industrial-data-ingestion.html)
- [Interacting with other AWS services](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/interact-with-other-services.html)

# Step 1: Collect AWS SiteWise Connection Parameters

You will need the following parameters to configure the connection in Litmus Edge.

- **Region**: You need to get the region name for your AWS account. See [AWS IoT SiteWise endpoints and quotas](https://docs.aws.amazon.com/general/latest/gr/iot-sitewise.html) and [Specify which AWS Regions your account can use](https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-regions.html) to learn more. 
- **Access Key**: Copy and paste the access key somewhere securely. See [Managing access keys for IAM users](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html) and [Identity and access management for AWS IoT SiteWise](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/security-iam.html) to learn more. 
- **Secret Access Key**: Copy and paste the secret access key somewhere securely. See [Managing access keys for IAM users](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html) and [Identity and access management for AWS IoT SiteWise](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/security-iam.html) to learn more. 

# Step 2: Add AWS SiteWise Connector in Litmus Edge

Once you have collected the required AWS connection parameters, follow the steps to [Add a Connector](docId\:ytsWGWeU6H6oEUnHj5hW3) and select the **AWS SiteWise Connector** provider. 

Configure the following parameters. 

- **Name**: Enter a name for the connector. 
- **Region**: Enter the region name you collected in Step 1 that is associated with your AWS account.
- **Access key**: Paste the access key collected in Step 1. 
- **Secret access key**: Paste the secret access key collected in Step 1. 
- **Subscribe interval**: Enter the subscription interval in seconds. Subscribe interval defines the time in seconds between consecutive data update notifications for a subscribed asset property, specifying the frequency at which the system checks and receives updates on the specified property within the IoT SiteWise platform. 
- **Number of batch messages**: Enter the number of batch messages to publish. This value refers to the quantity of grouped data transmissions.  
- **Throttling limit**: The maximum number of messages per second to be processed. The default value is zero, which means that there is no limit. 
- **Persistent storage**: When enabled, this will cause messages to undergo a store-and-forward procedure. Messages will be stored within Litmus Edge when cloud providers are online.  
- **Queue Mode**: Select the queue mode as **lifo **(last in first out) or **fifo **(first in first out). Selecting **lifo **means that the last data entry is processed first, and selecting **fifo **means the first data entry is processed first. 

# Step 3: Enable the Connector

After adding the connector, click the toggle in the connector tile to enable it. 

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/Zb90FCTloAnIiMZ0bPDtV_awssitewise.png" size="60" width="388" height="358" position="center" showCaption="false"}

If you see a *Failed *status, you can review the [Connector Logs](docId\:BEQQ0sSzwsv9v9rIF3rhk) and relevant error messages. 

# Step 4: Set up Connection (Outbound or Inbound) with AWS SiteWise

You have the option of setting up an outbound or inbound connection. 

## Set up Outbound Connection

To set up an outbound connection, you will need to create a DeviceHub device and tags. The tags will be used to send data to AWS SiteWise. 

### Step a: Add Device

Follow the steps to [Connect a Device](docId:3eyAfPpweuVmBLCEy17sq). The device will be used to store tags that will be eventually used to create outbound topics in the connector. Make sure to select the **Enable Data Store** checkbox. 

### Step b: Add Tags

After connecting the device in Litmus Edge, you can [Add Tags](docId:8sE7z3PmRfwL1nmzcwaLX) to the device. Create tags that you want to use to create outbound topics for the connector. 

### Step c: Create Outbound Topics for Connector

You will now need to import the tags you added to the connector as topics. 

:::hint{type="info"}
**Note**: If there any existing inbound topics already created for the connector, disable them before creating the outbound topics. 
:::

**To create outbound topics:**

1. Click the connector tile.
   The connector *Dashboard *appears. 
2. Click the **Topics **tab. 
3. Click the **Import from DeviceHub** tags icon. 
   The *DeviceHub Import *dialog box appears.

![](https://api.main.archbee.co/api/optimize/xSuIWwMa6RnsbeD5Kdqd7-zaOGMDYbPZWYALvLBgotp-20250606-203859.png)

After adding all required topics, navigate to the Integration overview page and ensure the connector is not disabled and still shows a CONNECTED status. 

### Step d: Enable Topics

Ensure the topics you imported are enabled by returning to the *Topics *tab and clicking the **Enable all topics** icon. 

![](https://api.main.archbee.co/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/HtkW-nbWXeAvOV8ru8B1U_image.png)

### Step e: Verify Connection

You can now access your AWS account to verify that data is successfully being sent from Litmus Edge. See [Ingesting data to AWS IoT SiteWise](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/industrial-data-ingestion.html) to learn more. 

## Set up Inbound Connection

You have the option of subscribing to data from AWS SiteWise. 

### Step a: Create Inbound Topics for Connector

You will create topics for the connector that will subscribe to data from associated AWS SiteWise topics. 

:::hint{type="info"}
**Note**: If there any existing outbound topics already created for the connector, disable them before creating the outbound topics. 
:::

**To create inbound topics: **

1. Navigate to **Integration**. 
2. Click the connector tile. 
3. Click the **Topics **tab. 
4. Click the **Add a new subscription** icon. 
   The *Data Integration* dialog box appears. 
   ![](https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/1Zn9Nd06yDILd3feonCbz_awssitewiseinboundtopic.png "Add a new subscription icon")
5. Configure the following parameters. 
   - **Data Direction**: Select **Remote to Local - Inbound**. 
   - **Local Data Topic**: Enter a topic name that will be used for subscribing to data in Litmus Edge. 
   - **Remote Data Topic**: Copy and paste the associated topic name from AWS SiteWise. 
   - **Enable**: Select the toggle to enable the topic. 
6. Click **Yes **to add the topic. 
7. From the connector tile, ensure the connector is not disabled and still shows a CONNECTED status. Also verify the topic shows an *Enabled *status. 

### Step b: Verify Connection in Litmus Edge

You have several options for verifying the connection in Litmus Edge. When subscribing to the data, you will need to use the *Local Data Topic* name configured in the previous step. 

You can visualize the incoming data using one of the dedicated [Applications](docId\:iiPaN4OLp8RQzNJc_Q8br) such as [Grafana](docId\:FyzNYYM_3ZfiuoLgo5NlT). 

You can also view the data in the [Flows Manager](docId\:JGhNQYhxbIk8x2nhH5Vte) and [Analytics](docId:8alOe_5_c9uBqJsW0PpCX) areas of Litmus Edge. 

- If you are creating a flow from the [Flows Manager](docId\:JGhNQYhxbIk8x2nhH5Vte), subscribe to the *Local Data Topic* name. See [Subscribe to Topics with Flows](docId\:H640Vah9bim5ZViuT0Yky) to learn more. 
- If you are using [Analytics](docId:8alOe_5_c9uBqJsW0PpCX), select the DataHub Subscribe processor and use the *Local Data Topic* name. See [Create an Analytics Flow](docId\:ewmyJSlRbisGimPDgq82A) and [Add Processors and Processor Connections](docId\:V37iAOLFGYw_7gLaZJt1n) to learn more.