---
title: AWS SiteWise Integration Guide
slug: bhdo/aws-sitewise-integration-guide
createdAt: 2024-01-30T20:19:55.055Z
---

Review the following guide for setting up an integration between Belden Horizon Data Operations (BHDO) 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 Belden Horizon Data Operations.

- **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 BHDO

Once you have collected the required AWS connection parameters, follow the steps to [Add a Connector](docId\:tkKE__fVsjbk_6yAmnFNW) 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 Belden Horizon Data Operations 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/vAqK-046vdh4I0e1y9cfX/7aveD661ZqLmfvP20SQqp_awssitewise.png" size="60" width="370" height="345" position="center" showCaption="false"}

If you see a *Failed *status, review the [Connector Logs](docId\:q8Q3J9CWP9n67ro4lmdZV) and any 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\:T-cWPe0_Jsfw5-aoj8WPP). 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** check box. 

### Step b: Add Tags

After connecting the device in Belden Horizon Data Operations, you can [Add Tags](docId\:Wpe2HMXelARLBnhWbuChY) 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.

   ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/4fC8yaOKctxiiTvUDGfWu_import-from-devicehub.png" size="80" width="1148" height="570" position="center" showCaption="false"}
4. Select all the tags to import and click **Import**. 

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

To enable the topics, return to the *Topics *tab and click the **Enable all topics** icon. 

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/bCV1JMfeMF7XQryi1HSGr_enable-all-topics.png" size="80" width="1148" height="570" caption="Enable all topics icon" position="center" showCaption="true"}

### Step e: Verify Connection

You can now access your AWS account to verify that data is successfully being sent from Belden Horizon Data Operations. 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 to 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/vAqK-046vdh4I0e1y9cfX/pmskO_UXJLZ5JXbZv_q7D_addsubscriptionawssitewise.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 Belden Horizon Data Operations. 
   - **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 Belden Horizon Data Operations

You have several options for verifying the connection in Belden Horizon Data Operations. 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\:Tqwkj8SRx-njYZTl8s_6C) such as Grafana. 

You can also view the data in the [Flows Manager](docId\:DnmYuzxTFXkY03jWRMRoJ) and [Analytics](docId\:AtWhYuuQVQvqLnxc_4vHn) areas of Belden Horizon Data Operations. 

- If you are creating a flow from the [Flows Manager](docId\:DnmYuzxTFXkY03jWRMRoJ), subscribe to the *Local Data Topic* name using the **DataHub Subscribe** node. 
- If you are using [Analytics](docId\:AtWhYuuQVQvqLnxc_4vHn), select the DataHub Subscribe processor and use the *Local Data Topic* name. See [Create an Analytics Flow](docId\:GBpQl9cMN2vQUWnTTPmTK) and [Add Processors and Processor Connections](docId\:jcK438gF_smkaxvpq-u8m) to learn more.