Configure an OPC-UA source (console) - Amazon IoT SiteWise
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

Configure an OPC-UA source (console)

To configure an OPC-UA source using the Amazon IoT SiteWise console

  1. Navigate to the Amazon IoT SiteWise console.

  2. In the navigation pane, choose Gateways.

  3. Select the SiteWise Edge gateway to add an OPC-UA source.

  4. Choose Add data source.

  5. Enter a name for the source.

  6. (Optional) Enter a Data stream prefix. The SiteWise Edge gateway adds this prefix to all data streams from this source. Use a data stream prefix to distinguish between data streams that have the same name from different sources. Each data stream should have a unique name within your account.

  7. Enter the Local endpoint of the data source server. The endpoint can be the IP address or hostname. You may also add a port number to the local endpoint. For example, your local endpoint might look like this: opc.tcp://203.0.113.0:49320

    Note

    If your SiteWise Edge gateway has a Deployment type of Siemens Industrial Edge device - new and you want to ingest data from the Edge OPC UA Server application running on the same Siemens Industrial Edge Device as the Amazon IoT SiteWise Edge application, enter opc.tcp://ie-opcua:48010.

  8. (Optional) For Node ID for selection, add node filters to limit which data streams are ingested to the Amazon Web Services Cloud. By default, SiteWise Edge gateways use the root node of a server to ingest all data streams. To define node filters, you can use node IDs and the * and ** wildcard characters.

  9. For Destinations, choose the destination for the source data:

    • Amazon IoT SiteWise real-time – Choose this to send data directly to Amazon IoT SiteWise storage. Ingest and monitor data in real-time, and process data at the edge.

    • Amazon IoT SiteWise Buffered using Amazon S3 – Send data in parquet format to Amazon S3 and then import into Amazon IoT SiteWise storage. Choose this option to ingest data in batches, and store historical data in a cost-effective way. You can configure your preferred Amazon S3 bucket location, and the frequency at which you want data to be uploaded to Amazon S3. You can also choose what to do with the data after ingestion into Amazon IoT SiteWise. You can choose to have the data available in both SiteWise and Amazon S3 or you can choose to delete it automatically from Amazon S3.

      • The Amazon S3 bucket is a staging and buffering mechanism and supports files in the parquet format.

      • If you select the check box Import data into Amazon IoT SiteWise storage, data is uploaded into Amazon S3 first, and then into Amazon IoT SiteWise storage.

        • If you select the check box Delete data from Amazon S3, data is deleted from Amazon S3, after it is imported into SiteWise storage.

        • If you clear the check box Delete data from Amazon S3, data is stored both in Amazon S3, and in SiteWise storage.

      • If you clear the check box Import data into Amazon IoT SiteWise storage, data is stored only in Amazon S3. It is not imported into SiteWise storage.

      Visit Managing data storage for details on the various storage options Amazon IoT SiteWise provides. To learn more about pricing options, see Amazon IoT SiteWise pricing.

    • Amazon IoT Greengrass stream manager – Use Amazon IoT Greengrass stream manager to send data to the following Amazon Web Services Cloud destinations: channels in Amazon IoT Analytics, streams in Amazon Kinesis Data Streams, asset properties in Amazon IoT SiteWise, or objects in Amazon Simple Storage Service (Amazon S3). For more information, see Manage data streams on the Amazon IoT Greengrass Core in Amazon IoT Greengrass Version 2 Developer Guide.

      Enter a name for the Amazon IoT Greengrass stream.

  10. While configuring a data source, Node ID for selection is used to determine the destination of the data flow.

    • If the same data is published to both Amazon IoT SiteWise real-time and Amazon IoT SiteWise Buffered using Amazon S3, you must add two data sources that publish to both destinations.

    • To split the data so that a part of it is published to Amazon IoT SiteWise real-time, and the other part to Amazon IoT SiteWise Buffered using Amazon S3, you must filter for the following data aliases:

      /Alias01/Data1
/Alias02/Data1
/Alias03/Data1
/Alias03/Data2

      For example, you can add a data source pointing to /**/Data1 node filter, to Amazon IoT SiteWise real-time, and another data source pointing to /**/Data2 Amazon IoT SiteWise buffered using Amazon S3

  11. In the Advanced configuration pane, do the following:

    1. Choose a Message security mode for connections and data in transit between your source server and your SiteWise Edge gateway. This field is the combination of the OPC-UA security policy and message security mode. Choose the same security policy and message security mode that you specified for your OPC-UA server.

    2. If your source requires authentication, choose an Amazon Secrets Manager secret from the Authentication configuration list. The SiteWise Edge gateway uses the authentication credentials in this secret when it connects to this data source. You must attach secrets to your SiteWise Edge gateway's Amazon IoT Greengrass component to use them for data source authentication. For more information, see Configuring data source authentication.

      Tip

      Your data server might have an option named Allow anonymous login. If this option is Yes, then your source doesn't require authentication.

    3. For Property groups, choose Add new group.

    4. Enter a Name for the property group.

    5. For Properties:

      1. (Optional) For Node paths, add OPC-UA node filters to limit which OPC-UA paths are uploaded to Amazon IoT SiteWise. You can use node filters to reduce your SiteWise Edge gateway's startup time and CPU usage by only including paths to data that you model in Amazon IoT SiteWise. By default, SiteWise Edge gateways upload all OPC-UA paths except those that start with /Server/. To define OPC-UA node filters, you can use node paths and the * and ** wildcard characters. For more information, see Using OPC-UA node filters.

    6. For Group settings, do the following:

      1. (Optional) For Data quality setting, choose the type of data quality that you want Amazon IoT SiteWise Collector to ingest.

      2. (Optional) For Scan mode setting, configure following standard subscription properties:

        • For Scan mode, choose the mode that you want Amazon IoT SiteWise to use to collect your data. For more information about scan mode, see Filter data ingestion ranges with OPC-UA.

        • Data change initiation –: You can define the condition that initiates a data change alert.

        • Subscription queue size –: The depth of the queue on an OPC–UA server for a particular metric where notifications for monitored items are queued.

        • Subscription publishing interval –: The interval (in milliseconds) of publishing cycle specified when subscription is created.

        • Snapshot interval –: You can configure the snapshot frequency timeout setting to ensure that Amazon IoT SiteWise Edge ingests a steady stream of data.

        • For Scan rate, update the rate that you want the SiteWise Edge gateway to read your registers. Amazon IoT SiteWise automatically calculates the minimum allowable scan rate for your SiteWise Edge gateway.

      3. (Optional) Configure a Deadband type for your source. This controls what data your source sends to your Amazon IoT SiteWise, and what data it discards. For more information about the deadband setting, see Filter data ingestion ranges with OPC-UA.

    7. Choose Add.

  12. Choose Next.