https://github.com/raleighlittles/cyberpowerups-influx
A utility for sending your UPS data into InfluxDB.
https://github.com/raleighlittles/cyberpowerups-influx
apcaccess apcupsd cp1000avrlcd cp1350avrlcd cp1500avrlcd cp850avrlcd cyberpower grafana influx-db influxdb powerpanel uninterruptible-power-supply
Last synced: 2 months ago
JSON representation
A utility for sending your UPS data into InfluxDB.
- Host: GitHub
- URL: https://github.com/raleighlittles/cyberpowerups-influx
- Owner: raleighlittles
- Created: 2018-06-08T21:55:56.000Z (almost 7 years ago)
- Default Branch: master
- Last Pushed: 2022-02-02T18:56:55.000Z (over 3 years ago)
- Last Synced: 2025-01-26T14:52:41.858Z (4 months ago)
- Topics: apcaccess, apcupsd, cp1000avrlcd, cp1350avrlcd, cp1500avrlcd, cp850avrlcd, cyberpower, grafana, influx-db, influxdb, powerpanel, uninterruptible-power-supply
- Language: Python
- Homepage:
- Size: 20.5 KB
- Stars: 1
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
Awesome Lists containing this project
README
# About
**A short script to push the status information from a compatible\* [UPS](https://en.wikipedia.org/wiki/Uninterruptible_power_supply) into [InfluxDB](https://www.influxdata.com/).**
# Setup
Depending on what UPS you have and how you plan on communicating with it, you'll need to install ONE of the following:
* CyberPower's [PowerPanel Personal - Linux](https://www.cyberpowersystems.com/product/software/powerpanel-for-linux/) software
* [APC UPS Daemon](http://www.apcupsd.org/) ('apcupsd')
Regardless of which UPS management tool you install, you'll also need to install InfluxDB: https://portal.influxdata.com/downloads
# Usage
First install the Python-InfluxDB client.
```bash
$ pip install influxdb
```
Then, depending on which strategy you're using to interface with your UPS, you will either do:
```bash
$ python3 apcupsd.py
```
or
```bash
$ python3 cyberpower.py
```
## Sudo/Root permissions
Depending on how you installed the CyberPower UPS software, you might need sudo access to actually run it. If you need sudo access to run the CyberPower tool then you will also need to run the python script with sudo access (simply prepend 'sudo' to the command).
# Grafana integration
For instructions on how to add your new InfluxDB source into Grafana, see here: http://docs.grafana.org/features/datasources/influxdb/