Grafana
Grafana is the optional dashboard service for power users who want free-form charts over the logged history.
- API token. On the Services page, click Configure on the Grafana row. In the Grafana API Token dialog, paste a token (create a service-account token in Grafana under Administration → Service accounts) and save. The token is stored securely and cannot be displayed again after saving: the field is empty when you reopen the dialog. The admin panel uses it to read and write dashboards for you.
- Per-object panel builder. In Devices, the chart icon (Grafana panel) of an object opens the Grafana Panel dialog. The icon is shown only on objects that have Log historical values on. You build a panel without writing a query: pick the Panel type (Gauge, Stat, Time series, Bar chart, Table or Last value), then the fields that type offers among Aggregation function, Aggregation period, Range from and Range to. Then either Add panel to an existing (or new) dashboard on the Dashboard tab, or copy the result from the Panel JSON or Query only tab and paste it into Grafana yourself (see “The Devices Workspace”). Nothing is created in Grafana before you click Add panel.
- A dashboard in the app. To open a dashboard from the app, add a device of Type Webview and paste the dashboard's address into its URL object. Check from the resident's own session that the address loads.
- Opening Grafana. When the service is enabled, Grafana appears in the Apps group of the sidebar and opens in a new tab.