I have for some time shared my Unraid System dashboard over at Grafana.com but never really had the time to make a quick write up on how to set it all up. So this will try to do just that. This guide will make it so you will be able to monitor cpu usage, cpu temps, network stats, ram usage and much more by simply importing a dashboard.

How it works

In getting all this setup, there are 3 main moving parts. Telegraf, InfluxDB and Grafana.
Telegraf is what collects all the different system metrics and outputs it to an InfluxDB database that Grafana uses to visualize everything with pretty graphs and bars. 
This is a pretty simplified explanation and you can read more here: Telegraf, InfluxDB, Grafana

Installing Influxdb

Search for influxdb in Community Apps and install it using the default template. Select your appdata path and host ports if the default ones are taken.
There is no other setup than just installing the container.

Installing Telegraf

Do the same here, just search for the container in Community Apps and use the default template settings. Set the appdata location to where you want it, but dont click install just yet!

Warning

This container wont start unless the telegraf.conf file already exists on the host. (Host path 7)
Do not install the container before you follow the steps below!

Troubleshooting

If you happened to start the container without doing the steps below first you will need to delete the folder it created instead of mounting the file. Go to the location you selected for the appdata and delete the telegraf.conf folder. Next follow the steps below.
  1. Download the file and place it in the location you want the telegraf appdata to be.
    e.g. /mnt/cache/appdata/telegraf/telegraf.conf
    The default config file can be downloaded here: https://github.com/influxdata/telegraf/blob/master/etc/telegraf.conf
  2. Next you need to edit the telegraf.conf file. Go to the location you saved the file and scroll down to OUTPUT PLUGINS which should be around line 90-103.Uncomment (Remove #)  the http url line for InfluxDB like so:
    # urls = ["unix:///var/run/influxdb.sock"]
    # urls = ["udp://127.0.0.1:8089"]
    urls = ["http://192.168.1.34:8086"]

    192.168.1.34 is the IP address to my Unraid server and 8086 is the default InfluxDB port that runs the InfluxDB HTTP service.

  3. Next we need to setup the input plugins. A lot of these are already enabled but we need to add a couple so that all the panels on the Grafana dashboard will work.
  4. Uncomment the following plugins and lines:
    1. HDD temps/stats:  [[inputs.smart]]
    2. CPU temps:  [[inputs.sensors]] and  attributes = true(This is default set to false)
    3. Network:  [[inputs.net]] and  interfaces = ["eth0"] ect
    4. Netstat: [[inputs.netstat]]
    5. Docker: [[inputs.docker]] and endpoint = "unix:///var/run/docker.sock"
  5. Now go back to the install page of telegraf and add the following into the Post Arguments input field: /bin/sh -c 'apk update && apk upgrade && apk add smartmontools && telegraf
    To be able to see this field we need to click on the Advanced View button.
    This will install smartmontools and without it you won’t be able to get the S.M.A.R.T statistics.
    Note: If you also want to add IPMI stats you can add the following: /bin/sh -c 'apk update && apk upgrade && apk add ipmitool && apk add smartmontools && telegraf'

After editing the telegraf.conf and adding the post arguments you can start the Telegraf container. Telegraf will automatically create a database called telegraf when started for the first time with the influxdb plugin activated.

Installing Grafana

Installing Grafana is also quite simple. Chose your host port for the webUI and add your unraid URL and admin password to the container settings.

Configuring Grafana

After the installation is finished go to the WebUI. (http://unraidIP:3000) and log in with username admin and the password you chose. You should then see this on you screen:

Click on Add data source and select InfluxDB. 

Next give the data source a name(I named it Telegraf), add the URL to InfluxDB, enter the database to use (telegraf) and set the HTTP Method to POST. This is helpful on some of the more heavy queries.
Next click Save & Test


If all your settings are correct you should see this message.

Next import the dashboard by hovering over the + icon and selecting Import

Paste the dashboard ID 7233 and click Load
Give it a name and UID, select the database in the drop down and click Import.

Next, select the correct values on the menu at the top.

Some assembly needed

You should now already see most of the panels working and displaying stats. But there will be some panels where you need to select some values in the dropdowns at  the top. Like Cache Devices.
On the Cache Devices (diskio) dropdown you can select multiple devices, and it will add them to the Cache Read/Write panel.


The Interval text box is the interval that is set in telegraf.conf
The default value is 10 seconds, but is you changed this you can update it here.

To update the drive names on the  Storage Consumption panel, edit the panel and go to the Field menu. There you will can add the different Value Mappings for the different drive paths. See the video below.

And that’s about it! This should get you going on adding or creating awesome dashboards for you Unraid system. There are tons of different dashboards on grafana.com to get inspiration from. My dashboard is far from the best one out there, so please share your awesome dashboards in the comment section or on Discord!

And if you’re wondering why my Grafana page looks different from the stock theme you can take a look here: https://github.com/gilbN/theme.park

Optional: Adding UPS stats

On the top of my dashboard I have UPS stats, now if you don’t have a UPS (You should by the way) you can just delete those panel. But if you have a UPS that’s compatible with Unraid you can check out this awesome guide:

If you need any extra help join the Discord server!