Create a portal

After you have created the asset hierarchy you are ready to create a Monitor portal to visualize your equipment. You can manage who has access to your data by using AWS Single Sign-On or IAM. In the workshop you will use IAM based authentication.

Retrieve your IAM user or role

Before creating the Monitor portal retrieve your IAM user or role which you are using to access the AWS Management console. You will assign this user or role as a portal administrator.

To get the current user you can use AWS CloudShell or the AWS Management console.


  1. Open CloudShell.
  2. At the command prompt enter: aws sts get-caller-identity --query 'Arn' to get the arn you are using.
  3. If the arn contains :user you are using an IAM user, if it contains :assumed-role you are using a role.

AWS Management console

  1. On the navigation bar, choose your account name.
  2. The menu that you see varies with the type of account that you used to sign in.
  3. If the menu contains Currently active as: you are using a role that you have switched to, if it contains IAM User: you are logged in as a user.

Make a note of the IAM user or role. You will need during the portal creation process.

To create the portal

  1. Navigate to the AWS IoT SiteWise console
  2. Open the navigation pane by choosing the three bars in the upper left corner.
  3. In the navigation pane, choose Portals, and then Create portal.
  4. Under Portal name, enter PowerPlants.
  5. Under User authentication, choose IAM.
  6. Under Email, enter a valid email address where you have access to.
  7. Under Permissions, choose Create and use a new service role.
  8. Choose Next.
  9. Under Alarms, deselect Enable alarms.
  10. Under Edge Configuration, deselect Enable this portal at the edge.
  11. Choose Create.
  12. Under Invite administrators, under Users or Roles, choose the user or role you are using, and then choose Next.
  13. Under Assign users, do not choose any user or role, choose Assign users.
  14. Under Portals you should find the portal with the name PowerPlants.
  15. To access your Monitor portal, choose the link which starts with https:// located right from your portal name.

Browse the asset library

By browsing the asset library you can get a first impression about the visualisations for your data.

In your Monitor portal

  1. Choose Assets.
  2. Under Assets, expand All Power Plants, and then expand Power Plant 1.
  3. Choose Generator-1.
  4. Under Generator-1 in the right pane you should see the measurements and metrics that you have defined in the generator asset model.
  5. Feel free to browse around

Create a project

To build dashboards later first you need to create a project.

  1. Projects
  2. Create project
  3. Project name: Energy monitoring
  4. Project description: Energy production monitoring
  5. Create project

Add project assets

Each project contains assets based. Based on these assets you can create dashboards to visualize your data.

  1. Project assets
  2. Go to asset library
  3. Select All Power Plants
  4. Add asset to project
  5. Check: Select existing project
  6. Select an existing project: Energy monitoring
  7. Add asset to project

Only one asset can be added to a project. You see why hierarchies are important in that case?

Create a dashboard

The dashboard should contain the overall power output and a visualisation that shows produced power, rpm and temperature per generator.

  1. Create dashboard
  2. Drag power_all_plants_5m to the left
  3. Expand All Power Plants
  4. Expand Power Plant 1
  5. Click Generator-1
  6. Drag sum_watts_5m from Generator-1 to the left
  7. Drag rpm from Generator-1 into the sum_watts_5m widget
  8. Edit the name of widget: Generator-1

Create the same visualization for Generator-2

Replace the default dashboard name New dashboard with something meaningful.

Click Save dashboard to save your dashboard.

Create a dashboard that monitors the power produced (watts_1m) and the temperature for Generator 1 and 2. What is your observation?