sebastian/CoreWatch
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
f7ff12b74da5d584e8bb643f522ec14e955cc55f
CoreWatch/README.md
T
tessmania90 f7ff12b74d Add files via upload
2026-08-24 11:13:54 +02:00

3.5 KiB
Raw Blame History

🛡️ CoreWatch

Ein leichtgewichtiges, Agent-loses und Topologie-basiertes IT-Monitoring-System – zugeschnitten auf KMUs und IT-Dienstleister.

🎯 Was ist CoreWatch?

CoreWatch ist die smarte Antwort auf überladene Monitoring-Lösungen wie Check_mk oder Zabbix. Es konzentriert sich auf das Wesentliche: Ist die Infrastruktur online? Laufen die Docker-Container? Gibt es Hardware-Probleme? Anstatt auf jedem Server eigene Agenten zu installieren, agiert CoreWatch "Agentless" und greift auf bestehende APIs (Proxmox, Portainer) zurück oder nutzt schlanke Push-Webhooks.

✨ Key Features (Geplant)

  • Die "Mutti-Regel" (Topologie-Awareness): Fällt ein Host aus, werden die Alarme für darauf laufende VMs/Container automatisch pausiert. Kein Alert-Spamming mehr!
  • Agentless Monitoring: Direkte API-Anbindung an Proxmox VE und Portainer.
  • Multi-Tenancy: Komplett mandantenfähig für IT-Dienstleister mit granularem Rechtesystem und Host-Gruppen.
  • SSL & Web-Checks: Warnungen vor ablaufenden Zertifikaten und HTTP(S) Status-Tracking.
  • Smart Alerting: Direkte Integration von Gotify (Push) und Mailcow (E-Mail).

🚀 Entwicklungs-Roadmap

🏗️ Phase 1: Core, Datenbank & Multi-Tenancy (Das Fundament)

  • Datenbank-Design (SQLite/MySQL): Struktur für Benutzer, Host-Gruppen (Kunden/Mandanten), Hosts, und Check-Ergebnisse.
  • Multi-User & Rechte: Implementierung einer RBAC (Role-Based Access Control).
  • Worker-Daemon: Ein PHP-CLI-Skript, das als Hintergrunddienst läuft und die Check-Queue abarbeitet.
  • Die "Mutti-Regel": Logik für Parent-Child-Beziehungen implementieren.

🌐 Phase 2: Web & Network Checks

  • ICMP Ping Check: Dual-Stack Unterstützung (IPv4 & IPv6).
  • HTTP/S Status Check: Prüfung auf Statuscode 200/302 und Antwortzeiten.
  • SSL-Zertifikats-Wächter: Auslesen des Zertifikats und automatischer Alert vor Ablauf.
  • SNMP Integration: Basis-Abfragen für Firewalls (OPNSense), Switches und APs.

🖥️ Phase 3: Proxmox Integration

  • Host-Metriken: CPU, RAM und Storage des PVE-Hosts überwachen.
  • Smart/SSD Wearout Check: Abfrage des Wearout-Indikators für Hardware-Ausfallvorhersagen.
  • QEMU Guest Agent Deep-Dive: Überprüfung von VMs via Guest Agent (Root-Filesystem, OS-Crash-Detection).

🐳 Phase 4: Portainer & Docker Integration

  • Portainer API Proxy: Anbindung der globalen Portainer API mit Token.
  • Endpoint-Discovery: Automatisches Auslesen aller angebundenen Docker-Environments.
  • Container Health: Abfragen von CPU, RAM und Health-Status pro Container (ohne lokale Agenten).

🐧 Phase 5: Standalone Linux & Hardware

  • Webhook "Push" Reporter (Heartbeat): API-Route für Bash-Cronjobs von externen Servern.
  • Dead-Man's Switch: Löst Alarm aus, wenn ein "Push"-Host sich nicht meldet.

🔔 Phase 6: Alerting & Notifications

  • Gotify Integration: Push-Benachrichtigungen aufs Handy bei kritischen Ausfällen.
  • Mailcow / SMTP Integration: HTML-Mails mit Fehlerbeschreibungen und Historien-Auszug.
  • Recovery-Benachrichtigung: "Entwarnung", sobald ein Dienst wieder verfügbar ist.

🎨 Phase 7: Das Frontend (Dashboard)

  • Status-Matrix (Ampelsystem): Cleanes, Kachel-basiertes Dashboard in TailwindCSS.
  • Öffentliche Statusseite (Optional): Eine Read-Only-Ansicht für Endkunden (status.domain.de).

Ein Projekt von tessmann.dev

Reference in New Issue View Git Blame Copy Permalink