Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- projekte:fabaccess:monitoring [2024/11/23 11:09] – ralf.baumann
+++ projekte:fabaccess:monitoring [2024/12/08 11:52] (aktuell) – [Alerting] ralf.baumann
@@ Zeile 23: / Zeile 23: @@
 ==== Prometheus ====
-Die **[[http://fabaccess:9090/targets|Prometheus Targets@FabAccess]]** sind in in /etc/prometheus/prometheus.yml konfigueriert.
+Die Retention Periode lässt sich nicht pro Target. Daher sind zwei Prometheus Container mit unterschiedlicher Retention Period erstellt.
+=== Prometheus ===
+  * Die **[[http://fabaccess:9090/targets|Prometheus Targets@FabAccess]]** sind in in /etc/prometheus/prometheus.yml konfigueriert.
+  * Die  Retention Periode für die Metriken ist **15 Tage**. Siehe command "--storage.tsdb.retention.time=15d" in der Portainer Stack Definition (docker-compose)
+=== Prometheus Fabaccess ===
+  * Die **[[http://fabaccess:9091/targets|Prometheus Fabaccess Targets@FabAccess]]** sind in in /etc/prometheus_fa/prometheus.yml konfigueriert.
+  * Die Retention Periode für die Metriken ist **365 Tage**. Siehe command "--storage.tsdb.retention.time=365d" in der Portainer Stack Definition (docker-compose)
 ==== Prometheus Exporter ====
-**ToDo**
-  - Installation und Konfigueration des FabAccess und MQTT Exporters [[https://docs.fab-access.org/books/plugins-und-schnittstellen/page/monitoring-prometheus-grafana]]
+  * Beispiel einer Installation und Konfiguration des FabAccess und MQTT Exporters **ohne Docker**: [[https://docs.fab-access.org/books/plugins-und-schnittstellen/page/monitoring-prometheus-grafana]]
-    - sudo nano /etc/systemd/system/prometheus-fabaccess-exporter.service
+  * Prometheus Exporter Repositories
-    - sudo nano /etc/systemd/system/prometheus-mqtt-exporter.service
+    * FabAccess: [[https://gitlab.com/fabinfra/fabaccess/prometheus-exporter]]
-  - Token Access für Node-Exporter muss in Proxmox eingerichtet und dann in sudo nano /etc/prometheus/pve.yml gepflegt werden
+    * generischer Exporter für MQTT: [[https://github.com/kpetremann/mqtt-exporter]]
+  * Erstelle die Docker Images selbst und lade sie in Portainer hoch. Hier ein Beispiel für den fabaccess-exporter:
+    * Lade Repository auf einen PC, auf dem Docker installiert ist (z.B. Polarstern -> Linux Mint im Sternenlabor) und erstelle das Docker Image als .tar file <code bash>
+# load the repository
+mkdir fabaccess-exporter-dockerbuild
+cd fabaccess-exporter-dockerbuild
+git clone https://gitlab.com/fabinfra/fabaccess/prometheus-exporter.git
+# create image and save it as .tar file
+cd fabaccess-exporter
+docker build -t fabaccess-exporter:latest .
+docker save -o fabaccess-exporter.tar fabaccess-exporter:latest
+</code>
+    * **Lade das Docker Image via Portainer** auf die FabAccess VM:
+      * Öffne [[https://fabaccess:9443/|Portainer@fabaccess]]
+      * Gehe zu  Images -> Import
+      * wechsel vom Advanced Mode zum Simple Mode
+      * Wähle das lokal gespeicherte.tar File
+      * Vergebe einen Image Name: fabaccess-exporter:latest;
+      * Upload
+    * **oder kopiere und lade das .tar file mittels CLI**  <code bash>
+scp fabaccess-exporter.tar administrator@fabaccess:/home/administrator/
+ssh administrator@fabaccess
+docker load -i /home/administrator/fabaccess-exporter.tar
+</code>
 ====== Logging ======
-====== Alerting ======
+ToDo: Da müssen wir uns entscheiden, ob wir die Docker Logs direkt nutzen oder Loki. Wenn wir Loki nutzen könnten wir das zentrale Loki auf GalaxyGuardian nutzen oder eins auf der fabaccess VM installieren, wenn fabccess komplett eigenständig inkl.  Monitoring, Logging und Alerting laufen soll.
+====== Alerting ======
+Das Alterting ist in Grafana definiert.