This commit is contained in:
2022-01-23 12:21:19 +01:00
parent 5ff3a2457e
commit 91be8f3a81
3 changed files with 8 additions and 285 deletions

View File

@@ -11,22 +11,6 @@
![Travis Ci][travis-shield]
[![Github Activity][commits-shield]][commits]
# Please Note!
Upgrading to 0.5.0 although isn't nessaserily a breaking change, hte config has been adjusted and how it is interprited so please make sure you update the config too!
# Notable mentions
I wanted to mention people/repos that i have borrowed code from to make this work and also who have helped me make this work.
First I wanted to say thanks to [@pvizeli](https://github.com/pvizeli). He helped me with regard to building the image. and just the general work he does on a daily basis
Second I want to say thanks to [@Frenck](https://github.com/frenck). He has helped me a lot on Discord getting this addon working when i was running into errors. His addon for influx db helped me migrate this from Alpine to ubuntu also.
Third I want to say thanks to [@Daniel Welch](https://github.com/danielwelch). I looked at his script for travis builds, he did a write up [here](https://danielwelch.github.io/hassio-dev-env.html) that helped me form a basis of my script.
All of these people are amazing!
# Description
This is a very simple hassio plugin that ebnables you to run telegraf on your hassio system, I am still working on this so please bear with me, I am happy to accept PR's
@@ -35,9 +19,9 @@ This is a very simple hassio plugin that ebnables you to run telegraf on your ha
To Install this addon simply go to: Hassio->Addon-store.
Then add https://github.com/Sabuto/hassio-repo in the add repository by URL box.
Then add https://gitea.bonelle-family.dscloud.biz/francois.bonelle/hassio-repo.git in the add repository by URL box.
Scroll down to Rob's Repo and install Telegraf. Give it a few minutes to install and update.
Scroll down to Francois's Repo and install Telegraf. Give it a few minutes to install and update.
# Config
@@ -51,104 +35,6 @@ custom_conf:
This allows you to specify a custom configuration file so you can add things for yourself if this addon doesn't currently support it. Please note this must be a full telegraf config file not just parts.
```yaml
hostname: ''
```
This allows you set your hostname to something easy
You must have a running influxDB instance (the hassio plugin works)
```yaml
influxDB:
enabled: true,
url: 'http://a0d7b954-influxdb:8086'
db: telegraf
retention_policy: optional
username: optional
password: optional
```
This has been moved into it's own block as that made sense with the other options, some have been made optional (previous versions)
```yaml
kernel:
enabled: true
```
This monitors the kernel
```yaml
swap:
enabled: true
```
This monitors the swap usasge
```yaml
docker:
enabled: false
timeout: 5s
```
This monitors the docker containers
```yaml
smart_monitor:
enabled: false
timeout: 30s
```
This allows you to monitor the temperature of the hard drives
```yaml
impi_sensor:
enabled: false
interval: 30s
timeout: 20s
server_user_id: user
server_password: password
server_protocol: lan
server_ip: 192.168.1.2
```
This allows you to enable the impi settings.
```yaml
influxDBv2:
enabled: false
url: 'http://127.0.0.1:9999'
organization: ''
token: ''
bucket: ''
```
This allows you to use InfluxDBv2 if you have an instance running.
```yaml
prometheus:
enabled: false
metrics_path: '/metrics'
```
This allows you to use the promethus output
# Known issues
~~For some reason at the moment i have figured out how to communicate with the docker.sock therefore i cannot get the process' for docker contaisners. I will look into this and fix it when i can, if you have any idea please submit a PR~~
# TO-DO
~~Add dev branch~~
Add images to installation steps
~~Add PR Template~~
~~Add Issue Template~~
Configure more options to edit for the inputs
Configure different outputs (so it doesn't have to be influxDB dependant, would appreciate it if people could reccomend ones they would find useful.)
## License
MIT License
@@ -177,10 +63,4 @@ SOFTWARE.
[amd64-shield]: https://img.shields.io/badge/amd64-yes-green.svg
[armhf-shield]: https://img.shields.io/badge/armhf-yes-green.svg
[armv7-shield]: https://img.shields.io/badge/armv7-yes-green.svg
[i386-shield]: https://img.shields.io/badge/i386-yes-green.svg
[commits-shield]: https://img.shields.io/github/commit-activity/y/sabuto/hassio-telegraf?style=plastic
[commits]: https://github.com/sabuto/hassio-telegraf/commits/master
[travis-shield]: https://img.shields.io/travis/sabuto/hassio-telegraf
[releases-shield]: https://img.shields.io/github/v/release/sabuto/hassio-telegraf
[releases]: https://github.com/sabuto/hassio-telegraf/releases
[license-shield]: https://img.shields.io/github/license/sabuto/hassio-telegraf
[i386-shield]: https://img.shields.io/badge/i386-yes-green.svg