How Install Graphite and Graphite-Web on Linux with docker and systemd

Graphite is a free open-source software tool that monitors and graphs numeric time-series data such as the performance of computer systems. Graphite monitoring provides operations teams with visibility on varying levels of granularity concerning the behavior and mannerisms of the systems and applications. This leads to error detection, resolution, and continuous improvement.

Graphite stores numeric time-series data (metric, value, epoch timestamp) and renders graphs of this data on demand. A time-series is a sequence of observations taken sequentially in time. Time series analysis reveals trends and patterns associated with external factors and anomalies. With adequate graphing teams and enough time series data, it’s even possible to intuitively forecast future events.

As Graphites design is orientated towards modularity and doing one thing very well, there is no direct data collection support. Carbon, one of the three Graphite components, listens passively for data. Solutions such as StatsD and CollectD are used to collect and parse data upstream to Graphite as different protocols.

The main graphite components are:

carbon – a Twisted daemon that listens for time-series data
whisper – a simple database library for storing time-series data (similar in design to RRD)
graphite webapp – A Django webapp that renders graphs on-demand using Cairo

# Table of content

Ensure docker is locally installed
Running Graphite
Accessing Graphite web interface
Managing Graphite container with systemd
Starting and enabling graphite-docker service

# 1. Ensure that docker installed

Since we are using docker to run graphite, ensure it is installed before proceeding. If you don’t have docker installed, check these guides:

Check installed docker version using this command:

$ docker version
Client: Docker Engine - Community
 Version:           20.10.12
 API version:       1.41
 Go version:        go1.16.12
 Git commit:        e91ed57
 Built:             Mon Dec 13 11:45:33 2021
 OS/Arch:           linux/amd64
 Context:           default
 Experimental:      true

Server: Docker Engine - Community
 Engine:
  Version:          20.10.12
  API version:      1.41 (minimum version 1.12)
  Go version:       go1.16.12
  Git commit:       459d0df
  Built:            Mon Dec 13 11:43:42 2021
  OS/Arch:          linux/amd64
  Experimental:     false
 containerd:
  Version:          1.4.12
  GitCommit:        7b11cfaabd73bb80907dd23182b9347b4245eb5d
 runc:
  Version:          1.0.2
  GitCommit:        v1.0.2-0-g52b36a2
 docker-init:
  Version:          0.19.0
  GitCommit:        de40ad0

# 2. Running Graphite

The simplest way of running graphite is using its docker components. This will save you the time of installing each component and setting its dependencies. The docker project work can be found in this github repo.

The docker image includes the following components:

Nginx – reverse proxies the graphite dashboard
Graphite – front-end dashboard
Carbon – back-end
Statsd – UDP based back-end proxy

The following ports are exposed from the container. We will map them locally later:

Citizix - graphite web — Citizix – graphite web

Host	Container	Service
8090	80	nginx
2003	2003	carbon receiver – plaintext
2004	2004	carbon receiver – pickle
2023	2023	carbon aggregator – plaintext
2024	2024	carbon aggregator – pickle
8080	8080	Graphite internal gunicorn port (without Nginx proxying).
8125	8125	statsd
8126	8126	statsd admin