A dashboard is where you place your widgets to visualize and interact with data, all in real-time. All your dashboards are listed on the sidebar of the screen. On the top right you will find the Edit Dashboard menu. From there you will have access to other dashboard functionalities such as rename, share and delete.
You can organize them in the way that best fit your needs by moving and resizing your widgets.
To create a new dashboard, just click on the button Dashboards, then + on the top right, give a name to your new dashboard and click on Save.
To rename a dashboard, just got to the dashboards section and select the dashboard, then click the gear button on the top right (Edit dashboard), then you have Dashboard Name, just edit it and click save.
Given that most widgets handle some type of data, they need a data source as input. The data source of your widgets are the variables created when you send data from your device or the analysis to Tago. Therefore, you will need to select which variable, and from which device and bucket, you want to add in the widget.
You’ll notice that many widgets use your variable’s name in order to identify, for example, a line of a chart or a device in a map. And we know that sometimes the original name of the variable is not the most appropriate name for the end user to see. Because of that, every variable selected may have a label.
A label is simply an alias used by the widget whenever it needs to display your variable name.
To add an alias to a variable you need to select the variable to use in a widget, then on the section Parameter Configuration tab, you will find Label for variable, type the alias you want and click Save. This alias will not be recorded in the database, neither associate with that variable for future use.
You can also change the bucket and the device for this variable. We understand that sometimes the user needs to change it or a new device would be responsible for sending an specific data. Whatever the reason, you’re covered. You can change your variable settings if you need.
Besides the data sources, every kind of widget has its own particular configurations in regards to how to display the data. So when creating a widget, you’re going to find basic options - generally these are critical to the algorithm that builds your widget - and advanced options, which allows you to give a personal touch to each widget and also provides advanced features you might need. Two advanced features included in every widget are:
- Help text
- Hide variables name
The help text allows you to add a short help text that will be placed on the top-right corner of your widget, under a question mark icon.
The second one gives you the ability to hide the variables name in the widget. It can be useful if you don’t want to show the widget names in some of your widgets. We recommend you to add a descriptive title in such cases though.
You will notice that some widgets are more powerful and complex than others. While a dial only needs the minimum and maximum values, a multiple axis chart needs more configuration fields that are related to each variable, in this particular case you’ll have to define the type (bar, line, etc) of each data source as well. This kind of customization offers you a lot of flexibility.
When creating your widgets, you are going to see that some of them present only the latest value added by your variable and keep it updated through the real time updates. Others can exhibit data in a range of time while keeping it updated through real time updates, and some widgets just show the data in a fixed period of time. When more than one of the previous options are available in a widget, its up to you to choose the best one that fits your needs. These options may be like the following:
- Fixed time
- By variable
And don’t worry by time zone differences, because you can choose the time zone that the devices are related to.