https://github.com/robcowart/raspberry_pi_stats
A script to collect various Raspberry Pi statistics, which are sent via Telegraf to InfluxDB.
https://github.com/robcowart/raspberry_pi_stats
chronograf influxdb raspberry-pi telegraf tick-stack
Last synced: 6 months ago
JSON representation
A script to collect various Raspberry Pi statistics, which are sent via Telegraf to InfluxDB.
- Host: GitHub
- URL: https://github.com/robcowart/raspberry_pi_stats
- Owner: robcowart
- License: mit
- Created: 2019-06-06T08:52:30.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2021-10-13T13:54:22.000Z (about 4 years ago)
- Last Synced: 2025-04-14T15:13:13.248Z (6 months ago)
- Topics: chronograf, influxdb, raspberry-pi, telegraf, tick-stack
- Language: Shell
- Size: 10.7 KB
- Stars: 62
- Watchers: 6
- Forks: 8
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Raspberry Pi Statistics
A script to collect various Raspberry Pi statistics, which are sent via Telegraf to InfluxDB.
## Collecting Raspberry Pi Statistics
The provided `rpi-stats.sh` script collects statistics using Raspbian's `vcgencmd` command. These values are parsed from the command's output and formatted in InfluxDB's [line protocol](https://docs.influxdata.com/influxdb/v1.7/write_protocols/line_protocol_tutorial/) for easy collection via Telegraf's [exec](https://github.com/influxdata/telegraf/tree/master/plugins/inputs/exec) input.
> To learn how to install Telegraf (and the rest of the TICK Stack) on the Raspberry Pi, refer to this [blog](https://www.influxdata.com/blog/running-the-tick-stack-on-a-raspberry-pi/).
Copy the script to the directory from which you wish to run it (I usually put it in `/usr/local/bin`), and ensure that it can be executed by the user under which Telegraf will be run (the default user is `telegraf`). The user will need to have `sudo` rights.
Configure the Telegraf [exec](https://github.com/influxdata/telegraf/tree/master/plugins/inputs/exec) input to execute the script. For example...
```toml
[[inputs.exec]]
# Commands array
commands = [ "/usr/local/bin/rpi-stats.sh" ]
# Timeout for each command to complete.
timeout = "5s"
# Data format to consume.
data_format = "influx"
```
> A complete Telegraf configuration file (`telegraf.conf`) is provided to help you get started.
After Telegraf is started, data will be sent to InfluxDB.
## Import the Dashboard
A Raspberry Pi Health dashboard for Chronograf is provided in the file `Raspberry_Pi_Health.json`. This can be imported from Chronograf's Dashboards list.
## Collected Statistics
Metric | Description
--- | ---
arm_freq | clock frequency of the ARM processor
arm_mem | memory size allocated to the ARM processor
core_freq | clock frequency of the SOC
config_arm_freq | configured clock frequency of the ARM processor
config_core_freq | configured clock frequency of the SOC
config_gpu_freq | configured clock frequency of the GPU
config_sdram_freq | configured clock frequency of the SDRAM
core_volts | voltage provided to the SOC
dpi_freq | clock frequency of the DPI
emmc_freq | clock frequency of the EMMC
gpu_mem | memory size allocated to the GPU
h264_freq | clock frequency of the H.264
hdmi_freq | clock frequency of the HDMI
isp_freq | clock frequency of the ISP
malloc_mem | free GPU memory in the malloc heap
malloc_total_mem | total memory assigned to the GPU malloc heap
mem_reloc_allocation_failures | relocatable memory failures
mem_reloc_compactions | relocatable memory compactions
mem_reloc_legacy_block_failures | relocatable memory legacy block failures
oom_count | count of out-of-memory events
oom_ms | total milliseconds in the out-of-memory handler
pixel_freq | clock frequency of the Pixel
pwm_freq | clock frequency of the PWM
reloc_mem | free GPU memory in the relocatable heap
reloc_total_mem | total memory assigned to the GPU relocatable heap
sdram_c_volts | voltage provided to SOC SDRAM
sdram_i_volts | voltage provided to I/O SDRAM
sdram_p_volts | voltage provided to Physical SDRAM
soc_temp | temperature of the SOC
uart_freq | clock frequency of the UART
v3d_freq | clock frequency of the V3D
vec_freq | clock frequency of the VEC