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.
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
- 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
Ü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
Ü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
Ü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
Ü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
Ü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
Ü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-Tokennach PKCE-Claim - Eigene Schalter: Alarm-Weiterleitung, Full Access, Backup-Ziel
- Verbindung aus: Überwachung läuft weiter; SMS / Anruf, Fernzugriff und Cloud-Backups entfallen
Was in die Cloud geht – und wann
Nur, wenn Sie eine Instanz verbinden. Aus dem Code gelesen, nicht aus einem Prospekt.
| Was | Wann | Inhalt | Schalter |
|---|---|---|---|
| Herzschlag | alle 30 s | Version, Rechnername, Anzahl der Sensoren, Probes, Karten und offenen Alarme; Namen, Versionen und Online-Status Ihrer Probes | trennen |
| Alarme per SMS, Anruf, Cloud-E-Mail | wenn eine Regel den Absender Matmon Cloud nutzt | Empfängeradresse oder Nummer, Alarmtext (SMS und Anruf: kurze Zusammenfassung, nur kritische Alarme) | Schalter Alarm-Weiterleitung |
| Bericht-E-Mails | wenn ein Bericht den Cloud-Absender nutzt | Empfänger und das Bericht-PDF | anderen Absender wählen |
| Backups | wenn Sie eines anstoßen oder planen | Konfiguration mit verschlüsselten Geheimnissen; Verlauf nur auf Wunsch; Passphrase möglich | Backup-Job: aus / lokal / Cloud |
| Fernzugriff | während Sie ihn nutzen | die Seiten, die Sie öffnen – durch einen Tunnel, den Ihr Matmon aufbaut | Schalter Full Access |
| Partner-Berichte und Vorlagen-Export | wenn Ihr Service-Partner sie anfordert | Verfügbarkeitsbericht (PDF); Vorlagen ohne Zugangsdaten | trennen |
| Windows-Updates und Agent-Pakete | Update-Prüfung, Agent-Download | ein anonymer Download von cloud.matmon.eu/feeds (GitHub als Ersatz) – auch ohne Cloud-Verbindung | Matmon__UpdateFeedUrl |
Nie: Messwerte im Herzschlag, lesbare Passwörter oder Gerätezugänge, irgendetwas direkt von Probes oder Agents.
Ihre Messdaten bleiben, wo sie entstehen.
Matmon ist ein Monitoring, das Sie selbst betreiben. Das gilt ohne jede Einstellung:
Überwachung, Alarme per E-Mail und Webhook, lokale Konten und die Lizenzprüfung funktionieren offline.
Probes und Agents verbinden sich ausgehend. Selbst der Fernzugriff über die Cloud ist ein Tunnel, den Ihr Matmon öffnet.
Keine Analyse, kein „Nach Hause telefonieren“. Die Cloud-Verbindung ist freiwillig und jeder Teil hat einen Schalter.
Gerätezugänge werden verschlüsselt gespeichert – auch im Backup. Eine Backup-Passphrase versiegelt ein Paket für einen anderen Rechner.
Alles, was Matmon speichert, liegt in einem Volume. Umziehen heißt: Ordner kopieren.
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.