Added monitoring

docs/B._Installation/30_backup.md

@@ -71,4 +71,5 @@ done
 ```shell
 sudo -s
 BORG_PASSPHRASE=s3cr3t-s3cur3-p4ssw0rd bash backup.sh
-```
+```
+

docs/B._Installation/40_monitoring.md

@@ -3,8 +3,7 @@
 !!! info ""
     Work in progress - not finished yet!
 
-Als Monitoring verwenden wir den Prometheus Stack (
-  [Prometheus](https://github.com/prometheus/prometheus)
+Als Monitoring verwenden wir den Prometheus Stack ([Prometheus](https://github.com/prometheus/prometheus)
   + [Alertmanager](https://github.com/prometheus/alertmanager)
   + [Pushgateway](https://github.com/prometheus/pushgateway)) mit
   [Grafana](https://grafana.com/) zur Visualisierung.
@@ -27,8 +26,20 @@ services:
     volumes:
       - "/srv/monitoring/grafana/lib:/var/lib/grafana"
       - "/srv/monitoring/grafana/etc:/etc/grafana"
+    environment:
+      GF_RENDERING_SERVER_URL: http://renderer:8081/render
+      GF_RENDERING_CALLBACK_URL: http://grafana:3000/
     ports:
-      - "[::1]:8000:3000"
+      - "[::1]:3000:3000"
+
+  renderer:
+    image: grafana/grafana-image-renderer:latest
+    restart: always
+    environment:
+      ENABLE_METRICS: 'true'
+      RENDERING_MODE: 'clustered'
+      RENDERING_CLUSTERING_MODE: 'browser'
+      RENDERING_CLUSTERING_MAX_CONCURRENCY: '5'
 
   prometheus:
     image: prom/prometheus
@@ -63,12 +74,11 @@ services:
       - "--path.sysfs=/host/sys"
       - "--path.rootfs=/rootfs"
       - "--collector.filesystem.ignored-mount-points='^(/rootfs|/host|)/(sys|proc|dev|host|etc)($$|/)'"
-      - "--collector.filesystem.ignored-fs-types='^(sys|proc|auto|cgroup|devpts|ns|au|fuse\.lxc|mqueue)(fs|)$$'"
 
   blackbox_exporter:
     image: prom/blackbox-exporter
     restart: always
-    command: "--config.file=/config/config.yaml"
+    command: "--config.file=/config/config.yml"
     volumes:
       - "/srv/monitoring/blackbox_exporter/:/config/"
 
@@ -84,6 +94,7 @@ services:
       - "/sys:/sys:ro"
       - "/var/lib/docker:/var/lib/docker:ro"
       - "/cgroup:/cgroup:ro"
+
 ```
 
 ```yaml
@@ -117,7 +128,7 @@ scrape_configs:
       - source_labels: [__param_target]
         target_label: instance
       - target_label: __address__
-        replacement: blackbox-exporter:9115
+        replacement: blackbox_exporter:9115
 
   - job_name: 'blackbox_exporter_icmp'
     metrics_path: '/probe'
@@ -132,12 +143,12 @@ scrape_configs:
       - source_labels: [__param_target]
         target_label: instance
       - target_label: __address__
-        replacement: blackbox-exporter:9115
+        replacement: blackbox_exporter:9115
 
   - job_name: 'blackbox_exporter'
     static_configs:
       - targets:
-        - blackbox-exporter:9115
+        - blackbox_exporter:9115
 
   - job_name: 'node_exporter'
     static_configs:
@@ -176,3 +187,76 @@ docker compose cp grafana:/etc/grafana /srv/monitoring/grafana/etc
 
 sudo chown -R 472 /srv/monitoring/grafana
 ```
+
+
+### Reverse Proxy aufsetzen
+=== "nginx"
+    ```yaml
+        ports:
+          - "[::1]:8000:8083"
+    ```
+
+    ```nginx
+    # /etc/nginx/sites-available/monitoring.example.com
+    # https://ssl-config.mozilla.org/#server=nginx&version=1.27.3&config=modern&openssl=3.4.0&ocsp=false&guideline=5.7
+    server {
+        server_name monitoring.example.com;
+        listen 0.0.0.0:443 ssl http2;
+        listen [::]:443 ssl http2;
+
+        ssl_certificate /root/.acme.sh/monitoring.example.com_ecc/fullchain.cer;
+        ssl_certificate_key /root/.acme.sh/monitoring.example.com_ecc/monitoring.example.com.key;
+        ssl_session_timeout 1d;
+        ssl_session_cache shared:MozSSL:10m;  # about 40000 sessions
+        ssl_session_tickets off;
+
+        # modern configuration
+        ssl_protocols TLSv1.3;
+        ssl_prefer_server_ciphers off;
+
+        # HSTS (ngx_http_headers_module is required) (63072000 seconds)
+        add_header Strict-Transport-Security "max-age=63072000" always;
+
+        # OCSP stapling
+        ssl_stapling on;
+        ssl_stapling_verify on;
+
+        location / {
+            proxy_pass http://[::1]:3000/;
+            proxy_http_version 1.1;
+            proxy_set_header Upgrade $http_upgrade;
+            proxy_set_header Connection 'upgrade';
+            proxy_set_header X-Real-IP $proxy_add_x_forwarded_for;
+            proxy_set_header X-Forwarded-For $remote_addr;
+            proxy_set_header X-Forwarded-Proto $scheme;
+            proxy_set_header Host $host;
+            proxy_cache_bypass $http_upgrade;
+        }
+    }
+    ```
+
+=== "Traefik"
+    ```yaml
+        labels:
+          - "traefik.enable=true"
+          - "traefik.http.services.srv_monitoring.loadbalancer.server.port=8083"
+          - "traefik.http.routers.r_monitoring.rule=Host(`monitoring.example.com`)"
+          - "traefik.http.routers.r_monitoring.entrypoints=websecure"
+    ```
+
+
+Dieser Webendpoint ist der welcher auf jeden Fall benötigt wird um die Daten darzustellen. Prometheus und Alertmanager haben auch eigene Web Interfaces welche man auch noch mit einem Endpoint versehen könnte. Dies ist aber keine Pflicht.
+
+
+### Erster Login
+Der erste Login ist mit den Zugangsdaten `admin:admin` möglich. Danach fragt Grafana nach einem neuen Passwort für den Admin User.
+
+
+### Erste data source
+Über https://monitoring.example.com/connections/datasources/new kann man eine neue Datenquelle hinzufügen. 
+Dadurch dass in dem docker container ein Prometheus Service ist, können wir Prometheus als Datenquelle hinzufügen. Dies geschiet indem ihr Prometheus auswählt.
+Den Namen der Datenquelle könnt ihr frei wählen. Als URL brauchen wir hier `http://prometheus:9090`.
+
+Am Ende sollte die Konfiguration wie folgt aussehen:
+![Prometheus configuration](../img/monitoring/configuration_prometheus.png)
+

docs/C._Services/psono.md

@@ -14,7 +14,7 @@ aufzusetzen und zu konfigurieren.
 services:
   postgres:
     restart: always
-    image: postgres:13-alpine
+    image: postgres:18-alpine
     env_file: .postgres.env
     environment:
       POSTGRES_USER: psono
@@ -232,7 +232,7 @@ Domains so ohne Probleme verwendet werden und jederzeit auch noch später angepa
 
 ### User erstellen
 ```shell
-docker compose exec python3 ./psono/manage.py createuser \
+docker compose exec psono-combo python3 ./psono/manage.py createuser \
                 username@example.com \
                 myPassword \
                 email@something.com
@@ -243,7 +243,7 @@ Jetzt kann der User sich unter https://psono.domain.de/ einloggen.
 
 ### User zum Admin erklären
 ```shell
-docker compose exec python3 ./psono/manage.py promoteuser username@example.com superuser
+docker compose exec psono-combo python3 ./psono/manage.py promoteuser username@example.com superuser
 ```
 
 Der Admin Login (mit einem Dashboard, Userverwaltung, etc.) befindet sich unter https://psono.domain.de/portal/