.gif)
The “Starter Kit” for Grafana dashboards requires the installation of Grafana, Telegraf, and InfluxDB (aka TIG). Telegraf sends metrics to the InfluxDB time series database and Grafana displays the InfluxDB (and other) data as beautiful graphs.
When I started my journey, I was looking for software that would run in a Raspberry Pi OS VM on top of ESXi-ARM on a Raspberry Pi 4. All the feeds to InfluxDB became a bit much for the rPi4 I/O bus and the VM would often lock up, so I moved on to a Ubuntu VM on an Intel NUC. If you would like to try this rPi OS VM installation option, there is a great tutorial here.
Since my rPi OS VM kept getting overwhelmed with data feeds, I decided to reinstall everything in a Ubuntu VM on ESXi on an Intel NUC. The NUC VM has been much more reliable. In Jorge de la Cruz’s blog post on Grafana & VMware, there is a link for the installation of the TICK Stack (Telegraf, InfluxDB, Chronograf, Kapacitor) and also a link on how to add Grafana to TICK. As you can see in the Parts List, not all pieces of the TICK stack are needed, but the tutorial is very helpful in installing the parts you want. Here is a brief summary of the installation step from those posts for the parts I am using:
I ended up using the instrustions from this web site.
$ sudo apt-get install -y apt-transport-https
$ sudo apt-get install -y software-properties-common wget
$ wget -q -O - https://packages.grafana.com/gpg.key | sudo apt-key add -
$ echo "deb https://packages.grafana.com/oss/deb stable main" | sudo tee -a /etc/apt/sources.list.d/grafana.list
$ sudo apt-get update
$ sudo apt-get install grafana
$ sudo systemctl daemon-reload
$ sudo systemctl start grafana-server
$ sudo systemctl status grafana-server
$ sudo systemctl enable grafana-server.service
$ curl -sL https://repos.influxdata.com/influxdb.key | sudo apt-key add -
$ source /etc/lsb-release
$ echo "deb https://repos.influxdata.com/${DISTRIB_ID,,} ${DISTRIB_CODENAME} stable"
| sudo tee /etc/apt/sources.list.d/influxdb.list
$ sudo apt-get update
$ sudo apt-get install influxdb
$ sudo systemctl start influxdb
$ sudo systemctl status influxdb (Check and fix any issues)
$ sudo systemctl enable influxdb
$ influx (If not found "sudo apt install influxdb-client")
> CREATE USER "sammy" WITH PASSWORD 'sammy_admin' WITH ALL PRIVILEGES
> show users (Check that the sammy user is there)
> exit
$ sudo vi /etc/influxdb/influxdb.conf (Or nano. Or vim. Your preference)
Find the [http] section and set auth-enabled to true.
Save the file and exit the editor.
...
[http]
# Determines whether HTTP endpoint is enabled.
# enabled = true
# The bind address used by the HTTP service.
# bind-address = ":8086"
# Determines whether HTTP authentication is enabled.
auth-enabled = true
...
$ sudo systemctl restart influxdb
$ sudo apt-get install telegraf
$ sudo vi /etc/telegraf/telegraf.conf (Or nano. Or vim. Your preference)
Find the [outputs.influxdb] section and provide the username and password.
Save the file and exit the editor.
[[outputs.influxdb]]
## The full HTTP or UDP endpoint URL for your InfluxDB instance.
## Multiple urls can be specified as part of the same cluster,
## this means that only ONE of the urls will be written to each interval.
# urls = ["udp://localhost:8089"] # UDP endpoint example
urls = ["http://localhost:8086"] # required
## The target database for metrics (telegraf will create it if not exists).
database = "telegraf" # required
...
## Write timeout (for the InfluxDB client), formatted as a string.
## If not provided, will default to 5s. 0s means no timeout (not recommended).
timeout = "5s"
username = "sammy"
password = "sammy_admin"
$ sudo systemctl restart telegraf
$ sudo systemctl status telegraf (Check and fix any issues)
$ sudo systemctl enable telegraf
Congratulations. Telegraf is now running and sending metrics from your Linux host to the InfluxDB for use by Grafana. Your /etc/telegraf/telegraf.conf should, by default, have these sections uncommented and these metrics should be in InfluxDB.
[[inputs.cpu]]
[[inputs.disk]]
[[inputs.diskio]]
[[inputs.kernel]]
[[inputs.mem]]
[[inputs.processes]]
[[inputs.swap]]
[[inputs.system]]
You can test this by displaying the data in the Influx data base with these commands:
$ influx -username sammy -password sammy_admin
> use telegraf
> show measurements
name: measurements
name
----
cpu
disk
diskio
kernel
mem
swap
system
> show field keys from cpu
name: cpu
fieldKey fieldType
-------- ---------
usage_guest float
usage_guest_nice float
usage_idle float
usage_iowait float
usage_irq float
usage_nice float
usage_softirq float
usage_steal float
usage_system float
usage_user float
> select "usage_idle", "host" from "cpu" limit 10
name: cpu
time usage_idle host
---- ---------- ----
1609336970000000000 98.43434343434373 ubuntu-nuc
1609336970000000000 97.57330637007071 ubuntu-nuc
1609336970000000000 99.29364278506394 ubuntu-nuc
1609336980000000000 98.20089955022426 ubuntu-nuc
1609336980000000000 97.80000000000194 ubuntu-nuc
1609336980000000000 98.50149850149987 ubuntu-nuc
1609336990000000000 99.45054945055108 ubuntu-nuc
1609336990000000000 99.5004995004977 ubuntu-nuc
1609336990000000000 99.50049950049996 ubuntu-nuc
1609337000000000000 99.5995995995977 ubuntu-nuc
Point your browser to your new Grafana instance:
http://[hostname]:3000
Default login is admim/admin and you will be prompted to change your password
Define the InfluxDB as a data source
Name the source InfluxDB and change the IP address to the IP or name of your InfluxDB server
Provide the database name (telegraf), username (sammy) and password (sammy_admin) you created, Save & Test
There are lots of very nice pre-built dashboards at this site. Once you find one, you can import the dashboard right into your Grafana instance using the dashboard ID. I suggest trying this Linux dashboard with ID 2381 that works with metrics you have already collected.
First, choose Dashboards > Manage
Click “Import” and type the dashboard ID (2381) that you would like to import. Then click Load.
Choose InfluxDB as the data source for the dashboard and click “Import”
You will now have this dashboard and can choose which Linux host whose metrics to use
Thank you for taking the time to read this post. Part II will cover how to add VMware metrics and VMware dashboards. Feel free to contact me with any questions or improvements.