Configurable dashboards allow you to select a variety of widgets and arrange them into custom layouts. Widgets allow you to view data about specific sensors, sites, or features, or to see aggregate data about your solution as a whole. To get started, navigate to a dashboard page and select a layout from the layout dropdown. Layouts represent workspaces where you can start adding widgets. There are several preconfigured layouts that let you get up and running quickly as well as a blank layout that allows you to fully customize your experience. After you've added a layout, you can add, remove, and reconfigure each widget on the layout.
Much of what you do on a dashboard is saved automatically, but some actions are not. In that case, a count of active changes is kept over the save button, and you will be prompted to save before leaving a layout.
A Closer Look
A dashboard is simply a collection of layouts. The dashboard is always available on the page, but it may be empty. In which case you will see a message prompting you to add a layout to begin.
A layout appears as a discreet tab or sub-page on the dashboard, and you can switch back and forth between layouts to view different collections of widgets. There are several types of layouts available that have different capabilities, and more are in development.
1. List Layouts: list layouts are populated automatically with a series of widgets all of the same type and allow filtering and sorting those widgets. Preconfigured list layouts are available per widget type as well as per site. In the case of the site overview layout, you can choose to see a particular type of widget for every sensor on a site.
2. Draggable Layouts: draggable layouts, may or may not be pre-populated but always allow you to add or remove widgets of whatever type you like as well as to drag them into different arrangements. Because widgets are not all of the same type and may have been intentionally moved to a particular place, filtering and sorting are not enabled.
Top level settings are available in the settings bar at the top of the page, and more are available in the layout settings dropdown. You can toggle whether layouts automatically refresh their widget data and rename, filter, sort, add widgets, or change how many columns all the widgets on the layout take up.
Some layouts also have a configurable threshold which controls the trend of that widget. If the threshold is set to 10%, for instance, and the widget data has trended down by more than 10% over the relevant time period (where a downward trend represents degrading service, like for bandwidth), the trend arrow will be red. If it's trended down less than 10%, the arrow will be orange, and if it has trended up, the arrow will be green.
Widgets represent a discreet data view. Some widgets show trends or charts for a particular sensor, others show overviews of sites, and some aggregate data from third-party APIs. A widget typically allows you to change its title, change which sensor, site, or tenant it points to (depending on the widget and your particular set of services), or remove it from a layout.
We are frequently developing new widgets, but you can read a brief overview of some of the current ones below:
1. Sensor Trends, Errors, Alarms, Availability: All of these widgets show you data about a single sensor. They are added automatically to list layouts of the respective type. These widgets can be renamed, pointed to a different sensor, or removed from the layout. They also include a list of relevant links to allow you to get a more details picture of the state of that sensor.
2. O365 Service Health, and Messages: These widgets show you data from Microsofts O365 API. You can view the availability of services, a list of messages published by Microsoft and follow the link to view the same data on Microsoft's Admin Center page.
3. Site and Solution Overviews: These widgets show you how many sites and sensors are in either alarm or error states.
4. Site Map: This widget shows you your sites laid out on a world map. The widget will try to find the location of your site based on the gateway IP address, but the best way to ensure the accurate display of sites is to pin a location to the site when it's configured.
5. Site Grid: This widget shows each type of sensor you have configured and each site you have set up. A cell is displayed at every intersection based on the state of the site. If you have set up a series of sensors for one site, but have not yet created corresponding sensors for another site, the appropriate cell will display a gap in data with a link to add a sensor there.
Note: Where data is color coded, red, orange, and green represent error, alarm, and operational states respectively. State is displayed on a priority basis with error states superseding alarm states and alarm states superseding operational states, so, for instance, if a site has a sensor in error state, that site will be in error state regardless of the state of other sensors. If it has one in alarm state, the site will be in alarm. The site will show operational only if all sensors are operational at that site.