# smartwatts-formula
[](https://gitter.im/Spirals-Team/powerapi?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
[](https://opensource.org/licenses/BSD-3-Clause)
[](https://github.com/powerapi-ng/smartwatts-formula/actions/workflows/build.yml)
[](https://pypi.org/project/smartwatts/)
SmartWatts is a formula for a self-adaptive software-defined power meter based on the [`PowerAPI framework`](https://github.com/powerapi-ng/powerapi).
This project is the implementation of the power meter depicted in the [`SmartWatts: Self-Calibrating Software-Defined Power Meter for Containers`](https://ieeexplore.ieee.org/document/9139675) paper published in the 20th IEEE/ACM International Symposium on Cluster, Cloud and Internet Computing (CCGRID).
This project provides a software power meter that estimates the power consumption (CPU/DRAM) of the `software containers` (i.e. Docker containers, Kubernetes pods, Libvirt virtual machines...) running on a system.
This software power meter is based on `Power Models` that distribute the total energy consumption across the running containers depending on their resource usage.
The `Running Average Power Limit (RAPL)` feature is used to measure the total energy consumption of the CPU/DRAM components, and the `Hardware Performance Counters (HwPC)` are used to measure the resource usage of the containers.
To monitor the Hardware Performance Counters (HwPC) of the software containers running on a Linux system, the [hwpc-sensor](https://github.com/powerapi-ng/hwpc-sensor) project is the preferred solution.
There is currently no support for other client/server platforms such as Windows, MacOS or VMware.
## About
SmartWatts is an open-source project developed by the [Spirals project-team](https://team.inria.fr/spirals), a joint research group between the [University of Lille](https://www.univ-lille.fr) and [Inria](https://www.inria.fr).
The documentation is available [on the PowerAPI website](https://powerapi.org).
## Mailing list
You can follow the latest news and asks questions by subscribing to our <a href="mailto:sympa@inria.fr?subject=subscribe powerapi">mailing list</a>.
## Contributing
If you would like to contribute, you can do so through GitHub by forking the repository and sending a pull request.
When submitting code, please check that it follows [the project's rules](CONTRIBUTING.md) and that the **tests pass**.
## Installation
There is two ways to install official releases of SmartWatts:
- Using the Container image **(recommended)** [from Docker Hub](https://hub.docker.com/r/powerapi/smartwatts-formula) or the [Github Container Registry](https://github.com/powerapi-ng/smartwatts-formula/pkgs/container/smartwatts) ;
- Using the Python package [from Pypi](https://pypi.org/project/smartwatts/).
Raw data
{
"_id": null,
"home_page": null,
"name": "smartwatts",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": null,
"keywords": "powerapi, energy, power-meter, power-model, green-computing, containers",
"author": null,
"author_email": "Guillaume Fieni <guillaume.fieni@inria.fr>",
"download_url": "https://files.pythonhosted.org/packages/45/1c/2f3ea94757c0eabf14a50f0a20d3cdbe682985afd00fbcbe2654e10f8f5d/smartwatts-2.3.0.tar.gz",
"platform": null,
"description": "# smartwatts-formula\n[](https://gitter.im/Spirals-Team/powerapi?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)\n[](https://opensource.org/licenses/BSD-3-Clause)\n[](https://github.com/powerapi-ng/smartwatts-formula/actions/workflows/build.yml)\n[](https://pypi.org/project/smartwatts/)\n\nSmartWatts is a formula for a self-adaptive software-defined power meter based on the [`PowerAPI framework`](https://github.com/powerapi-ng/powerapi). \nThis project is the implementation of the power meter depicted in the [`SmartWatts: Self-Calibrating Software-Defined Power Meter for Containers`](https://ieeexplore.ieee.org/document/9139675) paper published in the 20th IEEE/ACM International Symposium on Cluster, Cloud and Internet Computing (CCGRID).\n\nThis project provides a software power meter that estimates the power consumption (CPU/DRAM) of the `software containers` (i.e. Docker containers, Kubernetes pods, Libvirt virtual machines...) running on a system. \n\nThis software power meter is based on `Power Models` that distribute the total energy consumption across the running containers depending on their resource usage.\nThe `Running Average Power Limit (RAPL)` feature is used to measure the total energy consumption of the CPU/DRAM components, and the `Hardware Performance Counters (HwPC)` are used to measure the resource usage of the containers.\n\nTo monitor the Hardware Performance Counters (HwPC) of the software containers running on a Linux system, the [hwpc-sensor](https://github.com/powerapi-ng/hwpc-sensor) project is the preferred solution.\nThere is currently no support for other client/server platforms such as Windows, MacOS or VMware.\n\n## About\nSmartWatts is an open-source project developed by the [Spirals project-team](https://team.inria.fr/spirals), a joint research group between the [University of Lille](https://www.univ-lille.fr) and [Inria](https://www.inria.fr).\n\nThe documentation is available [on the PowerAPI website](https://powerapi.org).\n\n## Mailing list\nYou can follow the latest news and asks questions by subscribing to our <a href=\"mailto:sympa@inria.fr?subject=subscribe powerapi\">mailing list</a>.\n\n## Contributing\nIf you would like to contribute, you can do so through GitHub by forking the repository and sending a pull request.\n\nWhen submitting code, please check that it follows [the project's rules](CONTRIBUTING.md) and that the **tests pass**.\n\n## Installation\nThere is two ways to install official releases of SmartWatts:\n- Using the Container image **(recommended)** [from Docker Hub](https://hub.docker.com/r/powerapi/smartwatts-formula) or the [Github Container Registry](https://github.com/powerapi-ng/smartwatts-formula/pkgs/container/smartwatts) ;\n- Using the Python package [from Pypi](https://pypi.org/project/smartwatts/).\n",
"bugtrack_url": null,
"license": "BSD-3-Clause",
"summary": "SmartWatts is a formula for a self-adaptive software-defined power meter based on the PowerAPI framework.",
"version": "2.3.0",
"project_urls": {
"documentation": "https://powerapi.readthedocs.org",
"homepage": "https://powerapi.org",
"repository": "https://github.com/powerapi-ng/smartwatts-formula"
},
"split_keywords": [
"powerapi",
" energy",
" power-meter",
" power-model",
" green-computing",
" containers"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "05507196b119b2d66d305cd5bf7d5fa5cc4ba67f3833da533aadbeb1539d25f9",
"md5": "5247a8729a0a5a9536074d546c52441e",
"sha256": "3230b6d28844f2e118d834a562ce5fd405ab149c85fd4e0cf69487ecfc9f1f83"
},
"downloads": -1,
"filename": "smartwatts-2.3.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "5247a8729a0a5a9536074d546c52441e",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 30237,
"upload_time": "2024-09-24T12:34:49",
"upload_time_iso_8601": "2024-09-24T12:34:49.472294Z",
"url": "https://files.pythonhosted.org/packages/05/50/7196b119b2d66d305cd5bf7d5fa5cc4ba67f3833da533aadbeb1539d25f9/smartwatts-2.3.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "451c2f3ea94757c0eabf14a50f0a20d3cdbe682985afd00fbcbe2654e10f8f5d",
"md5": "2f14bd0a86475a15de3e7947174b1c18",
"sha256": "93f091c234c631d26909719b11f83a6106a9eb85c3825cfaed25b7fa86c5866c"
},
"downloads": -1,
"filename": "smartwatts-2.3.0.tar.gz",
"has_sig": false,
"md5_digest": "2f14bd0a86475a15de3e7947174b1c18",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 15616,
"upload_time": "2024-09-24T12:34:50",
"upload_time_iso_8601": "2024-09-24T12:34:50.421724Z",
"url": "https://files.pythonhosted.org/packages/45/1c/2f3ea94757c0eabf14a50f0a20d3cdbe682985afd00fbcbe2654e10f8f5d/smartwatts-2.3.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-09-24 12:34:50",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "powerapi-ng",
"github_project": "smartwatts-formula",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "smartwatts"
}
JSON
