Skip to main content

System-Überwachung & Analyse

Mit den eEVOS-Monitoringfunktionen überwachen Sie einzelne Systeme und Cluster im laufenden Betrieb. Für tägliche Kontrollen stehen die integrierten Dashboards zur Verfügung. Prometheus, REST API und Ansible eignen sich für detaillierte Abfragen und die zentrale Überwachung mehrerer Installationen.

Monitoringmöglichkeiten im Überblick

Methode Geeignet für Zugriff
eEVOS-Dashboards Tägliche Kontrolle und Diagramme Normale GUI-Anmeldung
Prometheus Metriken, Kapazitätsanalyse und PromQL https://<eevos-adresse>/prometheus/ nach GUI-Anmeldung
REST API Strukturierte Zustands-, Inventar- und Jobdaten API-Schlüssel über https://<eevos-adresse>:18443/api/v1/
Ansible Wiederholbare Prüfungen auf mehreren Systemen Separater Control-Node über SSH oder REST API
Alarme Proaktive Meldung von Dienst- und Kapazitätsproblemen Konfigurierter Benachrichtigungskanal

Integrierte Webüberwachung

  1. Melden Sie sich an der eEVOS-Administrationsoberfläche an.
  2. Öffnen Sie Statistics.
  3. Wählen Sie IO Stats, VM Statistics oder Ceph Stats.
  4. Stellen Sie den Zeitraum ein und vergleichen Sie alle Cluster-Knoten.
  5. Untersuchen Sie dauerhaft hohe Werte, deutliche Abweichungen, fehlende Messreihen und unerwartete Nullwerte.

eEVOS System-Dashboard

Das System-Dashboard bietet einen schnellen Überblick über Zustand und Auslastung.

eEVOS Performance-Monitoring

Bereich Darauf sollten Sie achten
CPU und Load Dauerhafte Auslastung, plötzliche Änderungen oder einen Knoten, der stärker belastet ist.
Arbeitsspeicher Wenig verfügbaren Speicher, steigenden Verbrauch oder Unterschiede zwischen Knoten.
Datenträger und Netzwerk Hohe I/O-Wartezeit, dauerhaft ausgelastete Verbindungen oder inaktive Schnittstellen.
Virtuelle Maschinen CPU-, Speicher-, Block-I/O- und Netzwerkverhalten einzelner VMs.
Ceph OSDs, die nicht up/in sind, degradierte Placement Groups, Recovery, Latenz und Kapazität.

Prometheus verwenden

Prometheus sammelt Zeitreihendaten der System-, VM- und Ceph-Exporter. Öffnen Sie Prometheus ausschließlich über den eEVOS-Proxy. Der lokale Prometheus-Port sollte nicht direkt in ungeschützte Netze veröffentlicht werden.

  1. Melden Sie sich an der eEVOS-Oberfläche an.
  2. Öffnen Sie im selben Browser https://<eevos-adresse>/prometheus/.
  3. Verwenden Sie Query für Abfragen, Alerts für Alarme und Status → Targets für den Exporter-Zustand.

Prometheus-Abfrage in eEVOS

Nützliche Prometheus-Abfragen

Zweck PromQL
Erreichbarkeit aller Exporter up
Systemlast node_load1
Verfügbarer Speicher in Prozent 100 * node_memory_MemAvailable_bytes / node_memory_MemTotal_bytes
Nicht im Leerlauf verbrauchte CPU 100 * (1 - avg by(instance) (rate(node_cpu_seconds_total{mode="idle"}[5m])))
Ceph-OSD-Zustand ceph_osd_up
Verwendete Ceph-Kapazität ceph_cluster_used_bytes

Metriknamen können je nach Edition und Exporterversion abweichen. Prüfen Sie die tatsächlich vorhandenen Namen über die Metriksuche.

REST API für Monitoring konfigurieren

  1. Öffnen Sie System Settings → API Configuration.
  2. Aktivieren Sie den externen REST-API-Zugriff.
  3. Wählen Sie ein erreichbares Verwaltungsnetz. Localhost only ist extern nicht erreichbar.
  4. Verwenden Sie HTTPS und standardmäßig Port 18443.
  5. Erstellen Sie einen eigenen API-Benutzer mit starkem Schlüssel und möglichst schreibgeschützter Rolle.
  6. Legen Sie Ablaufdatum und Rate Limit fest.
  7. Aktivieren Sie Swagger/OpenAPI nur bei Bedarf.
  8. Speichern Sie den Schlüssel in einem Secrets Manager.

REST-API-Einstellungen in eEVOS

Zugriff testen

export EEVOS_URL="https://<eevos-adresse>:18443"
export EEVOS_API_KEY="<api-schlüssel>"

curl --fail --silent --show-error   -H "X-API-Key: $EEVOS_API_KEY"   "$EEVOS_URL/health"

REST-Clients verwenden X-API-Key. Der GUI-Sitzungscookie ist für die REST API nicht geeignet.

Schreibgeschützter Endpunkt Verwendung
/health Zustand des API-Dienstes
/api/v1/product/capabilities Installierte Produktfunktionen
/api/v1/cluster/monitor Zusammenfassung des Clusterzustands
/api/v1/vms/status-quick Kompakte VM-Zustandsübersicht
/api/v1/vms/with-stats VM-Inventar mit Laufzeitdaten
/api/v1/jobs Zustand asynchroner Aufträge

Monitoring mit Ansible

Verwenden Sie einen separaten Ansible-Control-Node. Für einen Cluster genügt normalerweise eine Manager-Adresse. Speichern Sie Passwörter und API-Schlüssel in Ansible Vault und nicht im Inventar.

ansible-playbook --syntax-check monitor-eevos.yml
ansible-playbook --check monitor-eevos.yml
  • Verwenden Sie Leseoperationen für regelmäßige Monitoringläufe.
  • Prüfen Sie neue Playbooks zuerst mit Syntaxprüfung und Check Mode.
  • Verwenden Sie pro Monitoring-System eigene Zugangsdaten.
  • Begrenzen Sie Abfragehäufigkeit und Parallelität.

Alarme und Prüfintervalle

  • Prüfen Sie unter Prometheus → Alerts den Regelzustand.
  • Stellen Sie sicher, dass Alertmanager und Empfänger erreichbar sind.
  • Trennen Sie Warnungen und kritische Meldungen, wenn unterschiedliche Reaktionen erforderlich sind.
  • Senden Sie nach Einrichtung, Upgrades und Zertifikatsänderungen eine Testmeldung.
  • Speichern Sie keine Zugangsdaten in Alarmtexten.
Information Typisches Intervall
API-Zustand und Exporter up 1–5 Minuten
CPU, Speicher, Datenträger und Netzwerk 1–5 Minuten
VM-Laufzeitzustand etwa 5 Minuten
Ceph Health, OSDs und Placement Groups 1–5 Minuten
Kapazitätstrend stündlich oder täglich

Fehlerbehebung

Problem Prüfung und Maßnahme
Prometheus leitet zur Anmeldung um Melden Sie sich zuerst an der GUI an und öffnen Sie den Proxy im selben Browser.
Ein Target ist down Prüfen Sie Status → Targets, lastError, den Knoten, Exporterdienst, DNS und Firewall.
Dashboard enthält Lücken Prüfen Sie Prometheus-Bereitschaft, Target-Zustand, Zeitsynchronisierung und Dienstprotokolle.
REST funktioniert nur lokal Prüfen Sie Listen Network, Firewall, Routing und den externen API-Zugriff.
REST antwortet mit 401 oder 403 Prüfen Sie API-Schlüssel, Rolle, Ablaufdatum und Schlüsselrotation.
REST antwortet mit 429 Reduzieren Sie die Abfragehäufigkeit.

Tägliche Checkliste

  • Alle erwarteten Prometheus-Targets melden up.
  • Alle Knoten liefern aktuelle Systemdaten.
  • Ceph-OSDs und Placement Groups sind fehlerfrei.
  • Keine unerwarteten kritischen Alarme sind offen.
  • REST /health antwortet und Zugangsdaten laufen nicht kurzfristig ab.
  • Aufträge hängen nicht dauerhaft in running.
  • VM- und Balancing-Zustand entsprechen den Erwartungen.
  • Die Kapazität bietet Reserve für Ausfälle und Wartung.

Sicherheit

Verwenden Sie den GUI-Sitzungscookie nur für den Prometheus-Proxy und einen eigenen API-Schlüssel für REST. Beschränken Sie den Zugriff auf Verwaltungsnetze, prüfen Sie TLS-Zertifikate und wechseln Sie Zugangsdaten regelmäßig. Veröffentlichen Sie Prometheus, Exporter oder die REST API nicht direkt in nicht vertrauenswürdige Netze.

Abfragesprache

PromQL ist die Prometheus Query Language. Damit wählen, filtern und berechnen Sie Zeitreihen-Metriken in Prometheus-kompatiblen Dashboards und API-Abfragen.

Weiterführende Anleitungen