Quelltext der Seite Grafana: Monitoring-Stack mit Prometheus, Alloy und Loki

{{Steckbrief
| gilt_fuer   = Prometheus 3.15, Grafana Alloy 1.20, Loki 3.7, node_exporter, windows_exporter, SNMP Exporter; Grafana 13.x; Docker Compose auf Linux
| bereich     = Server-Software
| dauer       = Grundaufbau ca. 2–3 Stunden; Anbindung weiterer Systeme je ca. 15–30 Minuten
| rechte      = Root auf dem Monitoring-Server; Administratorrechte auf den überwachten Systemen; SNMP-Lesezugriff auf Netzwerkgeräte
| stand       = Oktober 2026
}}
'''Ein Monitoring-Stack mit Prometheus, Alloy und Loki''' liefert Grafana die Daten: Prometheus speichert Messwerte wie CPU-Last, Speicher, Plattenplatz oder Port-Auslastung, Loki speichert Logs, und '''Grafana Alloy''' sammelt beides auf den Servern ein. Netzwerkgeräte wie Switches und Firewalls werden per SNMP abgefragt. Diese Anleitung baut den Stack mit Docker Compose auf, bindet Linux- und Windows-Server, Docker-Hosts und Netzwerkgeräte an und zeigt, worauf bei Speicherbedarf und Aufbewahrung zu achten ist.

[[Datei:Grafana-Monitoring.png|thumb|center|750px|Monitoring-Stack für Grafana: Grafana Alloy auf Linux-Servern sammelt Systemmetriken (eingebauter node_exporter) und Logs aus Dateien und dem systemd-Journal; windows_exporter auf Windows-Servern; SNMP Exporter fragt Switches, Firewalls und USV ab; Prometheus speichert Metriken (PromQL, Aufbewahrung z. B. 90 Tage), Loki speichert Logs (LogQL, Aufbewahrung z. B. 30 Tage); Grafana fragt beide ab; Promtail ist seit März 2026 abgekündigt und wird durch Alloy ersetzt.]]

== Die Bausteine ==
{| class="wikitable"
! Baustein !! Version (Okt. 2026) !! Aufgabe
|-
| '''Prometheus''' || 3.15 || holt Metriken per HTTP ab („Scrape“) und speichert sie; Abfragesprache PromQL; nimmt auch Daten per Remote Write an
|-
| '''Grafana Alloy''' || 1.20 || Sammler für Metriken, Logs und Traces; Nachfolger von Grafana Agent und '''Promtail''' (Promtail ist seit 2. März 2026 abgekündigt)
|-
| '''Loki''' || 3.7 || speichert Logs platzsparend, indiziert nur Labels; Abfragesprache LogQL
|-
| '''Exporter''' || – || stellen Messwerte bereit: node_exporter (Linux), windows_exporter, SNMP Exporter, Blackbox Exporter (Erreichbarkeit, Zertifikate)
|}
Grundlagen: [[Prometheus]], [[Loki]], [[PromQL]], [[Exporter]].

== Schritt 1: Prometheus und Loki bereitstellen ==
Auf dem Grafana-Server (oder einem eigenen Monitoring-Server) die Compose-Datei ergänzen:
<syntaxhighlight lang="yaml">
  prometheus:
    image: prom/prometheus:v3.15.0
    restart: unless-stopped
    command:
      - --config.file=/etc/prometheus/prometheus.yml
      - --storage.tsdb.retention.time=90d
      - --web.enable-remote-write-receiver
    volumes:
      - ./prometheus/prometheus.yml:/etc/prometheus/prometheus.yml:ro
      - prom-data:/prometheus
    ports:
      - "9090:9090"

  loki:
    image: grafana/loki:3.7.8
    restart: unless-stopped
    command: -config.file=/etc/loki/local-config.yaml
    volumes:
      - loki-data:/loki
    ports:
      - "3100:3100"

  snmp-exporter:
    image: prom/snmp-exporter
    restart: unless-stopped
</syntaxhighlight>
* Die Ports 9090 und 3100 nur für die Server freigeben, die Daten liefern – per Host-Firewall; Prometheus und Loki haben ohne Zusatzmaßnahmen '''keine Anmeldung'''.
* '''Aufbewahrung''': Prometheus über <code>--storage.tsdb.retention.time</code>; Loki über <code>retention_period</code> und den Compactor in einer eigenen Konfigurationsdatei (die mitgelieferte Beispielkonfiguration ist für Tests gedacht).
* '''Speicherbedarf''' grob: wenige Bytes je Messwert; 50 Server mit Standard-Metriken im 30-Sekunden-Takt brauchen für 90 Tage einige 10 GB. Logs wachsen deutlich schneller – Aufbewahrung bewusst wählen.

== Schritt 2: Linux-Server mit Alloy anbinden ==
Alloy auf jedem Linux-Server aus dem Grafana-Paketrepository installieren (<code>apt install alloy</code>) und <code>/etc/alloy/config.alloy</code> anlegen:
<syntaxhighlight lang="text">
// Systemmetriken (eingebauter node_exporter)
prometheus.exporter.unix "node" { }

prometheus.scrape "node" {
  targets    = prometheus.exporter.unix.node.targets
  forward_to = [prometheus.remote_write.zentral.receiver]
}

prometheus.remote_write "zentral" {
  endpoint { url = "http://monitor.firma.lan:9090/api/v1/write" }
}

// Logs aus dem systemd-Journal
loki.source.journal "journal" {
  labels     = { job = "journal", host = constants.hostname }
  forward_to = [loki.write.zentral.receiver]
}

loki.write "zentral" {
  endpoint { url = "http://monitor.firma.lan:3100/loki/api/v1/push" }
}
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo systemctl enable --now alloy
</syntaxhighlight>
* Damit Alloy das Journal und Logdateien lesen darf, den Dienstbenutzer <code>alloy</code> in die Gruppen <code>systemd-journal</code> und <code>adm</code> aufnehmen.
* Alloy hat eine eigene Weboberfläche (Standard Port 12345, nur lokal), die den Datenfluss der Komponenten zeigt – hilfreich bei der Fehlersuche.
* Bestehende Promtail-Konfigurationen lassen sich mit <code>alloy convert --source-format=promtail</code> umwandeln. Die von Alloy gelieferten Metriken unterscheiden sich von denen von Promtail; Dashboards und Alarme darauf prüfen.
* '''Docker-Hosts''': Container-Logs mit <code>discovery.docker</code> und <code>loki.source.docker</code> einsammeln, Container-Metriken mit <code>prometheus.exporter.cadvisor</code>.

== Schritt 3: Windows-Server ==
* '''windows_exporter''' (MSI-Paket) installieren; er stellt Metriken auf Port 9182 bereit. Alternativ Alloy für Windows mit <code>prometheus.exporter.windows</code>, der auch Ereignisprotokolle an Loki senden kann (<code>loki.source.windowsevent</code>).
* In <code>prometheus.yml</code> als Ziel eintragen:
<syntaxhighlight lang="yaml">
scrape_configs:
  - job_name: windows
    static_configs:
      - targets: ['dc01.firma.lan:9182', 'fs01.firma.lan:9182']
</syntaxhighlight>

== Schritt 4: Switches, Firewalls und USV per SNMP ==
Der SNMP Exporter übersetzt SNMP-Abfragen in Prometheus-Metriken. Das mitgelieferte <code>snmp.yml</code> enthält Module wie <code>if_mib</code> (Schnittstellen-Traffic, Fehler, Status):
<syntaxhighlight lang="yaml">
  - job_name: snmp-switches
    metrics_path: /snmp
    params:
      module: [if_mib]
      auth: [public_v2]
    static_configs:
      - targets: ['sw-core01.firma.lan', 'sw-etage1.firma.lan', 'fw01.firma.lan']
    relabel_configs:
      - source_labels: [__address__]
        target_label: __param_target
      - source_labels: [__param_target]
        target_label: instance
      - target_label: __address__
        replacement: snmp-exporter:9116
</syntaxhighlight>
* '''SNMPv3''' mit Authentifizierung und Verschlüsselung verwenden, wo die Geräte es unterstützen; Zugangsdaten werden im Bereich <code>auths</code> der <code>snmp.yml</code> hinterlegt (eigene Datei mit dem Generator erzeugen).
* SNMP-Zugriff auf den Geräten nur für die IP des Monitoring-Servers erlauben, siehe [[SNMP]].
* Für UniFi, Cisco und OPNsense gibt es fertige Module bzw. Dashboards; alternativ sammelt Alloy die Syslog-Meldungen der Geräte (<code>loki.source.syslog</code>).

== Schritt 5: In Grafana einbinden ==
* Datenquellen '''Prometheus''' (<code>http://prometheus:9090</code>) und '''Loki''' (<code>http://loki:3100</code>) anlegen, siehe [[Grafana: Datenquellen und Dashboards erstellen]].
* Fertige Dashboards importieren, z. B. „Node Exporter Full“ für Linux-Server oder Dashboards für windows_exporter und SNMP-Schnittstellen.

== Hinweise ==
* '''Vorhandenes Monitoring''': Läuft bereits Zabbix oder InfluxDB/Telegraf, kann Grafana diese Daten zusätzlich darstellen – ein Neuaufbau ist nicht nötig, siehe [[Installation von InfluxDB und Grafana auf Debian 13]].
* '''Logs mit Sicherheitsbezug''' (Anmeldungen, Firewall-Verbindungen) gehören zusätzlich ins SIEM; Loki ersetzt keine Korrelation und keine Nachweisführung.
* '''Größere Umgebungen''': Für viele hundert Systeme oder lange Aufbewahrung skalieren Mimir (Metriken) und Loki im verteilten Betrieb mit Objektspeicher.
* Bei Konzeption und Betrieb von Monitoring- und SIEM-Lösungen mit Open Source unterstützt Sie das Team [https://www.max-it.de/it-services/siem-open-source/ SIEM & Monitoring mit Open Source von m.a.x. it].

== Siehe auch ==
* [[Grafana im Unternehmen]] – Überblick und alle Artikel der Reihe
* [[Monitoring]]
* [[OpenTelemetry]]
* [[Log-Management]]

== Links und Quellen ==
* [https://grafana.com/docs/alloy/latest/ Grafana Alloy Dokumentation]
* [https://www.max-it.de/it-services/siem-open-source/ SIEM & Monitoring mit Open Source von m.a.x. it]

{{Uebermax}}
[[Kategorie:Server-Software]]