Aufbau und Transparenz

So funktioniert Matmon – offen gelegt, Verbindung für Verbindung.

Ein Server, den Sie selbst betreiben, Probes und Agents, die sich von außen melden, und eine Cloud, die Sie weglassen können. Hier steht, was wohin geht.

Architektur

Verbindungen und Datenflüsse

Jede Verbindung wird von innen nach außen aufgebaut. Keine eingehenden Ports an entfernten Standorten. Verbindung wählen für Richtung, Protokoll, Port und Inhalt.

Überwachte Netze

Matmon PrimaryDocker (ghcr.io/real-ttx/matmon) oder Windows-Dienst
Primary – TCP 8099
  • Web-UI und REST-API
  • Sensor-Scheduler
  • Alarmierung und Eskalation
  • Verlauf und Berichte
  • Syslog- / Trap-Empfang
  • Backups

Gesamter Zustand in einem Datenvolume (/app/data). Keine Cloud-Abhängigkeit.

Benutzer und Dienste

VerbindungOpt-inInitiatorAntwort
Probe → Primary · HTTP(S), TCP 8099 · nur ausgehend

Übertragen

  • Heartbeat alle 30 s
  • Abruf der Sensorzuweisungen, Sofort- und Discovery-Jobs
  • Messergebnisse

Nicht übertragen

  • Keine eingehende Verbindung zum Probe-Standort
  • Keine Verbindung zur Matmon Cloud

Details

  • Auth: X-Matmon-Probe-Token
  • Primary nicht erreichbar: Ergebnisse auf Disk gepuffert (7 Tage / 100.000), Nachlieferung mit Originalzeitstempel
Agent → Primary · HTTP(S), TCP 8099 · nur ausgehend

Übertragen

  • Gleiches Protokoll wie die Probe: Heartbeat, Zuweisungen, Ergebnisse
  • Lokale Metriken: CPU, Speicher, Datenträger
  • Update-Prüfung gegen den Primary (stündlich)

Nicht übertragen

  • Kein eingehender Port, kein WinRM oder SSH nötig
  • Keine Verbindung zur Matmon Cloud

Details

  • Registrierung: matmon-agent enroll --url … --code … (Einmal-Code); Klartext-HTTP zu öffentlichem Host wird abgelehnt
  • Windows-Dienst (LocalSystem), systemd, launchd
  • Eigenständige Binary: win-x64, linux-x64, linux-arm64, macOS
Primary oder Probe → Gerät · Syslog / Traps → Matmon

Übertragen

  • Abfrage: ICMP, HTTP(S), DNS, TCP, SNMP, Hersteller-APIs (Proxmox, Hyper-V, Synology …)
  • Eingehend: Syslog UDP/TCP 514, SNMP-Traps UDP 162 – nur mit aktiviertem Empfänger

Nicht übertragen

  • Keine Software auf dem Gerät
  • Zugangsdaten nicht im Klartext – DataProtection-verschlüsselt, auch im Backup

Details

  • Geräte in einem entfernten Netz fragt die Probe in diesem Netz ab
  • Empfänger laufen auf Primary, Probe oder Agent
Browser → Primary · HTTP, TCP 8099

Übertragen

  • Web-UI, REST-API, Wallboards (Nur-Lesen-Links)
  • Web-Push an die installierte PWA

Nicht übertragen

  • Kein externer Identity Provider nötig – lokale Konten funktionieren offline

Details

  • Kein eingebautes TLS: HTTPS am Reverse Proxy terminieren (Matmon__TrustedProxies)
  • Zugriff von außen ohne Portweiterleitung: Full Access über die Matmon Cloud
Primary → SMTP-Server / Webhook-URL · direkt

Übertragen

  • Alarmmeldungen per SMTP
  • Webhooks: ntfy, Pushover, Gotify, Telegram, Teams, Slack, Discord, eigene

Nicht übertragen

  • Kein Umweg über Matmon-Server – außer beim Absender „Matmon Cloud“

Details

  • SMS und Anruf nur über den Absender Matmon Cloud, nur bei kritischen Alarmen
Primary → cloud.matmon.eu · HTTPS 443 · ausgehend, Opt-in

Übertragen

  • Heartbeat alle 30 s: Version, Hostname, Anzahlen (Sensoren, Probes, Karten, Alarme), Name / Version / Status der Probes
  • Cloud-Absender: Empfänger und Alarmtext; SMS / Anruf: nur Zusammenfassung
  • Backups (manuell oder geplant): Konfiguration, Secrets verschlüsselt; Verlauf optional
  • Full Access: UI über einen WebSocket-Tunnel (wss), aufgebaut vom Primary

Nicht übertragen

  • Messwerte im Heartbeat
  • Zugangsdaten im Klartext
  • Eingehende Verbindungen zum Primary
  • Datenverkehr von Probes oder Agents

Details

  • Auth: X-Matmon-Instance-Token nach PKCE-Claim
  • Eigene Schalter: Alarm-Weiterleitung, Full Access, Backup-Ziel
  • Verbindung aus: Überwachung läuft weiter; SMS / Anruf, Fernzugriff und Cloud-Backups entfallen

Matmon Cloud im Detail

Was in die Cloud geht – und wann

Nur, wenn Sie eine Instanz verbinden. Aus dem Code gelesen, nicht aus einem Prospekt.

WasWannInhaltSchalter
Herzschlagalle 30 sVersion, Rechnername, Anzahl der Sensoren, Probes, Karten und offenen Alarme; Namen, Versionen und Online-Status Ihrer Probestrennen
Alarme per SMS, Anruf, Cloud-E-Mailwenn eine Regel den Absender Matmon Cloud nutztEmpfängeradresse oder Nummer, Alarmtext (SMS und Anruf: kurze Zusammenfassung, nur kritische Alarme)Schalter Alarm-Weiterleitung
Bericht-E-Mailswenn ein Bericht den Cloud-Absender nutztEmpfänger und das Bericht-PDFanderen Absender wählen
Backupswenn Sie eines anstoßen oder planenKonfiguration mit verschlüsselten Geheimnissen; Verlauf nur auf Wunsch; Passphrase möglichBackup-Job: aus / lokal / Cloud
Fernzugriffwährend Sie ihn nutzendie Seiten, die Sie öffnen – durch einen Tunnel, den Ihr Matmon aufbautSchalter Full Access
Partner-Berichte und Vorlagen-Exportwenn Ihr Service-Partner sie anfordertVerfügbarkeitsbericht (PDF); Vorlagen ohne Zugangsdatentrennen
Windows-Updates und Agent-PaketeUpdate-Prüfung, Agent-Downloadein anonymer Download von cloud.matmon.eu/feeds (GitHub als Ersatz) – auch ohne Cloud-VerbindungMatmon__UpdateFeedUrl

Nie: Messwerte im Herzschlag, lesbare Passwörter oder Gerätezugänge, irgendetwas direkt von Probes oder Agents.

Für sensible Netze gebaut

Ihre Messdaten bleiben, wo sie entstehen.

Matmon ist ein Monitoring, das Sie selbst betreiben. Das gilt ohne jede Einstellung:

Läuft ohne Cloud

Überwachung, Alarme per E-Mail und Webhook, lokale Konten und die Lizenzprüfung funktionieren offline.

Kein offener Port am Standort

Probes und Agents verbinden sich ausgehend. Selbst der Fernzugriff über die Cloud ist ein Tunnel, den Ihr Matmon öffnet.

Keine Telemetrie

Keine Analyse, kein „Nach Hause telefonieren“. Die Cloud-Verbindung ist freiwillig und jeder Teil hat einen Schalter.

Geheimnisse bleiben verschlüsselt

Gerätezugänge werden verschlüsselt gespeichert – auch im Backup. Eine Backup-Passphrase versiegelt ein Paket für einen anderen Rechner.

Ein Datenordner

Alles, was Matmon speichert, liegt in einem Volume. Umziehen heißt: Ordner kopieren.

Lizenz offline geprüft

Ein signierter Lizenzschlüssel, geprüft auf Ihrem Server – mit Kulanzzeit, falls die Cloud nicht erreichbar ist.

Auf dem eigenen Server ausprobieren

Eine Compose-Datei oder ein Windows-Setup – und Sie sehen jede Verbindung selbst.