Getting started with Amazon IoT SiteWise Monitor
If you're the Amazon administrator for your organization, you create portals from the Amazon IoT SiteWise console. Complete the following steps to create a portal so that members of your organization can view your Amazon IoT SiteWise data:
-
Configure and create a portal
-
Add portal administrators and send invitation emails
-
Add portal users
After you create a portal, the portal administrator can view your Amazon IoT SiteWise assets and assign them to projects in the portal. Project owners can then create dashboards to visualize the properties of the assets that help project viewers understand how your devices, processes, and equipment are performing.
You can follow a tutorial that walks through the steps required to set up a portal with a project, dashboards, and multiple users for a specific scenario using wind farm data. For more information, see Visualizing and sharing wind farm data in Amazon IoT SiteWise Monitor.
Creating a portal
You create a SiteWise Monitor portal in the Amazon IoT SiteWise console.
To create a portal
-
Sign in to the Amazon IoT SiteWise console
. -
In the navigation pane, choose Monitor, Getting started.
-
Choose Create Portal.
Next, you must provide some basic information to configure your portal.
Configuring your portal
Your users use portals to view your data. You can customize a portal's name, description, branding, support contact email, and permissions.

To configure a portal
-
Enter a name for your portal.
-
(Optional) Enter a description for your portal. If you have multiple portals, use meaningful descriptions to help you keep track of what each portal contains.
-
(Optional) Upload an image to display your brand in the portal. Choose a square, PNG image. If you upload a non-square image, the portal scales the image down to a square.
-
Enter an email address that portal users can contact when they have an issue with the portal and need help to resolve it.
-
(Optional) Add tags for your portal. For more information, see Tagging your Amazon IoT SiteWise resources.
-
Choose one of the following options:
-
Choose Create and use a new service role. By default, SiteWise Monitor automatically creates a service role for each portal. This role allows your portal users to access your Amazon IoT SiteWise resources. For more information, see Using service roles for Amazon IoT SiteWise Monitor.
-
Choose Use an existing service role, and then choose the target role.
-
-
Choose Next
-
Choose Create. Amazon IoT SiteWise will create your portal.
Note If you close the console, you can finish the setup process by adding administrators and users. For more information, see Adding or removing portal administrators. If you don't want to keep this portal, delete it so it doesn't use resources. For more information, see Deleting a portal.
The Status column can be one of the following values.
-
CREATING ‐ Amazon IoT SiteWise is processing your request to create the portal. This process can take several minutes to complete.
-
UPDATING ‐ Amazon IoT SiteWise is processing your request to update the portal. This process can take several minutes to complete.
-
PENDING ‐ Amazon IoT SiteWise is waiting for the DNS record propagation to finish. This process can take several minutes to complete. You can delete the portal while the status is PENDING.
-
DELETING ‐ Amazon IoT SiteWise is processing your request to delete the portal. This process can take several minutes to complete.
-
ACTIVE ‐ When the portal becomes active, your portal users can access it.
-
FAILED ‐ Amazon IoT SiteWise couldn't process your request to create, update, or delete the portal. If you enabled Amazon IoT SiteWise to send logs to CloudWatch Logs, you can use these logs to troubleshoot issues. For more information, see Monitoring Amazon IoT SiteWise with CloudWatch Logs
.
A message appears when your portal is created.

Next, you must invite one or more portal administrators to the portal. So far, you created a portal but no one can access it.
Inviting administrators
To get started in your new portal, you must assign a portal administrator. The portal administrator creates projects, chooses project owners, and assigns assets to projects. Portal administrators can see all of your Amazon IoT SiteWise assets.
Based on the user authentication service, choose one of the following options:
You can change the list of portal administrators later. For more information, see Adding or removing portal administrators.
Because only a portal administrator can create projects and assign assets to them, you should specify at least one portal administrator.
As the last step, you add users who can access your new portal.
Adding portal users
You control which users have access to your portals. In each portal, the portal administrators create one or more projects and assign portal users as owners or viewers for each project. Each project owner can invite additional portal users to own or view the project.
Based on the user authentication service, choose one of the following options:
Congratulations! You successfully created a portal, assigned portal administrators, and assigned users who can use that portal when invited to do so. Your portal administrators can now create projects and add assets to those projects. Then, your project owners can create dashboards to visualize the data for each project's assets.
You can change the list of portal users later. For more information, see Adding or removing portal users.
If you need to make changes to the portal, see Administering your SiteWise Monitor portals.
To get started in the portal, see Getting started in the SiteWise Monitor Application Guide.