https://github.com/allisterb/libpwrm

Realtime, decentralized measuring and reporting on CPU and GPU hardware electricity consumption by blockchain nodes
https://github.com/allisterb/libpwrm

blockchain hardware-monitoring power-monitoring

Last synced: 13 days ago
JSON representation

Realtime, decentralized measuring and reporting on CPU and GPU hardware electricity consumption by blockchain nodes

• Host: GitHub
• URL: https://github.com/allisterb/libpwrm
• Owner: allisterb
• License: gpl-3.0
• Created: 2022-07-08T14:52:58.000Z (over 2 years ago)
• Default Branch: master
• Last Pushed: 2023-04-24T21:35:42.000Z (over 1 year ago)
• Last Synced: 2024-04-14T20:42:24.973Z (7 months ago)
• Topics: blockchain, hardware-monitoring, power-monitoring
• Language: C++
• Homepage: https://devpost.com/software/libpwrm
• Size: 1.14 MB
• Stars: 0
• Watchers: 3
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# About



    



libpwrm is an embeddable library, CLI app and daemon for realtime, decentralized measuring and reporting on CPU and GPU hardware electricity consumption by blockchain nodes without requiring specialized hardware power meters. libpwrm provides software-based continuous monitoring of different hardware power consumption interfaces and automatic reporting of the measurement data and estimated CO2 Emissions to the [CO2.Storage](https://co2.storage/) data network.

libpwrm can [read](https://github.com/allisterb/libpwrm/blob/master/src/measurement/measurement.cpp) power consumption data from [different hardware power meters](https://github.com/allisterb/libpwrm/tree/master/src/measurement) including laptop power supply meters. It can also [read](https://github.com/allisterb/libpwrm/tree/master/src/cpu) CPU power consumption data from Intel's Running Average Power Limit – [RAPL](https://01.org/blogs/2014/running-average-power-limit-%E2%80%93-rapl) interface which uses power metering builtin to Intel CPUs, and NVIDIA GPU power consumption data using the builtin GPU power meters and the [NVML](https://developer.nvidia.com/nvidia-management-library-nvml) interface.

libpwrm runs continuously and publishes the power consumption and emissions data it collects for each system it runs on as assets on CO2.Storage. Each asset can be signed by the operator which authenticates the entity creating it and contains information that the blockchain node operator provides like a unique miner ID and geographic information together with up-to-date information on the current electricity consumption of their hardware. This allows individual blockchain node operators like Filecoin storage providers to automate reporting their electrical consumption data estimates in real-time without requiring installation of external power metering hardware or complex software or making changes to their existing processes.

The aggregated data collected can also provide a useful complement to existing methods of estimating power consumption of an entire blockchain network at a particular time.

## Getting started

**Requirements**:

1. C++11 toolchain

2. CMake 3.17 or greater.

3. To monitor NVIDIA graphics card you'll need the [CUDA Toolkit](https://developer.nvidia.com/cuda-downloads?target_os=Linux) installed.

4. To upload data to CO2.Storage you will need a recent version of NodeJS.

**Installation**

1. Clone the git repository `git clone https://github.com/allisterb/libpwrm.git --recurse-submodules`.

2. Run the `build-debug` script from the repo folder.

3. If you want to upload data to CO2.Storage:

    * cd to the `src/co2.storage` directory and run `npm install`.

    * Create a `.env` file in the same directory with the required CO2.Storage settings plus other fields for recording power usage and emissions. See the `.env.example` [file](https://github.com/allisterb/libpwrm/blob/master/src/co2.storage/.env.example) for an example.

3. Run `./pwrm --help` from the repo folder to see the available commands.