Grafana: Difference between revisions
"migration of handbook pages from https://git.kanthaus.online/kanthaus/handbook" |
Post-migration cleanup |
||
Line 1: | Line 1: | ||
<nowiki>:</nowiki>bar_chart: We use a [https://grafana.com/ Grafana] instance to monitor various things in the house, which can be accessed at https://grafana.yunity.org/. | |||
We use a [https://grafana.com/ Grafana] instance to monitor various things in the house, which can be accessed at https://grafana.yunity.org/. | |||
== Getting access == | == Getting access == | ||
The Grafana board can be viewed by anyone. To modify it you need a [[ | The Grafana board can be viewed by anyone. To modify it you need a [[Nextcloud]] account and need to be part of the Kanthaus group. | ||
== Logging new quantities in Grafana == | == Logging new quantities in Grafana == |
Revision as of 12:19, 16 October 2024
:bar_chart: We use a Grafana instance to monitor various things in the house, which can be accessed at https://grafana.yunity.org/.
Getting access
The Grafana board can be viewed by anyone. To modify it you need a Nextcloud account and need to be part of the Kanthaus group.
Logging new quantities in Grafana
To track new metrics in Grafana you will need to store them in the underlying InfluxDB database, hosted at https://influxdb.kanthaus.online/. If you are writing from an IOT device running inside Kanthaus, running from the 192.168.5.*
subnet, then you cannot directly reach the internet: instead, you can point your device to http://kanthaus-server:88/influxdb
which will proxy your requests to the outside.
You will need to supply credentials to be able to access InfluxDB: you can find those in our central password store. The InfluxDB database to use is kanthaus
.
You can use InfluxDB’s API to regularly write new values to the database. For instance, with curl
this could look like this:
curl --request POST \ "http://kanthaus-server:88/influxdb/api/v2/write?bucket=kanthaus/" \ --header "Authorization: Basic YOUR_API_CREDENTIALS" \ --header "Content-Type: text/plain; charset=utf-8" \ --data-binary ' airSensors,sensor_id=TLM0201 temperature=73.97038159354763,humidity=35.23103248356096,co=0.48445310567793615 1630424257000000000 airSensors,sensor_id=TLM0202 temperature=75.30007505999716,humidity=35.651929918691714,co=0.5141876544505826 1630424257000000000 '
See InfluxDB’s documentation about the line protocol for details about the format of the data to post.
Once your quantity is logged in InfluxDB, you can create a new panel for it in Grafana. This can be done from Grafana’s web interface directly.