README.md

TIG stack (Telegraf/InfluxDB/Grafana)

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

Known issues

• docker compose command fails for non-root user

  1. Create the docker group if not exists:

  $ sudo groupadd docker

  2. Add your user to the docker group:

  $ sudo usermod -aG docker $USER

  3. Reboot your machine

Then access graphana at http://localhost:3000 (or replace the default port with your GRAPHANA_PORT's value).

License

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