Overview¶
The open-source tools, Telegraf, InfluxDB and Grafana (TIG), comprise the TIG stack, a tech stack commonly used for collecting, storing, and displaying time series data. AiCSD uses the TIG stack in the implementation of the health monitoring feature.
Figure 1 illustrates the data flow and component relationships in the TIG stack.
Note
It isn't necessary to download the tools of the TIG stack separately as they are included in the monitoring feature of AiCSD. However, to find out more about each tool, see the Resources section for each of the tools.
Enable System Health Monitoring¶
To enable monitoring services, update authentication information in the .env
file found within the root directory, as described in Run the Services. This enables Telegraf to send system metrics to InfluxDB.
Note
While some out-of-the-box security measures were taken for the single-user environment, this repository contains the base implementation for monitoring. It is not configured for complex projects or deployment-specific security concerns.
Run the Services¶
To update the authentication information in the .env
file:
- Open the
.env
file found at the root level of this project. - Scroll down to the bottom of the file to the
Monitoring
section. - Find the
DOCKER_INFLUXDB_INIT_PASSWORD
variable and update the value with a password at least 8 characters in length. Be sure to remove the<>
characters. - Find the
DOCKER_INFLUXDB_INIT_ADMIN_TOKEN
variable, update the token value and remove the<>
characters. -
Start Telegraf, InfluxDB, and Grafana:
make run-monitor
This command creates a monitoring Docker network, bringing up the services necessary for monitoring purposes.
View System Health¶
To view the default system health dashboard on the Grafana UI, open a browser to http://localhost:3001.
BSD 3-Clause License: See License.