https://github.com/luizbizzio/solis-inverter-exporter
☀️ A Prometheus exporter written in Python to collect and expose metrics from Solis inverters. It helps monitor solar inverter performance by gathering data on power generation, efficiency, and other key parameters.
https://github.com/luizbizzio/solis-inverter-exporter
automation data-visualization exporter grafana grafana-dashboard homeautomation inverter iot metrics monitoring network open-source prometheus prometheus-exporter python solar solar-system solis solis-pv-inverters soliscloud
Last synced: 4 months ago
JSON representation
☀️ A Prometheus exporter written in Python to collect and expose metrics from Solis inverters. It helps monitor solar inverter performance by gathering data on power generation, efficiency, and other key parameters.
- Host: GitHub
- URL: https://github.com/luizbizzio/solis-inverter-exporter
- Owner: luizbizzio
- License: apache-2.0
- Created: 2024-08-09T22:49:41.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2024-12-23T18:47:48.000Z (6 months ago)
- Last Synced: 2025-02-06T20:13:55.947Z (4 months ago)
- Topics: automation, data-visualization, exporter, grafana, grafana-dashboard, homeautomation, inverter, iot, metrics, monitoring, network, open-source, prometheus, prometheus-exporter, python, solar, solar-system, solis, solis-pv-inverters, soliscloud
- Language: Python
- Homepage: https://www.solisinverters.com/global/inverter
- Size: 635 KB
- Stars: 14
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# Solis Inverter Exporter ☀️📈
## Overview 📊
This script collects and exports key metrics from Solis inverters to Prometheus. It tracks important data points such as Current Generation, Daily Generation, and Total Generation. This allows you to monitor the performance of your inverter with ease.
## Features 🌟
- **Metrics Collection:** Retrieves power output, energy produced today, and total energy produced from Solis inverters.
- **Prometheus Integration:** Provides metrics in a format compatible with Prometheus scraping.
- **Simple Configuration:** Easy to set up with minimal configuration required.
- **Reliable Data Fetching:** Automatically retries in case of network or data fetching errors.
## Configuration ⚙️
1. **Device Configuration:**
Update the following variables with your Solis inverter details:
```python
# Device Configuration
IP = "INVERTER_IP"
USERNAME = "INVERTER_USERNAME"
PASSWORD = "INVERTER_PASSWORD"
```
- `IP`: IP address of your Solis inverter.
- `USERNAME`: Username for your Solis inverter.
- `PASSWORD`: Password for your Solis inverter.
2. **Exporter Port (Optional):**
Set the port for the Prometheus exporter:
```python
PORT = 8686
```
## Usage 🚀
1. **Install Dependencies:**
Install the required Python packages:
```sh
pip install prometheus_client requests beautifulsoup4
```
2. **Run the Script:**
Launch the script to start the Prometheus exporter:
```sh
python solis_exporter.py
```
3. **Access Metrics:**
After running the script, you can access the metrics at:
```init
http://localhost:8686/metrics
```
## Notes 📝
- **Prometheus Data Fetching:** The script continuously fetches data from the inverter and exposes it in Prometheus format. Ensure that your inverter is accessible from the script's host.
- **Configuration:** Verify that the IP address, username, and password for your inverter are correctly set. These settings are crucial for data retrieval.
## License 📄
This project is licensed under the Apache License 2.0 - see the [LICENSE](LICENSE) file for details.