Visualize and share data in Grafana

1. Sign in to the Amazon Managed Grafana console.

2. Choose Create workspace.

3. Under Workspace details, enter a name for your workspace, such as SiteWiseTutorialDemo.

4. Under Grafana version, choose the latest version. Choose this version for the most up-to-date features and capabilities. For more information about different version sets, see Differences between Grafana versions in the Amazon Managed Grafana User Guide.

5. Choose Next.

6. Under Authentication access, choose AWS IAM Identity Center.

   • If AWS IAM Identity Center in your account isn't enabled, you will be prompted to set it up first. For detailed instruction about how to set up user access, see Identity-based policy examples for Amazon Managed Grafana in the Amazon Managed Grafana User Guide.

7. Under Permission type, choose Service managed. Amazon Managed Grafana automatically creates and configures the necessary IAM roles and permissions for any AWS data sources you choose to use in this workspace. For organizational member accounts, the Service managed option is only available if the account is designated as a delegated administrator. For information about setting up delegated administrator accounts, see Register a delegated administrator member account in the AWS CloudFormation User Guide.

8. Under Workspace configuration options, take the following actions:

   1. Select Turn Grafana alerting on. With this setting, you can create and manage alerts through a centralized interface in your workspace. For more information, see Working with Grafana alerting in the Amazon Managed Grafana User Guide.

   2. Select Turn plugin management on. This allows you to install, update, and uninstall plugins in your workspace. For more information, see Extend your workspace with plugins in the Amazon Managed Grafana User Guide.

   Important

   Be sure to enable plugin management. If you don't select this option, you cannot add AWS IoT SiteWise as a data source in the following step.

9. Under Network access control, choose Open access. You use demo data in this tutorial, so you can make the workspace publically available.

   • Open access – Allows your workspace to be publicly accessible.

   • Restricted access – Limits access to specific IP ranges or VPC endpoints. For more information, see How VPC connectivity works in the Amazon Managed Grafana User Guide.

10. Choose Next.

11. Under the Service managed permission settings page, choose Current account to have Amazon Managed Grafana automatically create policies and permissions for accessing AWS data within your account.

12. Under Data sources, select AWS IoT SiteWise. For more information, see Connect to an AWS IoT SiteWise data source in the Amazon Managed Grafana User Guide.

13. (Optional) Under Notification channels, select Amazon SNS to enable Grafana alerts to be sent through Amazon SNS, This creates an IAM policy that allows publishing to Amazon SNS topics with names starting with Grafana. You need to complete the notification channel setup later in your Grafana console within the workspace.

14. Confirm the workspace details, and choose Create workspace. This process takes a couple of minutes.

15. On the Authentication tab, under AWS IAM Identity Center. assign users or groups to your workspace by doing the following:

    1. To assign the user who will manage AWS IoT SiteWise data, choose Assign new user or group. Then choose Make admin from the Actions dropdown list to grant them administrative privileges.

       Important

       To manage the Grafana workspace, you must assign the Admin role to at least one user. This user will have full access to the Grafana workspace console.

1. Open the Amazon Managed Grafana console. In your workspace details page, choose the URL displayed under Grafana workspace URL. The workspace URL opens the Grafana workspace console login page.

2. Choose Sign in with AWS IAM Identity Center and enter your credentials. These credentials only work if you responded to the email from Amazon Managed Grafana that prompted you to create a password for IAM Identity Center.

3. In the left navigation pane, choose Apps, then AWS Data Sources, and then select the AWS services tab.

4. Under AWS IoT SiteWise, choose Install now to install the latest version of the AWS IoT SiteWise plugin.

5. Navigate to the Data sources tab, and select IoT SiteWise as the service.

6. Under Default region, select the Region where you want to retrieve data from, for example, US East (N. Virginia).

7. After specifying the parameters for the plugin, select Add data source.

8. Select Go to settings.

9. Under Connection details, select Save and test to verify that the service is working.

1. In the left navigation pane, select Dashboards and then choose Create Dashboard to start building your first dashboard.

2. Select Add visualization. This opens the panel editor where you can configure data sources, queries, and visualization settings.

3. Under the Query tab, select the AWS IoT SiteWise data source from the dropdown menu.

4. Under Query type, select Get property value aggregates from the dropdown menu to retrieve aggregated values for asset properties over time.

5. Select Explore to view available assets in your hierarchy. From the Hierarchy tab, select Demo Wind Farm Asset, and then select Demo Turbine Asset 1.

6. Under Property, select Average Power from the available properties. Select Run queries to run the query so you can preview the output. The visualization will update to show the average power data for Demo Turbine Asset 1.

7. In the right navigation pane, give the new panel a title, such as Turbine Demo 1 (Average Power). Choose Apply to save your changes.

   Warning

   Whenever you make any changes to the dashboard, save the dashboard before refreshing the page or navigating away. Otherwise, you will lose your progress.

8. In the top-right corner, select Save dashboard. You will be prompted to enter a name for your dashboard, for example, SiteWise Wind Farm Demo Dashboard.

9. Choose Save.

1. Select Add visualization to open a blank panel.

2. Under the Query tab, select the AWS IoT SiteWise data source from the dropdown menu.

3. Under Query type, select Get property value from the dropdown menu and under Asset, select Demo Wind Farm Asset, then Demo Turbine Asset 1.

4. Under Property, select Wind Speed from the available properties. Select Run queries to update the changes.

5. Under Visualization, select Gauge. Gauges work best for displaying single, real-time metrics like wind speed.

6. In the right navigation pane, give the new panel a title, such as Turbine Demo 1 (Wind Speed).

7. Under Standard options from the Panel options, select Unit. Choose Velocity, and then choose meters/second (m/s).

8. Choose Apply to save your changes.

   The following image displays what your Grafana dashboards might look like when you complete this step.

   

To set up alerts in Grafana

1. Under the Rule tab in the Turbine Demo 1 (Average Power), set Evaluate every to 5m and For to 15m. This configuration evaluates the average power every 5 minutes and triggers an alert if the condition persists for longer than 15 minutes.

2. Under Conditions, select IS BELOW and enter 7,020 watts. This setting will notify you if average turbine conditions fall below 7,020 watts for longer than 5 minutes. For more information about creating alerts, see Alert rule fields in the Amazon Managed Grafana User Guide.

The AWS IoT SiteWise demo deletes itself after a week, or the number of days you chose if you created the demo stack from the AWS CloudFormation console. You can delete the demo before if you are done using the demo resources. You can also delete the demo if the demo fails to create. Use the following steps to delete the demo manually.

(optional) To delete the AWS IoT SiteWise demo

1. Navigate to the AWS CloudFormation console.

2. Choose IoTSiteWiseDemoAssets from the list of Stacks.

3. Choose Delete.

   When you delete the stack, all of the resources created for the demo are deleted.

4. In the confirmation dialog, choose Delete stack.

   The stack takes around 15 minutes to delete. If the demo fails to delete, choose Delete in the upper-right corner again. If the demo fails to delete again, follow the steps in the AWS CloudFormation console to skip the resources that failed to delete, and try again.

If you delete an Amazon Managed Grafana, all the configuration data for that workspace is also deleted. This includes dashboards, data source configuration, alerts, and snapshots.

To delete an Amazon Managed Grafana workspace

1. Open the Amazon Managed Grafana console.

2. In the left navigation pane, choose the menu icon.

3. Choose All workspaces.

4. Choose the name of the workspace that you want to delete.

5. Choose Delete.

6. To confirm the deletion, enter the name of the workspace and choose Delete.

   Note

   This procedure deletes a workspace. Other resources may not be deleted. For example, IAM roles that were in use by the workspace are not deleted (but may be unlocked if they are no longer in use).