Code Monkey home page Code Monkey logo

rpi-tig's Introduction

rpi-tig

Dockerized Telegraf/InfluxDB/Grafana for Rpi

I just wanted a fire-and-forget way to quickly monitor a new Pi, this is it. On a Raspbian Buster image, simply:

apt-get install docker.io docker-compose

... clone this repository, and do a single ./start.sh. You should be set. After a couple of minutes (it's a Raspberry Pi after all), you will get the following:

  • A telegraf instance gathering system stats, with statsd available on the local host for external log input
  • InfluxDB storing the telegraf data
  • Grafana already configured to talk to the InfluxDB instance, and preconfigured with a default system dashboard

I made a moderate effort to at least randomize the Influx database password at first run, and Grafana will remind you to change the admin password. That said, if you put this in production as is, it's really on you. There are many things that should still be done before considering this secure in any way...

Included dashboards

The grafana instance is automatically provisioned with a couple of dashboard that are useful for me, and in any case are hopefully interesting examples of what grafana + influx can do.

  • System stats: a Raspberry Pi centric system monitoring dashboard
  • goestools: monitors the statistics of a goestools receiver
  • ax25 clients: traffic statistics of an Amateur Radio AX25 stack (see additional info below)

AX25 dashboard

Look in the utils directory for the files you should install on your Pi to spawn a listen process that is logged to /var/log and picked by Telegraf.

Notes

  • telegraf inside a Docker container will not be able to monitor your network interfaces, obviously
  • This stack works remarkably well on a Pi 3B+ (and 4, of course). I've had it monitor devices for months at a time with zero issues
  • Thanks to docker-compose/Docker, the stack will survive a reboot
  • Provisioned dashboards on Grafana cannot be saved, so they really should be used as templates, and saved as a new Dashboard if you want to edit/modify them
  • Feel free to contribute PRs with useful dashboards if you have some

rpi-tig's People

Contributors

elafargue avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.