RPi-Monitor

From XApple
Jump to: navigation, search

Contents

Overview

RPi-Monitor is a great lightweight monitoring tool available for the Raspberry Pi. It consists of two parts: a daemon being responsible for collecting data and store them into round robin databases and a lightweight web server providing access to the data (runs on port 8888 by default). With a few tweaks it also works on the Roseapple Pi and can easily display status informations and provide graphs for statistics. Have a look at the screenshots below to get the idea.

Since both S500 SoC and the ATC2603 PMU get very hot and thermal throttling might occur it's useful to monitor temperature values, CPU clockspeeds and other important data sources especially when doing performance tests. Fortunately many values are available through sysfs but at the time of this writing it's still unclear how some of them should be interpreted correctly.

Installation

Basic installation

Installation can be done in a couple of minutes when you're using a Debian based distro. Simply follow the installation instructions and do the following afterwards:

Stop RPi-Monitor

systemctl stop rpimonitor # replace systemctl with service prior to Debian Jessie

Create /etc/rpimonitor/template/S500_ATC2603.conf

Create /etc/rpimonitor/template/S500_ATC2603.conf with the following contents (you might want to pipe them through iconv -f UTF8 -t ISO-8859-1 to get the ° symbol displayed correctly):

########################################################################
# Extract S500/ATC2603 information
#  Page: 1
#  Information               Status     Statistics
#  - cpu frequency           - yes      - yes
#  - cpu load 1, 5, 15       - yes      - yes
#  - cpu scaling governor    - yes      - no
#  - power in voltage        - yes      - yes
#  - power in consumption    - yes      - yes
#  - USB OTG voltage         - yes      - yes
#  - USB OTG consumption     - yes      - yes
#  - battery consumption     - yes      - yes
#  - total consumption       - yes      - yes
#  - power in current        - yes      - yes
#  - USB OTG current         - yes      - yes
#  - soc temperature         - yes      - yes
#  - pmu temperature         - yes      - yes
########################################################################
dynamic.1.name=cpu_frequency
dynamic.1.source=/sys/devices/system/cpu/cpu0/cpufreq/cpuinfo_cur_freq
dynamic.1.regexp=(.*)
dynamic.1.postprocess=$1/1000
dynamic.1.rrd=GAUGE

dynamic.2.name=load1,load5,load15
dynamic.2.source=/proc/loadavg
dynamic.2.regexp=^(\S+)\s(\S+)\s(\S+)
dynamic.2.postprocess=
dynamic.2.rrd=GAUGE

dynamic.3.name=scaling_governor
dynamic.3.source=/sys/devices/system/cpu/cpu0/cpufreq/scaling_governor
dynamic.3.regexp=(.*)
dynamic.3.postprocess=
dynamic.3.rrd=

dynamic.4.name=ac_voltage
dynamic.4.source=/sys/devices/b0170000.i2c/i2c-0/0-0065/atc2603c-hwmon.0/wall_voltage
dynamic.4.regexp=(.*)
dynamic.4.postprocess=sprintf("%.2f", $1/1000)
dynamic.4.rrd=GAUGE

dynamic.5.name=ac_consumption
dynamic.5.source=/sys/devices/b0170000.i2c/i2c-0/0-0065/atc2603c-hwmon.0/wall_current
dynamic.5.regexp=(.*)
dynamic.5.postprocess=sprintf("%.2f", $1/153 * $this->{'dynamic'}->{'ac_voltage'})
dynamic.5.rrd=GAUGE

dynamic.6.name=usb_voltage
dynamic.6.source=/sys/devices/b0170000.i2c/i2c-0/0-0065/atc2603c-hwmon.0/vbus_voltage
dynamic.6.regexp=(.*)
dynamic.6.postprocess=sprintf("%.2f", $1/1000)
dynamic.6.rrd=GAUGE

dynamic.7.name=usb_consumption
dynamic.7.source=/sys/devices/b0170000.i2c/i2c-0/0-0065/atc2603c-hwmon.0/vbus_current
dynamic.7.regexp=(.*)
dynamic.7.postprocess=sprintf("%.2f", $1/1000 * $this->{'dynamic'}->{'usb_voltage'})
dynamic.7.rrd=GAUGE

dynamic.8.name=battery_consumption
dynamic.8.source=/sys/devices/b0170000.i2c/i2c-0/0-0065/atc2603c-hwmon.0/bat_current
dynamic.8.regexp=(.*)
dynamic.8.postprocess=sprintf("%.2f", $1/1000)
dynamic.8.rrd=GAUGE

dynamic.9.name=total_consumption
dynamic.9.source=/sys/devices/b0170000.i2c/i2c-0/0-0065/atc2603c-hwmon.0/bat_voltage
dynamic.9.regexp=(.*)
dynamic.9.postprocess=sprintf("%.2f", $1/1000 + $this->{'dynamic'}->{'ac_consumption'} + $this->{'dynamic'}->{'usb_consumption'})
dynamic.9.rrd=GAUGE

dynamic.10.name=usb_current
dynamic.10.source=/sys/devices/b0170000.i2c/i2c-0/0-0065/atc2603c-hwmon.0/vbus_current
dynamic.10.regexp=(.*)
dynamic.10.postprocess=sprintf("%.2f", $1/1000)
dynamic.10.rrd=GAUGE

dynamic.11.name=ac_current
dynamic.11.source=/sys/devices/b0170000.i2c/i2c-0/0-0065/atc2603c-hwmon.0/wall_current
dynamic.11.regexp=(.*)
dynamic.11.postprocess=sprintf("%.2f", $1/153)
dynamic.11.rrd=GAUGE

dynamic.12.name=soc_temp
dynamic.12.source=/sys/devices/virtual/thermal/thermal_zone1/temp
dynamic.12.regexp=(.*)
dynamic.12.postprocess=sprintf("%.1f", $1/1000)
dynamic.12.rrd=GAUGE

dynamic.13.name=pmu_temp
dynamic.13.source=/sys/devices/b0170000.i2c/i2c-0/0-0065/atc2603c-hwmon.0/ic_temperature
dynamic.13.regexp=(.*)
dynamic.13.postprocess=sprintf("%.1f", $1/1000)
dynamic.13.rrd=GAUGE

web.status.1.content.1.name=CPU
web.status.1.content.1.icon=cpu.png
web.status.1.content.1.line.1="Loads: <b>" + data.load1 + "</b> [1min] - <b>" + data.load5 + "</b> [5min] - <b>" + data.load15 + "</b> [15min]"
web.status.1.content.1.line.2="CPU frequency: <b>" + data.cpu_frequency + "MHz</b>  Governor: <b>" + data.scaling_governor + "</b>"

web.status.1.content.2.name=PMU
web.status.1.content.2.icon=pmu.png
web.status.1.content.2.line.1="Total PMU Consumption: <b>" + data.total_consumption + " W</b>"
web.status.1.content.2.line.2="PWR in: <b>" + data.ac_consumption + " W</b> USB OTG in: <b>" + data.usb_consumption + " W</b> BATT in: <b>" + data.battery_consumption + " W</b>"

web.status.1.content.3.name=Temperature
web.status.1.content.3.icon=cpu_temp.png
web.status.1.content.3.line.1=JustGageBar("SoC", "°C",0, data.soc_temp , 125,100,80,percentColors,70,85)+" "+JustGageBar("PMU", "°C",0, data.pmu_temp , 125,100,80,percentColors,70,85)

web.statistics.1.content.1.name=Load / cpufreq / Consumption
web.statistics.1.content.1.graph.1=load1
web.statistics.1.content.1.graph.2=load5
web.statistics.1.content.1.graph.3=load15
web.statistics.1.content.1.graph.4=total_consumption
web.statistics.1.content.1.graph.5=cpu_frequency
web.statistics.1.content.1.ds_graph_options.load1.label=Load 1 min
web.statistics.1.content.1.ds_graph_options.load5.label=Load 5 min
web.statistics.1.content.1.ds_graph_options.load15.label=Load 15 min
web.statistics.1.content.1.ds_graph_options.total_consumption.label=Consumption (W)
web.statistics.1.content.1.ds_graph_options.cpu_frequency.label=Clock speed (MHz)
web.statistics.1.content.1.ds_graph_options.cpu_frequency.yaxis=2
web.statistics.1.content.1.graph_options.y2axis={ position: "right" }

web.statistics.1.content.2.name=PMU current/voltage
web.statistics.1.content.2.graph.1=ac_voltage
web.statistics.1.content.2.graph.2=usb_voltage
web.statistics.1.content.2.graph.3=ac_current
web.statistics.1.content.2.graph.4=usb_current
web.statistics.1.content.2.graph.5=battery_consumption
web.statistics.1.content.2.ds_graph_options.ac_voltage.label=Voltage PWR in (V)
web.statistics.1.content.2.ds_graph_options.usb_voltage.label=Voltage USB OTG (V)
web.statistics.1.content.2.ds_graph_options.ac_current.label=Current PWR in (A)
web.statistics.1.content.2.ds_graph_options.usb_current.label=Current USB OTG (mA)
web.statistics.1.content.2.ds_graph_options.battery_consumption.label=Consumption Battery (W)
web.statistics.1.content.2.ds_graph_options.ac_voltage.yaxis=1
web.statistics.1.content.2.ds_graph_options.usb_voltage.yaxis=1
web.statistics.1.content.2.ds_graph_options.ac_current.yaxis=2
web.statistics.1.content.2.ds_graph_options.usb_current.yaxis=2
web.statistics.1.content.2.ds_graph_options.battery_consumption.yaxis=1
web.statistics.1.content.2.graph_options.y1axis={ position: "left", min: 1.5, max: 11 }
web.statistics.1.content.2.graph_options.y2axis={ position: "right" }

web.statistics.1.content.3.name=Temperature / Consumption
web.statistics.1.content.3.graph.1=pmu_temp
web.statistics.1.content.3.graph.2=soc_temp
web.statistics.1.content.3.graph.3=total_consumption
web.statistics.1.content.3.ds_graph_options.pmu_temp.label=PMU temperature (°C)
web.statistics.1.content.3.ds_graph_options.soc_temp.label=SoC temperature (°C)
web.statistics.1.content.3.ds_graph_options.total_consumption.label=Consumption (W)
web.statistics.1.content.3.ds_graph_options.total_consumption.yaxis=2
web.statistics.1.content.3.graph_options.y1axis={ position: "left", min: 0, max: 125 }
web.statistics.1.content.3.graph_options.y2axis={ position: "right" }

Create /etc/rpimonitor/template/roseapple_pi.conf

Create /etc/rpimonitor/template/roseapple_pi.conf with the following contents:

web.page.icon='img/logo.png'
web.page.menutitle='RPi-Monitor  <sub>('+data.hostname+')</sub>'
web.page.pagetitle='RPi-Monitor ('+data.hostname+')'

web.status.1.name=Roseapple Pi
web.statistics.1.name=Roseapple Pi

include=/etc/rpimonitor/template/version.conf
include=/etc/rpimonitor/template/uptime.conf
include=/etc/rpimonitor/template/S500_ATC2603.conf
include=/etc/rpimonitor/template/memory.conf
include=/etc/rpimonitor/template/swap.conf
include=/etc/rpimonitor/template/sdcard.conf
include=/etc/rpimonitor/template/network.conf

Relink data.conf

ln -sf /etc/rpimonitor/template/roseapple_pi.conf /etc/rpimonitor/data.conf

Start RPi-Monitor again

systemctl start rpimonitor # replace systemctl with service prior to Debian Jessie

Work in progress

Currently it's not clear how to interpret the amount of current the ATC2603C uses correctly. I decided to rely on /sys/devices/b0170000.i2c/i2c-0/0-0065/atc2603c-hwmon.0/wall_current and divide through 153 (since in the user manual it's written "IWALL=ADC_DBG2/IREFADC*1527(mA)"). The results might not be correct so don't trust them. Maybe something's wrong when reading out registers.

Screenshots

Status page:

RPi-Monitor overview.png

Statistics page showing temperatures and consumption:

RPi-Monitor statistics.png

Running BOINC on all 4 CPU cores at 1.1 GHz with heatsink and additional fan on top. On the left side inside a card box. On the right side after using 2 second fan to exhaust the hot air from the enclosure:

Temperature graphs with fan.PNG

See also

Personal tools
Namespaces

Variants
Actions
Navigation
Tools