The SiteWise Monitor feature is not available to new customers. Existing customers can continue to use the service as normal. For more information, see [SiteWise Monitor availability change](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/iotsitewise-monitor-availability-change.html)
# Customize visualizations
As a project owner, you can choose how to best view the asset properties and alarms that you add to your dashboard. You can control the visualization type and customize the visualization.
**Topics**
+ [
## Change visualization types
](#changing-visualization-types)
+ [
## Add data to a visualization
](#adding-data-to-visualization)
+ [
## Remove data from a visualization
](#removing-data-from-visualization)
+ [
## Delete a visualization
](#deleting-visualizations)
+ [
# Choose visualization types
](choose-visualization-types.md)
+ [
# Configure thresholds
](configure-thresholds.md)
+ [
# Configure trend lines
](configure-trend-lines.md)
## Change visualization types
As the project owner, you decide how each asset property or alarm is best represented.
**To change the visualization type**
1. Choose the **Visualization type** icon for the visualization to change.
![\[The icons used to configure a visualization with the "Visualization type" icon highlighted.\]](http://docs.aws.amazon.com/iot-sitewise/latest/appguide/images/dashboard-edit-visualization-type-console.png)
1. In the visualization type bar, choose the icon for the type of visualization to apply.
![\[The visualization type picker.\]](http://docs.aws.amazon.com/iot-sitewise/latest/appguide/images/dashboard-choose-visualization-type-console.png)
For more information, see [Choose visualization types](choose-visualization-types.md).
1. After you finish editing the dashboard, choose **Save dashboard** to save your changes. The dashboard editor closes. If you try to close a dashboard that has unsaved changes, you're prompted to save them.
## Add data to a visualization
As a project owner, you might want to show multiple asset properties and alarms in the same visualization. For example, you might show the temperature of all of your pumps, or the performance and efficiency for a single asset.
**To add data to a visualization**
1. Drag the asset property or alarm that you want to add to a visualization. When you add a property that has an alarm, you also automatically add that alarm as a threshold.
![\[The "Added assets" panel with the delete control highlighted.\]](http://docs.aws.amazon.com/iot-sitewise/latest/appguide/images/dashboard-drag-property-to-visualization-console.png)
1. After you finish editing the dashboard, choose **Save dashboard** to save your changes. The dashboard editor closes. If you try to close a dashboard that has unsaved changes, you're prompted to save them.
## Remove data from a visualization
You can remove asset properties and alarms from visualizations to no longer display them.
**To remove data from a visualization**
1. Choose the **Added assets** icon for the visualization to change.
![\[The icons used to configure a visualization with the "Added assets" icon highlighted.\]](http://docs.aws.amazon.com/iot-sitewise/latest/appguide/images/dashboard-open-added-assets-console.png)
1. Choose the **X** icon on an asset property or alarm to remove it from the visualization.
![\[The "Added assets" panel with the delete control highlighted.\]](http://docs.aws.amazon.com/iot-sitewise/latest/appguide/images/dashboard-view-added-assets-console.png)
1. After you finish editing the dashboard, choose **Save dashboard** to save your changes. The dashboard editor closes. If you try to close a dashboard that has unsaved changes, you're prompted to save them.
## Delete a visualization
As a project owner, if you decide that a visualization isn't needed, you can easily remove it from a dashboard.
**To delete a visualization**
1. Choose the **X** icon for the visualization to remove.
![\[The icons used to configure a visualization with the "Delete icon" highlighted.\]](http://docs.aws.amazon.com/iot-sitewise/latest/appguide/images/dashboard-remove-visualization-console.png)
1. After you finish editing the dashboard, choose **Save dashboard** to save your changes. The dashboard editor closes. If you try to close a dashboard that has unsaved changes, you're prompted to save them.
# Choose visualization types
This section describes the available visualization types. To understand your devices, processes, and equipment, you should choose the right type of visualization for each asset property that you add to a dashboard. Each visualization type is covered in detail in this section. Changing the visualization type doesn't change your data, so you can try different visualizations to discover which type helps you and your project's viewers gain insights from the data.
| Type | Description | Displays alarm state |
| --- | --- | --- |
| [Line](#line-charts) | Best used for properties with frequently reported values where you want to see the trend over time. | No |
| [Scatter](#scatter-charts) | Best used for properties with frequently reported values where you want to see the individual data points. | No |
| [Bar](#bar-charts) | Best used for properties with infrequently reported values, such as daily metrics, where you want to see the trend over time. You can also use bar charts to compare values between multiple properties. | No |
| [Status](#status-widgets) | Best used for alarms and properties that have a small number of states, such as high, medium, and low. You can visualize [current status](#status-grid-chart) as a grid or [historical status](#status-timeline-chart) as a timeline. | Yes |
| [KPI](#kpi-charts) | Best used for properties where the latest value is the most important piece of information. | No |
| [Table](#table-widgets) | Best used to compare values between multiple properties or alarms and display information in one compact widget. | Yes |
## Line
A line graph is a good way to visualize time series data that fluctuates over time. When you drag a time series property to the dashboard, the values for that property are shown as a line graph by default. If that property has an alarm, the line chart shows that alarm's threshold.
**Example**
The following line chart shows four asset properties.
![\[A sample line chart showing four properties.\]](http://docs.aws.amazon.com/iot-sitewise/latest/appguide/images/dashboard-line-graph-console.png)
To display a line graph, choose the line graph icon from the visualization type menu.
![\[The line graph visualization type icon.\]](http://docs.aws.amazon.com/iot-sitewise/latest/appguide/images/dashboard-line-visualization-type-console.png)
## Scatter
You can use a scatter chart to visualize time series data with distinct data points. A scatter chart looks like a line graph without lines between data points. If you add a property that has an alarm, the scatter chart shows that alarm's threshold.
**Example**
The following scatter chart shows one asset property.
![\[A sample scatter chart showing four properties.\]](http://docs.aws.amazon.com/iot-sitewise/latest/appguide/images/dashboard-scatter-chart-console.png)
To display a scatter chart, choose the scatter icon from the visualization type menu.
![\[The scatter chart visualization type icon.\]](http://docs.aws.amazon.com/iot-sitewise/latest/appguide/images/dashboard-scatter-chart-visualization-type-console.png)
## Bar
A bar chart is another way to visualize time series data. You might use a bar chart when your data values change infrequently, such as daily readings. If you add a property that has an alarm, the bar chart shows that alarm's threshold.
**Example**
The following bar chart shows four asset properties.
![\[A sample bar chart showing four properties as a time series.\]](http://docs.aws.amazon.com/iot-sitewise/latest/appguide/images/dashboard-bar-graph-console.png)
To display a bar graph, choose the bar graph icon from the visualization type menu.
![\[The bar graph visualization type icon.\]](http://docs.aws.amazon.com/iot-sitewise/latest/appguide/images/dashboard-bar-visualization-type-console.png)
## Status
A status widget is a good way to visualize data that has a small number of well-defined states, such as an alarm. For example, if you have a pressure indicator that can be high, medium, or low, you could display each state in a different color with a status grid.
You can configure a status widget to show current status as a grid or historical status as a timeline.
**Topics**
+ [
### Status grid
](#status-grid-chart)
+ [
### Status timeline
](#status-timeline-chart)
+ [
### Configure status widgets
](#configure-status-widgets)
### Status grid
**Example**
The following status grid shows the status of four asset properties.
![\[A sample status grid widget.\]](http://docs.aws.amazon.com/iot-sitewise/latest/appguide/images/dashboard-status-chart-console.png)
To display a status grid widget, choose the status grid icon from the visualization type menu.
![\[The status grid visualization type icon.\]](http://docs.aws.amazon.com/iot-sitewise/latest/appguide/images/dashboard-status-visualization-type-console.png)
### Status timeline
**Example**
The following status timeline shows the status over time for four asset properties.
![\[A sample status timeline widget.\]](http://docs.aws.amazon.com/iot-sitewise/latest/appguide/images/dashboard-status-timeline-chart-console.png)
To display a status timeline widget, choose the status timeline icon from the visualization type menu.
![\[The status timeline visualization type icon.\]](http://docs.aws.amazon.com/iot-sitewise/latest/appguide/images/dashboard-status-timeline-visualization-type-console.png)
### Configure status widgets
To set status colors, configure thresholds with the color and rule for each status. For more information, see [Configure thresholds](configure-thresholds.md).
![\[A sample status widget threshold configuration.\]](http://docs.aws.amazon.com/iot-sitewise/latest/appguide/images/dashboard-configure-status-thresholds-console.png)
You can also configure what information the widget displays about asset properties.
**To toggle property units and values**
1. Choose the **Configuration** icon for the status widget to change.
1. Select or clear the **Show labels** option. When this option is enabled, the widget displays the unit and value of each asset property.
1. After you finish editing the dashboard, choose **Save dashboard** to save your changes. The dashboard editor closes. If you try to close a dashboard that has unsaved changes, you're prompted to save them.
## KPI
The KPI visualization provides a compact representation when you need an overview of your asset properties. This overview gives you the most critical insights into the overall performance of your devices, equipment, or processes. You can change the title of each property within the visualization.
**Example**
The following is a key performance indicator (KPI) visualization that shows four asset properties.
![\[A sample KPI visualization.\]](http://docs.aws.amazon.com/iot-sitewise/latest/appguide/images/dashboard-kpi-chart-console.png)
The KPI visualization shows the following information:
+ The latest value for an asset property or the latest state of an alarm for the selected time range.
+ The trend for that value compared to a previous value, which is the first data point before the selected time range.
To display a KPI, choose the KPI icon from the visualization type menu.
![\[The KPI visualization type icon.\]](http://docs.aws.amazon.com/iot-sitewise/latest/appguide/images/dashboard-kpi-visualization-type-console.png)
## Table
The table widget provides a compact representation of multiple asset properties or alarms. You can use the overview to see detailed information about the performance of multiple devices, equipment, or processes.
You can display either properties or alarms in a table. You can't display properties and alarms in the same table.
**Example**
The following is a table widget that shows four asset properties.
![\[A sample table widget.\]](http://docs.aws.amazon.com/iot-sitewise/latest/appguide/images/dashboard-table-widget-console.png)
To display a table widget, choose the table icon from the visualization type menu.
![\[The table widget type icon.\]](http://docs.aws.amazon.com/iot-sitewise/latest/appguide/images/dashboard-table-visualization-type-console.png)
# Configure thresholds
As a project owner, you can configure thresholds for your visualizations to indicate when asset properties are outside their normal operating ranges. When you add a threshold, you define a rule and a color. If at least one of a property's data points crosses the threshold for a selected time range, the visualization displays that property's legend in the color that you choose. You can choose if the visualization also displays the property's data in the color that you choose. You can add multiple thresholds to each visualization, and choose colors to represent severities.
**Note**
If you add a property with an alarm to a visualization, the visualization automatically displays the alarm as a threshold.
The threshold in the following example indicates when a wind farm's total power output is less than **30,000** watts. The visualization displays the legend in green because the property value meets the threshold.
![\[A line graph visualization with a threshold.\]](http://docs.aws.amazon.com/iot-sitewise/latest/appguide/images/dashboard-threshold-line-graph-console.png)
When multiple thresholds apply to a data point, SiteWise Monitor uses the following rules to choose which threshold's color to display:
+ If the data point is positive or zero, the visualization displays the color of the threshold with the greatest value.
+ If the data point is negative, the visualization displays the color of the threshold with the most negative value.
+ If the data point meets multiple thresholds with the same value, the visualization displays the color of the last threshold that you added.
**Note**
SiteWise Monitor rounds data points in visualizations but uses the actual value to compare with thresholds. Consider an example where you have a data point with value **5.549**. This data point displays as **5.55**, but the data point won't meet a threshold that checks for data points greater than or equal to **5.55**.
## Add a threshold to a visualization
As a project owner, you can define thresholds for each visualization.
**Note**
You can add up to six thresholds to each visualization.
**To add a threshold to a visualization**
1. Choose the **Configuration** icon for the visualization to change.
![\[A visualization with the "Configuration" icon highlighted.\]](http://docs.aws.amazon.com/iot-sitewise/latest/appguide/images/dashboard-configure-visualization-settings-console.png)
1. If the visualization already has a threshold, choose **Add a threshold** to add a new threshold.
![\[The visualization configuration panel with "Add a threshold" highlighted.\]](http://docs.aws.amazon.com/iot-sitewise/latest/appguide/images/dashboard-add-threshold-console.png)
1. Choose one of the following comparison operators:
+ **<** – Highlight properties that have at least one data point less than the specified value.
+ **>** – Highlight properties that have at least one data point greater than the specified value.
+ **≤** – Highlight properties that have at least one data point less than or equal to the specified value.
+ **≥** – Highlight properties that have at least one data point greater than or equal to the specified value.
+ **=** – Highlight properties that have at least one data point equal to the specified value.
1. Enter a threshold value to compare data points with the specified operator.
1. Choose a threshold color. The visualization displays property legends in this color for properties with at least one data point that meets the threshold rule. When you enable **Color breached values**, the visualization also colors data that meets the threshold rule. You can use the color picker, enter a hexadecimal color code, or enter color component values.
1. (Optional) Toggle **Color breached values**. When you enable this option, the visualization displays the data in color when it meets the threshold.
1. After you finish editing the dashboard, choose **Save dashboard** to save your changes. The dashboard editor closes. If you try to close a dashboard that has unsaved changes, you're prompted to save them.
## Remove a threshold from a visualization
As a project owner, you can remove a threshold from a visualization if you no longer need it.
**To remove a threshold from a visualization**
1. Choose the **Configuration** icon for the visualization to change.
1. Choose the **X** icon for the threshold to remove.
![\[A visualization threshold with the remove icon highlighted.\]](http://docs.aws.amazon.com/iot-sitewise/latest/appguide/images/dashboard-remove-threshold-console.png)
1. After you finish editing the dashboard, choose **Save dashboard** to save your changes. The dashboard editor closes. If you try to close a dashboard that has unsaved changes, you're prompted to save them.
# Configure trend lines
As a project owner, you can configure trend lines to display statistical analyses on your data. When you add a trend line, you choose the type of analysis and the property to analyze. This lets you and your team identify trends in your data to better understand your operation.
The following visualization types support trend lines:
+ [Line](choose-visualization-types.md#line-charts)
+ [Scatter](choose-visualization-types.md#scatter-charts)
+ [Bar](choose-visualization-types.md#bar-charts)
The following is an example visualization with a linear trend line.
![\[A line graph visualization with a linear trend line.\]](http://docs.aws.amazon.com/iot-sitewise/latest/appguide/images/dashboard-trend-line-graph-console.png)
**Note**
The dashboard uses only data from the selected time range to compute trend lines. This means that trend lines only show trends for visible data.
## Add a trend line to a visualization
As a project owner, you can define trend lines for each visualization.
**Note**
You can add one of each type of trend line to each property in a visualization.
**To add a trend line to a visualization**
1. Choose the **Configuration** icon for the visualization to change.
![\[A visualization with the "Configuration" icon highlighted.\]](http://docs.aws.amazon.com/iot-sitewise/latest/appguide/images/dashboard-configure-visualization-settings-console.png)
1. Choose **Add a trend line**.
![\[The visualization configuration panel with "Add a trend line" highlighted.\]](http://docs.aws.amazon.com/iot-sitewise/latest/appguide/images/dashboard-add-trend-console.png)
1. Choose the type of trend line to display from the following option:
+ **Linear** – A linear regression line. SiteWise Monitor uses the [least squares](https://en.wikipedia.org/wiki/Least_squares) method to calculate the linear regression.
1. Choose the property for which the trend line displays.
The trend line displays in the same color as the property data.
1. After you finish editing the dashboard, choose **Save dashboard** to save your changes. The dashboard editor closes. If you try to close a dashboard that has unsaved changes, you're prompted to save them.
## Remove a trend line from a visualization
As a project owner, you can remove a trend line from a visualization if you no longer need it.
**To remove a trend line from a visualization**
1. Choose the **Configuration** icon for the visualization to change.
1. Choose the **X** icon for the trend line to remove.
![\[A visualization trend line with the remove icon highlighted.\]](http://docs.aws.amazon.com/iot-sitewise/latest/appguide/images/dashboard-remove-trend-console.png)
1. After you finish editing the dashboard, choose **Save dashboard** to save your changes. The dashboard editor closes. If you try to close a dashboard that has unsaved changes, you're prompted to save them.