AWS SiteWise Integration Guide

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 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 step b add tags step c create outbound topics for connector you will now need to import the tags you added to the connector as topics note if there any existing inbound topics already created for the connector, disable them before creating the outbound topics 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 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 note if there any existing outbound topics already created for the connector, disable them before creating the outbound topics to create inbound topics navigate to integration click the connector tile click the topics tab click the add a new subscription icon the data integration dialog box appears 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 click yes to add the topic 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