Skip to content

Latest commit

 

History

History
57 lines (42 loc) · 1.71 KB

README.md

File metadata and controls

57 lines (42 loc) · 1.71 KB
Raw

TIG stack Home Lab Edition (Telegraf/InfluxDB/Grafana) for LINUX, OPENWRT

Telegraf is a plugin-driven server agent for collecting and reporting metrics.
InfluxDB handle massive amounts of time-stamped information.
Grafana is an open platform for beautiful analytics and monitoring.

Requirements

As docker images, TIG stack needs:

  • docker v18.* at least
  • docker-compose v1.2* at least

To be installed on your machine.

How to use it?

.env to the root directory exposes environment variables:

  • TELEGRAF_HOST - agent hostname
  • INFLUXDB_HOST - database hostname
  • INFLUXDB_PORT - database port
  • INFLUXDB_DATABASE - database name
  • INFLUXDB_ADMIN_USER - admin user
  • INFLUXDB_ADMIN_PASSWORD - admin password
  • GRAFANA_PORT - monitoring port
  • GRAFANA_USER - monitoring user
  • GRAFANA_PASSWORD - monitoring password
  • GRAFANA_PLUGINS_ENABLED - enable monitoring plugins
  • GRAFANA_PLUGINS - monitoring plugins list (fetch all available plugins if empty)

Modify it according to your needs and build your custom TIG stack:

$ docker compose up -d

FOR OPENWRT

You have to configure collectd statistics on router

Known issues

  • docker compose command fails for non-root user

    1. Create the docker group if not exists:
    $ sudo groupadd docker
    1. Add your user to the docker group:
    $ sudo usermod -aG docker $USER
    1. Reboot your machine

Then access graphana at http://localhost:3000.

License

Copyright © 2020 Alexis Le Provost. See LICENSE for details.