Configure storage settings for cold tier (console)

The following procedure shows you how to configure the storage settings to replicate data to the cold tier in the AWS IoT SiteWise console.

To configure storage settings in the console

1. Navigate to the AWS IoT SiteWise console.

2. In the navigation pane, under Settings, choose Storage.

3. In the upper-right corner, choose Edit.

4. On the Edit storage page, do the following:

   1. For Storage settings, choose Enable cold tier storage. The cold tier storage is disabled by default.

   2. For S3 bucket location, enter the name of an existing Amazon S3 bucket and a prefix.

      Note

      • Amazon S3 uses the prefix as a folder name in the Amazon S3 bucket. The prefix must have 1-255 characters and end with a forward slash (/). Your AWS IoT SiteWise data is saved in this folder.

      • If you don't have an Amazon S3 bucket, choose View, and then create one in the Amazon S3 console. For more information, see Create your first S3 bucket in the Amazon S3 User Guide.

   3. For S3 access role, do one of the following:

      • Choose Create a role from an AWS managed template, AWS automatically creates an IAM role that allows AWS IoT SiteWise to send data to Amazon S3.

      • Choose Use an existing role, and then choose the role that you created from the list.

        Note

        • You must use the same Amazon S3 bucket name for the S3 bucket location that you used in the previous step and in your IAM policy.

        • Make sure that your role has the permissions shown in the following example.

          Example permissions policy:

          {
                "Version": "2012-10-17",
                "Statement": [
                    {
                        "Effect": "Allow",
                        "Action": [
                            "s3:PutObject",
                            "s3:GetObject",
                            "s3:DeleteObject",
                            "s3:GetBucketLocation",
                            "s3:ListBucket"
                        ],
                        "Resource": [
                            "arn:aws:s3:::bucket-name",
                            "arn:aws:s3:::bucket-name/*"
                        ]
                    }
                ]
            }

          Replace bucket-name with the name of your Amazon S3 bucket.

   4. To setup hot tier, see Step 5 in Configure storage settings for warm tier (console).

   5. (Optional) For AWS IoT Analytics integration, do the following.

      1. If you want to use AWS IoT Analytics to query your data, choose Enabled AWS IoT Analytics data store.

      2. AWS IoT SiteWise generates a name for your data store or you can enter a different name.

      AWS IoT SiteWise automatically creates a data store in AWS IoT Analytics to save your data. To query the data, you can use AWS IoT Analytics to create datasets. For more information, see Working with AWS IoT SiteWise data in the AWS IoT Analytics User Guide.

   6. Choose Save.

In the AWS IoT SiteWise storage section, the Cold tier storage can be one of the following values:

• Enabled – AWS IoT SiteWise replicates your data to the specified Amazon S3 bucket.

• Enabling – AWS IoT SiteWise is processing your request to enable the cold tier storage. This process can take several minutes to complete.

• Enable_Failed – AWS IoT SiteWise couldn't process your request to enable the cold tier storage. If you enabled AWS IoT SiteWise to send logs to Amazon CloudWatch Logs, you can use these logs to troubleshoot issues. For more information, see Monitoring with Amazon CloudWatch Logs.

• Disabled – The cold tier storage is disabled.