Archives/selfhosted-apps-docker
2
0
Fork 0
mirror of https://github.com/DoTheEvo/selfhosted-apps-docker synced 2024-11-06 21:20:41 +00:00
Code Issues Projects Releases Wiki Activity
6b152c1404
selfhosted-apps-docker/prometheus_grafana/readme.md
DoTheEvo 6b152c1404 update
2023-02-05 21:42:11 +01:00

15 KiB
Raw Blame History

Prometheus+Grafana in docker

guide-by-example

logo

Purpose

Monitoring of the host and the running cointaners.

Most of the stuff here is based off the magnificent stefanprodan/dockprom.
So maybe just go play with that.

Chapters

Setup here starts off with the basics and then theres chapters how to add features

  • Core prometheus+grafana - to get nice dashboards with metrics from docker host and containers
  • Pushgateway - how to use it to allow pushing metrics in to prometheus from anywhere
  • Alertmanager - how to use it for notifications
  • Loki - how to do the above things but for logs, not just metrics
  • Caddy - adding dashboard for reverse proxy info

Overview

Good youtube overview of Prometheus.

Prometheus is an open source system for monitoring and alerting, written in golang.
It periodicly collects metrics from configured targets, makes these metrics available for visualization, and can trigger alerts.
Prometheus is relatively young project, it is a pull type monitoring.

Glossary.

  • Prometheus Server is the core of the system, responsible for
    • pulling new metrics
    • storing the metrics in a database and evaluating them
    • making metrics available through PromQL API
  • Targets - machines, services, applications that are monitored.
    These need to have an exporter.
    • exporter - a script or a service that gathers metrics on the target, converts them to prometheus server format, and exposes them at an endpoint so they can be pulled
  • Alertmanager - responsible for handling alerts from Prometheus Server, and sending notifications through email, slack, pushover,.. In this setup ntfy webhook will be used.
    Grafana comes with own alerts, but grafana kinda feels... b-tier
  • pushgateway - allows push type of monitoring. Should not be overused as it goes against the pull philosophy of prometheus. Most commonly it is used to collect data from batch jobs, or from services that have short execution time. Like a backup script.
  • Grafana - for web UI visualization of the collected metrics

prometheus components

Files and directory structure

/home/
 └── ~/
     └── docker/
         └── prometheus/
             ├──── grafana_data/
             ├──── prometheus_data/
             ├── docker-compose.yml
             ├── .env
             └── prometheus.yml
  • grafana_data/ - a directory where grafana stores its data
  • prometheus_data/ - a directory where prometheus stores its database and data
  • .env - a file containing environment variables for docker compose
  • docker-compose.yml - a docker compose file, telling docker how to run the containers
  • prometheus.yml - a configuration file for prometheus

The three files must be provided.
The directories are created by docker compose on the first run.

docker-compose

  • Prometheus - Container with some extra commands run at the start up. Setting stuff like storage, data rentetion (500hours - 20 days)... Bind mounted prometheus_data for persistent storage and prometheus.yml for some basic configuration.
  • Grafana - Cotainer, bind mounted directory for persistent data storage
  • NodeExporter - an exporter for linux machines, in this case gathering the metrics of the linux machine runnig docker, like uptime, cpu load, memory use, network bandwidth use, disk space,...
    Also bind mount of some system directories to have access to required info.
  • cAdvisor - an exporter for gathering docker containers metrics, showing cpu, memory, network use of each container
    Runs in privileged mode and has some bind mounts of system directories to have access to required info.

Note - ports are only expose, since expectation of use of a reverse proxy and accessing the services by hostname, not ip and port.

docker-compose.yml

services:

  # MONITORING SYSTEM AND THE METRICS DATABASE
  prometheus:
    image: prom/prometheus:v2.42.0
    container_name: prometheus
    hostname: prometheus
    restart: unless-stopped
    user: root
    depends_on:
      - cadvisor
    command:
      - '--config.file=/etc/prometheus/prometheus.yml'
      - '--storage.tsdb.path=/prometheus'
      - '--web.console.libraries=/etc/prometheus/console_libraries'
      - '--web.console.templates=/etc/prometheus/consoles'
      - '--storage.tsdb.retention.time=500h'
      - '--web.enable-lifecycle'
    volumes:
      - ./prometheus_data:/prometheus
      - ./prometheus.yml:/etc/prometheus/prometheus.yml
    expose:
      - 9090:9090
    labels:
      org.label-schema.group: "monitoring"

  # WEB BASED UI VISUALISATION OF METRICS
  grafana:
    image: grafana/grafana:9.3.6
    container_name: grafana
    hostname: grafana
    restart: unless-stopped
    env_file: .env
    user: root
    volumes:
      - ./grafana_data:/var/lib/grafana
    expose:
      - 3000
    labels:
      org.label-schema.group: "monitoring"

  # HOST LINUX MACHINE METRICS EXPORTER
  nodeexporter:
    image: prom/node-exporter:v1.5.0
    container_name: nodeexporter
    hostname: nodeexporter
    restart: unless-stopped
    command:
      - '--path.procfs=/host/proc'
      - '--path.rootfs=/rootfs'
      - '--path.sysfs=/host/sys'
      - '--collector.filesystem.mount-points-exclude=^/(sys|proc|dev|host|etc)($$|/)'
    volumes:
      - /proc:/host/proc:ro
      - /sys:/host/sys:ro
      - /:/rootfs:ro
    expose:
      - 9100
    labels:
      org.label-schema.group: "monitoring"

  # DOCKER CONTAINERS METRICS EXPORTER
  cadvisor:
    image: gcr.io/cadvisor/cadvisor:v0.47.1
    container_name: cadvisor
    hostname: cadvisor
    restart: unless-stopped
    privileged: true
    devices:
      - /dev/kmsg:/dev/kmsg
    volumes:
      - /:/rootfs:ro
      - /var/run:/var/run:ro
      - /sys:/sys:ro
      - /var/lib/docker:/var/lib/docker:ro
      - /cgroup:/cgroup:ro #doesn't work on MacOS only for Linux
    expose:
      - 3000
    labels:
      org.label-schema.group: "monitoring"

networks:
  default:
    name: $DOCKER_MY_NETWORK
    external: true

.env

# GENERAL
MY_DOMAIN=example.com
DOCKER_MY_NETWORK=caddy_net
TZ=Europe/Bratislava

# GRAFANA
GF_SECURITY_ADMIN_USER=admin
GF_SECURITY_ADMIN_PASSWORD=admin
GF_USERS_ALLOW_SIGN_UP=false

All containers must be on the same network.
Which is named in the .env file.
If one does not exist yet: docker network create caddy_net

prometheus.yml

Official documentation.

Contains the bare minimum setup of targets from where metrics are to be pulled.
Stefanprodan gives a custom shorter scrape intervals, but I feel thats not really necessary.

prometheus.yml

global:
  scrape_interval:     15s
  evaluation_interval: 15s

scrape_configs:
  - job_name: 'nodeexporter'
    static_configs:
      - targets: ['nodeexporter:9100']

  - job_name: 'cadvisor'
    static_configs:
      - targets: ['cadvisor:8080']

  - job_name: 'prometheus'
    static_configs:
      - targets: ['localhost:9090']

Reverse proxy

Caddy v2 is used, details here.

Caddyfile

graf.{$MY_DOMAIN} {
  reverse_proxy grafana:3000
}

prom.{$MY_DOMAIN} {
  reverse_proxy prometheus:9090
}

First run and Grafana configuration

  • login admin/admin to graf.example.com, change the password
  • add Prometheus as a Data source in configuration
    set URL to http://prometheus:9090
  • import dashboards from json files in this repo

These dashboards are the preconfigured ones from stefanprodan/dockprom with few changes.
docker_host.json did not show free disk space, it needed fstype changed from aufs to ext4. Also a fix for host network monitoring not showing traffick. And in all of them the time interval is set to show last 1h instead of last 15m

  • docker_host.json - dashboard showing linux host machine metrics
  • docker_containers.json - dashboard showing docker containers metrics, except the ones labeled as monitoring in the compose file
  • monitoring_services.json - dashboar showing docker containers metrics of containers that are labeled monitoring

interface-pic

Pushgateway

The setup and real world use of pushgateway, along with small steps when learning it are in the repo - Veeam Prometheus Grafana

Including pushing information from windows powershell.

Alertmanager

Several changes are needed

  • New container - alertmanager added to the compose file.
  • New file - alertmanager.yml bind mounted in the alertmanager container.
    This file contains configuration about where and how to deliver alerts.
    A selfhosted ntfy webhook is used that gets alerts to a phone app.
  • New file - alert.rules mounted in to prometheus container
    This files defines when value of some metric becomes an alert event.
  • Changed file - prometheus.yml added alerting section and the path to the rule_files
`docker-compose.yml` ```yml services:

MONITORING SYSTEM AND THE METRICS DATABASE

prometheus: image: prom/prometheus:v2.42.0 container_name: prometheus hostname: prometheus restart: unless-stopped user: root depends_on: - cadvisor command: - '--config.file=/etc/prometheus/prometheus.yml' - '--storage.tsdb.path=/prometheus' - '--web.console.libraries=/etc/prometheus/console_libraries' - '--web.console.templates=/etc/prometheus/consoles' - '--storage.tsdb.retention.time=500h' - '--web.enable-lifecycle' volumes: - ./prometheus_data:/prometheus - ./prometheus.yml:/etc/prometheus/prometheus.yml - ./alert.rules:/etc/prometheus/rules/alert.rules expose: - 9090:9090 labels: org.label-schema.group: "monitoring"

WEB BASED UI VISUALISATION OF METRICS

grafana: image: grafana/grafana:9.3.6 container_name: grafana hostname: grafana restart: unless-stopped env_file: .env user: root volumes: - ./grafana_data:/var/lib/grafana expose: - 3000 labels: org.label-schema.group: "monitoring"

HOST LINUX MACHINE METRICS EXPORTER

nodeexporter: image: prom/node-exporter:v1.5.0 container_name: nodeexporter hostname: nodeexporter restart: unless-stopped command: - '--path.procfs=/host/proc' - '--path.rootfs=/rootfs' - '--path.sysfs=/host/sys' - '--collector.filesystem.mount-points-exclude=^/(sys|proc|dev|host|etc)($$|/)' volumes: - /proc:/host/proc:ro - /sys:/host/sys:ro - /:/rootfs:ro expose: - 9100 labels: org.label-schema.group: "monitoring"

DOCKER CONTAINERS METRICS EXPORTER

cadvisor: image: gcr.io/cadvisor/cadvisor:v0.47.1 container_name: cadvisor hostname: cadvisor restart: unless-stopped privileged: true devices: - /dev/kmsg:/dev/kmsg volumes: - /:/rootfs:ro - /var/run:/var/run:ro - /sys:/sys:ro - /var/lib/docker:/var/lib/docker:ro - /cgroup:/cgroup:ro #doesn't work on MacOS only for Linux expose: - 3000 labels: org.label-schema.group: "monitoring"

ALERT MANAGMENT BY PROMETHEUS

alertmanager: image: prom/alertmanager:v0.25.0 container_name: alertmanager hostname: alertmanager restart: unless-stopped volumes: - ./alertmanager.yml:/etc/alertmanager.yml - ./alertmanager_data:/alertmanager command: - '--config.file=/etc/alertmanager.yml' - '--storage.path=/alertmanager' expose: - 9093 labels: org.label-schema.group: "monitoring"

networks: default: name: $DOCKER_MY_NETWORK external: true

</details>

<details>
<summary>`alertmanager.yml`</summary>
```yml
route:
    receiver: 'ntfy'

receivers:
- name: "ntfy"
  webhook_configs:
  - url: 'https://ntfy.example.com/alertmanager'
    send_resolved: true
`alert.rules` ```yml groups: - name: host rules: - alert: DiskspaceLow expr: sum(node_filesystem_free_bytes{fstype="ext4"}) > 88.2 for: 10s labels: severity: critical annotations: description: "Diskspace is low!" ```
`prometheus.yml` ```yml global: scrape_interval: 15s evaluation_interval: 15s

scrape_configs:

  • job_name: 'nodeexporter' static_configs:

    • targets: ['nodeexporter:9100']

  • job_name: 'cadvisor' static_configs:

    • targets: ['cadvisor:8080']

  • job_name: 'prometheus' static_configs:

    • targets: ['localhost:9090']

alerting: alertmanagers:

  • scheme: http static_configs:
    • targets:
      • 'alertmanager:9093'

rule_files:

  • '/etc/prometheus/rules/alert.rules'
</details>


[ntfy](https://github.com/DoTheEvo/selfhosted-apps-docker/tree/master/gotify-ntfy-signal)
will be used to notify about prometheus alerts.

test:<br>
`curl -H 'Content-Type: application/json' -d '[{"labels":{"alertname":"blabla"}}]' https://alert.example.com/api/v1/alerts`

reload rules
`curl -X POST http://admin:admin@<host-ip>:9090/-/reload`


</details>

---
---

# Update

Manual image update:

- `docker-compose pull`</br>
- `docker-compose up -d`</br>
- `docker image prune`

# Backup and restore

#### Backup

Using [borg](https://github.com/DoTheEvo/selfhosted-apps-docker/tree/master/borg_backup)
that makes daily snapshot of the entire directory.

#### Restore

* down the prometheus containers `docker-compose down`</br>
* delete the entire prometheus directory</br>
* from the backup copy back the prometheus directory</br>
* start the containers `docker-compose up -d`