Table of Contents
Collection of pre-configured softwares to run the SuperGreenOS's cloud.
- Everything in a
docker-compose.ymlfor easy deployement
- MQTT sink port to receive all logs from the driver
- Minimal log post-processor to redirect to:
- Prometheus' alertManager: Allows to describe alert conditions from prometheus timeseries. Then produces alerts on various bias, slack, sms, pigeon, whatnot..
- cAdvisor/node-exporter: The server running the cloud's own monitoring.
- Grafana: Produce nice graphs and dashboard from Prometheus timeseries.
- Kibana (COMMENTED OUT): Produce nice graphs and dashboard from Elasticsearch timeseries.
- Update http server for Over-The-Air (OTA) updates for the SuperGreenOS.
- Better way to upload the new builds' firmware update files
Only requirement in a working docker installation:
There's not much to configure:
- mqtt login/pass: search for
- domain names used: search for
- http access passwords in
Now that docker is installed and running, clone this repo, and from the repo's directory run the command
git clone firstname.lastname@example.org:supergreenlab/SuperGreenCloud.git cd SuperGreenCloud docker-compose up
When ran locally you might want to have the ports of each services accessible directly, just uncomment the
ports sections in
Should be somehting like
mqtt://sink.supergreenlab.com:1883. (If running locally, use your IP address, whatever the domain you set in
Restart the firmware.
View logs remotely
The first thing we can do is view the MQTT broker's logs coming inside our log post-processor:
docker attach --no-stdin --sig-proxy=false supergreencloud_supergreenlog_1
You can safely
Ctrl+C to exit that.
If nothing happens there might be something wrong, directly viewing the firmware's logs through usb will give hints.
Graphs, Dashboards and monitoring
At that point we have:
firmware -> MQTT -> post-processor -> Prometheus
So we're ready to view our data as graphs.
Just point to the URL you specified in your
docker-compose.yml with your browser, if you left the default, you'll have
grafana.supergreenlab.com, DON'T FORGET TO ADD IT TO YOUR
/etc/hosts OR THAT WON'T BE WHAT YOU THINK IT BE.
Default access are:
Now everthing should be setup for you to start their tutorial from this section.