From a31cab997cf646a0995a9e35cd83f3f01f57467c Mon Sep 17 00:00:00 2001 From: mluu12 <87089043+mluu12@users.noreply.github.com> Date: Fri, 23 Jul 2021 10:22:20 -0700 Subject: [PATCH] Add monitor Raspberry-Pi template (#2859) * added a doc monitoring raspberry pi * minor edit * updated dashboard instructions * Update content/influxdb/cloud/monitor-alert/templates/infrastructure/raspberry-pi.md Co-authored-by: Scott Anderson * Update content/influxdb/cloud/monitor-alert/templates/infrastructure/raspberry-pi.md Co-authored-by: Scott Anderson * Fixed typos on raspberry branch. * Update content/influxdb/cloud/monitor-alert/templates/infrastructure/raspberry-pi.md Co-authored-by: Scott Anderson Co-authored-by: Kelly Co-authored-by: Scott Anderson --- .../templates/infrastructure/raspberry-pi.md | 56 +++++++++++++++++++ 1 file changed, 56 insertions(+) create mode 100644 content/influxdb/cloud/monitor-alert/templates/infrastructure/raspberry-pi.md diff --git a/content/influxdb/cloud/monitor-alert/templates/infrastructure/raspberry-pi.md b/content/influxdb/cloud/monitor-alert/templates/infrastructure/raspberry-pi.md new file mode 100644 index 000000000..58b57f6ca --- /dev/null +++ b/content/influxdb/cloud/monitor-alert/templates/infrastructure/raspberry-pi.md @@ -0,0 +1,56 @@ +--- +title: Monitor Raspberry Pi +description: > + Use the Raspberry Pi system template to monitor your Raspberry Pi 4 or 400 Linux system. +menu: + influxdb_cloud: + parent: Monitor infrastructure + name: Raspberry Pi +weight: 201 +--- + +Use the [Raspberry Pi Monitoring template](https://github.com/influxdata/community-templates/tree/master/raspberry-pi) to monitor your Raspberry Pi 4 or 400 Linux system. + +The Raspberry Pi template includes the following: + +- one [bucket](/influxdb/cloud/reference/glossary/#bucket): `rasp-pi` (7d retention) +- labels: `raspberry-pi` + Telegraf plugin labels + - [Diskio input plugin](/{{< latest "telegraf" >}}/plugins//#diskio) + - [Mem input plugin](/{{< latest "telegraf" >}}/plugins//#mem) + - [Net input plugin](/{{< latest "telegraf" >}}/plugins//#net) + - [Processes input plugin](/{{< latest "telegraf" >}}/plugins//#processes) + - [Swap input plugin](/{{< latest "telegraf" >}}/plugins//#swap) + - [System input plugin](/{{< latest "telegraf" >}}/plugins//#system) +- one [Telegraf configuration](/influxdb/cloud/telegraf-configs/) +- one [dashboard](/influxdb/cloud/reference/glossary/#dashboard): Raspberry Pi System +- two variables: `bucket` and `linux_host` + +## Apply the template + +1. Use the [`influx` CLI](/influxdb/cloud/reference/cli/influx/) to run the following command: + + ```sh + influx apply -f https://raw.githubusercontent.com/influxdata/community-templates/master/raspberry-pi/raspberry-pi-system.yml + ``` + For more information, see [influx apply](/influxdb/cloud/reference/cli/influx/apply/). +2. [Install Telegraf](/{{< latest "telegraf" >}}/introduction/installation/) on your Raspberry Pi and ensure your Raspberry Pi has network access to the [InfluxDB Cloud API](/influxdb/cloud/reference/api/). +3. Add the following environment variables to your Telegraf environment: + + - `INFLUX_HOST`: Your [InfluxDB Cloud region URL](/influxdb/cloud/reference/regions/) + - `INFLUX_TOKEN`: Your InfluxDB Cloud [authentication token](/influxdb/cloud/security/tokens/) + - `INFLUX_ORG`: Your InfluxDB Cloud organization name. + + ```sh + export INFLUX_HOST=https://cloud2.influxdata.com + export INFLUX_TOKEN=mY5uP3rS3cr3T70keN + export INFLUX_ORG=example-org + ``` + +4. [Start Telegraf](/influxdb/cloud/write-data/no-code/use-telegraf/auto-config/#start-telegraf). + +## View the incoming data + +1. In the InfluxDB user interface (UI), select **Boards** (**Dashboards**). + + {{< nav-icon "dashboards" >}} +2. Click the Raspberry Pi System link to open your dashboard, then select `rasp-pi` as your bucket and select your linux_host.