summaryrefslogtreecommitdiffstats
path: root/node.d
diff options
context:
space:
mode:
authorChris <github.account@chrigel.net>2017-07-06 23:59:49 +0200
committerGitHub <noreply@github.com>2017-07-06 23:59:49 +0200
commit9d832116534d21f11f31f0894c5383b2ecf7d9eb (patch)
treed192dd38e97ad724200b99ac0b717a9f6946bf6c /node.d
parent0322e79e5783befa6cfba6782da17899133fa7d9 (diff)
Wiki page for Fronius plugin
It was empty... Adding it to the python.d/readme.md seemed wrong to me.
Diffstat (limited to 'node.d')
-rw-r--r--node.d/README.md63
1 files changed, 63 insertions, 0 deletions
diff --git a/node.d/README.md b/node.d/README.md
index e69de29bb2..21d156ccd8 100644
--- a/node.d/README.md
+++ b/node.d/README.md
@@ -0,0 +1,63 @@
+# Disclaimer
+
+Module configurations are written in JSON and **node.js is required**.
+
+to be edited.
+
+---
+
+The following node.d modules are supported:
+
+# fronius
+
+This module collects metrics from the configured solar power installation from Fronius Symo.
+See `netdata/conf.d/node.d/fronius.conf.md` for more details.
+
+**Requirements**
+ * Configuration file `fronius.conf` in the node.d netdata config dir (default: `/etc/netdata/node.d/fronius.conf`)
+ * Fronius Symo with network access (http)
+
+It produces per server:
+
+1. **Power**
+ * Current power input from the grid (positive values), output to the grid (negative values), in W
+ * Current power input from the solar panels, in W
+ * Current power stored in the accumulator (if present), in W (in theory, untested)
+
+2. **Consumption**
+ * Local consumption in W
+
+3. **Autonomy**
+ * Relative autonomy in %. 100 % autonomy means that the solar panels are delivering more power than it is needed by local consumption.
+ * Relative self consumption in %. The lower the better
+
+4. **Energy**
+ * The energy produced during the current day
+ * The energy produced during the current year
+
+5. **Inverter**
+ * The current power output from the connected inverters, in W, one dimension per inverter. At least one is always present.
+
+
+### configuration
+
+Sample:
+
+```json
+{
+ "enable_autodetect": false,
+ "update_every": 5,
+ "servers": [
+ {
+ "name": "Symo",
+ "hostname": "symo.ip.or.dns",
+ "update_every": 5,
+ "api_path": "/solar_api/v1/GetPowerFlowRealtimeData.fcgi"
+ }
+ ]
+}
+```
+
+If no configuration is given, the module will be disabled. Each `update_every` is optional, the default is `5`.
+
+---