CPU Temperature plugin for Collectd. Works out of the box on the Raspberry Pi.
Switch branches/tags
Nothing to show
Clone or download
Latest commit 539bf2a Jun 26, 2018
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.gitignore Add .gitignore Mar 22, 2017
LICENSE Initial commit Mar 10, 2017
README.md Add links to other plugins Jun 26, 2018
cpu_temp.py Send value as degrees (float) Mar 11, 2017
mcp3425.py mcp3425: Mention python-smbus requirement May 30, 2018
sht21.py sht21: Add calculation of dew point and absolute humidity Mar 22, 2017
shtc3.py Add shtc3 plugin May 30, 2018

README.md

Collectd Python Plugins

This is a collections of Python plugin for Collectd.

  • cpu_temp.py: Report the CPU temperature. Tested on a Raspberry Pi 3.
  • sht21.py: Measure temperature and relative humidity from a Sensirion SHT21 sensor connected via I²C. Calculate dew point and absolute humidity. Tested on a Raspberry Pi 3.
  • shtc3.py: Measure temperature and relative humidity from a Sensirion SHTC3 sensor connected via I²C. Calculate dew point and absolute humidity. Tested on a Raspberry Pi 3.
  • mcp3425.py: Measure voltage using an MCP3425 analog-digital converter.

For more information, please refer to my blogpost.

Configuration

Copy the desired Python files to your target system. Then add the module to your collectd.conf. Make sure to adjust the ModulePath value. The following example assumes the plugins were copied to /opt/collectd_plugins.

cpu_temp

If your CPU temperature cannot be read from /sys/class/thermal/thermal_zone0/temp, make sure to adjust that variable too.

LoadPlugin python
<Plugin python>
    ModulePath "/opt/collectd_plugins"
    Import "cpu_temp"
    <Module cpu_temp>
        Path "/sys/class/thermal/thermal_zone0/temp"
    </Module>
</Plugin>

sht21

For this plugin to work, the sht21 kernel module must be loaded:

echo "sht21" > /etc/modules-load.d/sht21.conf

There are currently no configuration options available.

LoadPlugin python
<Plugin python>
    ModulePath "/opt/collectd_plugins"
    Import "sht21"
</Plugin>

shtc3

For this plugin to work, the shtc1 kernel module must be loaded:

echo "shtc1" > /etc/modules-load.d/shtc1.conf
modprobe shtc1

There are currently no configuration options available.

LoadPlugin python
<Plugin python>
    ModulePath "/opt/collectd_plugins"
    Import "shtc3"
</Plugin>

mcp3425

The plugin assumes that you're using three voltage divider resistors to bring the voltage into a measurable range. You can configure them in the Python script.

This plugin requires the python-smbus package to be installed.

There are currently no configuration options available.

LoadPlugin python
<Plugin python>
    ModulePath "/opt/collectd_plugins"
    Import "mcp3425"
</Plugin>

Other Plugins

This is my personal collection of plugins. If you also created a Collectd plugin that's great! I won't accept pull requests for now though since I cannot test and maintain plugins for which I don't have any matching hardware.

Instead, feel free to create a pull request to add your plugin to the list below!

  • arris_modem.py: Report the upstream/downstream channels of an Arris DOCSIS3 cable modem.

License

MIT License, see LICENSE file.