![\"Monitoring](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2022\/09\/RPi-Monitoring-InfluxDB-Telegraf.jpg?resize=1200%2C675&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nPrerequisites<\/h2>\n\n\n\n
Before proceeding you must have InfluxDB installed on your Raspberry Pi. Follow the next tutorial:<\/p>\n\n\n\n
- \n
- Install InfluxDB 2 on Raspberry Pi<\/a><\/li>\n<\/ul>\n\n\n\n
Raspberry Pi Monitoring Template<\/h1>\n\n\n\n
There is an InfluxDB template that can be used to monitor your Raspberry Pi Linux system. An InfluxDB template is a prepackaged set of InfluxDB configurations that contain everything from dashboards and Telegraf configurations to notifications and alerts.<\/p>\n\n\n\n
Templates reduce the setup time by giving you resources that are already configured for your use case. In this case, you\u2019ll get a set of configurations that are ready to use to monitor your Raspberry Pi. To learn more about InfluxDB templates, you can check the following link:<\/p>\n\n\n\n
- \n
- InfluxDB Templates<\/a><\/li>\n<\/ul>\n\n\n\n
We\u2019ll use the Raspberry Pi Monitoring template<\/a> that includes the following:<\/p>\n\n\n\n
- \n
- one bucket: rasp-pi<\/span> (7d retention)<\/li>\n\n\n\n
- labels: raspberry-pi<\/span> + Telegraf plugin labels\n
- \n
- Diskio input plugin<\/li>\n\n\n\n
- Mem input plugin<\/li>\n\n\n\n
- Net input plugin<\/li>\n\n\n\n
- Processes input plugin<\/li>\n\n\n\n
- Swap input plugin<\/li>\n\n\n\n
- System input plugin<\/li>\n<\/ul>\n<\/li>\n\n\n\n
- one Telegraf configuration<\/li>\n\n\n\n
- one dashboard: Raspberry Pi System<\/li>\n\n\n\n
- two variables: bucket and linux_host<\/li>\n<\/ul>\n\n\n\n
Follow the next instructions to install the Raspberry Pi Monitoring template.<\/p>\n\n\n\n
Getting an InfluxDB Token<\/h1>\n\n\n\n
You need to get an InfluxDB token to be able to install the Raspberry Pi Monitoring template using Influx CLI (command line interface).<\/p>\n\n\n\n
Go to your InfluxDB Interface:<\/p>\n\n\n\n
http:\/\/Your_RPi_IP_address<\/strong>:8086<\/pre>\n\n\n\n
Once you\u2019re on InfluxDB, on the left sidebar click on Data\/Load Data<\/strong> and then, select the API Tokens<\/strong> tab. Click on the + Generate API Token<\/strong> to generate a new API Token. We\u2019ll generate an All Access API Token<\/strong>.<\/p>\n\n\n
\n![\"InfluxDB](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2022\/04\/Influx-DB-Generate-API-Token-All-Access-8.png?resize=750%2C362&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nGive a description to the API Token (for example Raspberry-Pi<\/span>).<\/p>\n\n\n
\n![\"Raspberry](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2022\/09\/Generate-API-Token-InfluxDB-Rpi.png?resize=491%2C294&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nAfter that, copy the API token to a safe place. You won\u2019t be able to see it again.<\/p>\n\n\n
\n![\"\"](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2023\/03\/Create-API-Token-Influxd.png?resize=748%2C270&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nThe new API Token should be on the list of API tokens.<\/p>\n\n\n\n
![\"\"](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2023\/03\/influxdb-Rpi-Token.png?resize=974%2C536&quality=100&strip=all&ssl=1\")
<\/figure>\n\n\n\nInstalling Influx CLI<\/h1>\n\n\n\n
Influx CLI is InfluxDB c<\/strong>ommand l<\/strong>ine i<\/strong>nterface that contains commands to manage many aspects of InfluxDB, including buckets, organizations, users, tasks, etc. It should be automatically installed when you install InfluxDB.<\/p>\n\n\n\n
Provide required authentication credentials<\/h3>\n\n\n\n
To avoid having to pass your InfluxDB host, API token, and organization with each command, you can store them in an influx CLI configuration (config). For that, you need to use the influx config create<\/span> command and pass your information.<\/p>\n\n\n\n
First, edit the following command with your information:<\/p>\n\n\n\n
influx config create --config-name influx-config \\
--host-url http:\/\/YOUR_RASPBERRY_PI_IP_ADDRESS<\/strong>:8086 \\
--org <your-org<\/strong>> \\
--token <your-auth-token<\/strong>> \\
--active<\/pre>\n\n\n\n- \n
- Replace YOUR_RASPBERRY_PI_IP_ADDRESS<\/span> with your Pi\u2019s IP address.<\/li>\n\n\n\n
- Replace <your-org><\/span> with your InfluxDB organization name<\/li>\n\n\n\n
- Replace the <your-auth-token><\/span> with the API token you got in the previous step.<\/li>\n<\/ul>\n\n\n\n
For example, in my case, the command looks as follows:<\/p>\n\n\n\n
influx config create --config-name influx-config \\\n --host-url http:\/\/192.168.1.106:8086 \\\n --org RNT \\\n --token v_od_mG--9_srf_OnaaODihPDX34suToP7XEH47v6x77CMxakZaoYHzF7Ec9mLT-CuXXXXXXXXXXXXXXXXXvQCSSw== \\\n --active<\/pre>\n\n\n\n
Applying the Raspberry Pi Template<\/h2>\n\n\n\n
Now, run the following command to apply the Raspberry Pi template.<\/p>\n\n\n\n
influx apply -u https:\/\/raw.githubusercontent.com\/influxdata\/community-templates\/master\/raspberry-pi\/raspberry-pi-system.yml<\/pre>\n\n\n\n
Installing Telegraf<\/h1>\n\n\n\n
Run the following commands sequentially to install Telegraf:<\/p>\n\n\n\n
wget -q https:\/\/repos.influxdata.com\/influxdata-archive_compat.key<\/pre>\n\n\n\n
echo '393e8779c89ac8d958f81f942f9ad7fb82a25e133faddaf92e15b16e6ac9ce4c influxdata-archive_compat.key' | sha256sum -c && cat influxdata-archive_compat.key | gpg --dearmor | sudo tee \/etc\/apt\/trusted.gpg.d\/influxdata-archive_compat.gpg > \/dev\/null<\/pre>\n\n\n\n
echo 'deb [signed-by=\/etc\/apt\/trusted.gpg.d\/influxdata-archive_compat.gpg] https:\/\/repos.influxdata.com\/debian stable main' | sudo tee \/etc\/apt\/sources.list.d\/influxdata.list<\/pre>\n\n\n\n
sudo apt-get update && sudo apt-get install telegraf<\/pre>\n\n\n\n
\n\n\n\nThe instructions are not working?<\/strong><\/p>\n\n\n\n
If the instructions are not working it might be due to an update on the installation procedure. If that\u2019s the case, we recommend that you go to the next link and follow the official instructions:<\/p>\n\n\n\n
- \n
- https:\/\/portal.influxdata.com\/downloads\/<\/a><\/li>\n<\/ul>\n\n\n\n
Scroll down to the Telegraf section. Select the platform Ubuntu & Debian<\/strong>. Then, copy the commands provided.<\/p>\n\n\n
\n![\"\"](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2023\/03\/telegraf-instructions.png?resize=751%2C475&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\n
\n\n\n\nNow, you need to add the following environment variables to your Telegraf environment:<\/p>\n\n\n\n
- \n
- INFLUX_HOST<\/span>: InfluxDB URL http:\/\/YOUR_RASPBERRY_PI_IP_ADDRESS:8086<\/li>\n\n\n\n
- INFLUX_TOKEN<\/span>: Your InfluxDB Cloud API token<\/li>\n\n\n\n
- INFLUX_ORG<\/span>: Your InfluxDB Cloud organization name.<\/li>\n<\/ul>\n\n\n\n
For that, edit the following command with your own details:<\/p>\n\n\n\n
export INFLUX_HOST=http:\/\/YOUR_RASPBERRY_PI_IP_ADDRESS<\/strong>:8086
export INFLUX_TOKEN=YOUR_API_TOKEN<\/strong>
export INFLUX_ORG=YOUR_ORG_NAME<\/strong><\/pre>\n\n\n\nFor example, in my case, the command looks as follows:<\/p>\n\n\n\n
export INFLUX_HOST=http:\/\/192.168.1.106:8086\nexport INFLUX_TOKEN=v_od_mG--9_srf_OnaaODihPDX34suToXXXXXXXXXXP7XEH47v6x\nexport INFLUX_ORG=RNT<\/pre>\n\n\n\n
Then, run it on your Raspberry Pi.<\/p>\n\n\n\n
Starting Telegraf<\/h1>\n\n\n\n
Start Telegraf as a service. For the exact command, you need to go to your InfluxDB interface, and then Data\/Load Data<\/strong> > Telegraf<\/strong>. Click on the rpi Setup Instructions<\/strong>. Copy the command to start Telegraf.<\/p>\n\n\n
\n![\"Telegraf](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2022\/09\/telegraf-setup-instructions.png?resize=696%2C620&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nRun that command to start Telegraf. You should get something similar to the next image in your Terminal window.<\/p>\n\n\n
\n![\"Run](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2022\/09\/run-telegraf.png?resize=750%2C203&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nAt the moment, Telegraf should be collecting data from the Raspberry Pi and sending it to the corresponding bucket on InfluxDB.<\/p>\n\n\n\n
Raspberry Pi System Dashboard<\/h1>\n\n\n\n
Now you can monitor your Raspberry Pi system on a Dashboard in InfluxDB. In your InfluxDB user interface, go to Boards\/Dashboards <\/strong>(left sidebar) and click on the Raspberry Pi System<\/strong> \u201cA collection of useful visualizations for monitoring your system stats<\/em>\u201d.<\/p>\n\n\n
\n![\"Raspberry](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2022\/09\/raspberry-pi-monitoring.png?resize=750%2C530&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nYou\u2019ll get access to the Raspberry Pi System Dashboard. You can check useful information like the CPU and GPU temperatures, total memory, memory usage, and much more.<\/p>\n\n\n\n
If you don\u2019t see any data on the dashboard, make sure you select the right bucket rasp-pi<\/span> and the linux_host is raspberrypi<\/span>.<\/p>\n\n\n\n
Congratulations! You set up an InfluxDB Telegraf to monitor your Raspberry Pi system.<\/p>\n\n\n\n
Wrapping Up<\/h2>\n\n\n\n
In this quick guide, we’ve shown you how to use InfluxDB Telegraf to collect useful data from your Raspberry Pi and display it on a dashboard. You can monitor CPU usage, memory usage, disk usage, system load, CPU and GPU temperatures, and other useful data.<\/p>\n\n\n\n
We hope you find this tutorial useful. We have other InfluxDB tutorials you may like:<\/p>\n\n\n\n
- \n
- ESP32: Getting Started with InfluxDB<\/a><\/li>\n\n\n\n
- ESP8266 NodeMCU: Getting Started with InfluxDB<\/a><\/li>\n\n\n\n
- ESP32\/ESP8266: Send BME280 Sensor Readings to InfluxDB<\/a><\/li>\n<\/ul>\n\n\n\n
Do you like Home Automation? Check our most complete eBook about this subject: <\/p>\n\n\n\n
- ESP8266 NodeMCU: Getting Started with InfluxDB<\/a><\/li>\n\n\n\n
- INFLUX_TOKEN<\/span>: Your InfluxDB Cloud API token<\/li>\n\n\n\n
- INFLUX_HOST<\/span>: InfluxDB URL http:\/\/YOUR_RASPBERRY_PI_IP_ADDRESS:8086<\/li>\n\n\n\n
- Replace <your-org><\/span> with your InfluxDB organization name<\/li>\n\n\n\n
- Replace YOUR_RASPBERRY_PI_IP_ADDRESS<\/span> with your Pi\u2019s IP address.<\/li>\n\n\n\n
- labels: raspberry-pi<\/span> + Telegraf plugin labels\n
- one bucket: rasp-pi<\/span> (7d retention)<\/li>\n\n\n\n
- InfluxDB Templates<\/a><\/li>\n<\/ul>\n\n\n\n