Skip to content

Getting Started

Übersicht

VM Tracker ist ein System zur automatischen Überwachung und Verwaltung Server und virtueller Maschinen. Es besteht aus zwei Hauptkomponenten:

API Server

Der VM Tracker API Server ist eine zentrale REST-API, die als zentrale Verwaltungsinstanz fungiert.

Hauptaufgaben: - Empfängt und speichert VM-Registrierungen (Hostname, IP-Adresse, Interface) - Verwaltet den Status aller VMs (online/offline) - Stellt eine Web-Oberfläche zur Übersicht bereit - Bietet REST-API-Endpunkte für VM-Verwaltung - Überwacht automatisch die Erreichbarkeit von VMs (Status-Updates) - Bereinigt inaktive VMs automatisch

Deployment: Der API Server läuft typischerweise als zentraler Service in Ihrer Infrastruktur (Docker, Kubernetes, oder als Binary).

Client

Der VM Tracker Client ist ein leichtgewichtiger Agent, der auf jeder zu überwachenden VM installiert wird.

Hauptaufgaben: - Erkennt automatisch den Hostname der VM - Ermittelt die IP-Adresse des konfigurierten Netzwerk-Interfaces - Sendet regelmäßige Updates (Heartbeats) an den API Server - Führt automatische Wiederholungsversuche bei Verbindungsproblemen durch - Unterstützt Graceful Shutdown

Deployment: Der Client wird auf jeder VM installiert und läuft als Hintergrunddienst (systemd, Docker, oder als Binary).

Architektur

+-------------+     +-------------+     +-------------+
|   VM #1     |     |   VM #2     |     |   VM #3     |
|             |     |             |     |             |
|  +--------+ |     |  +--------+ |     |  +--------+ |
|  | Client | |     |  | Client | |     |  | Client | |
|  +---+----+ |     |  +---+----+ |     |  +---+----+ |
+------+------+     +------+------+     +------+------+
       |                   |                   |
       |   POST /api/register (Heartbeat)      |
       +-------------------+-------------------+
                           |
                           v
                  +-----------------+
                  |   API Server    |
                  |                 |
                  |  +-----------+  |
                  |  | REST API  |  |
                  |  +-----------+  |
                  |                 |
                  |  +-----------+  |
                  |  |  Web UI   |  |
                  |  +-----------+  |
                  |                 |
                  |  +-----------+  |
                  |  |  Storage  |  |
                  |  +-----------+  |
                  +-----------------+

Mehr Architecture informationen

Schnellstart

1. API Server starten

# Mit Docker
docker run -p 8080:8080 vm-tracker-api:latest

# Oder als Binary
./vm-tracker-api

API Server ist erreichbar unter: http://localhost:8080

2. Client auf VMs installieren

# Auf jeder VM
./vm-tracker-client -api "http://API_SERVER_IP:8080" -interface "eth0"

3. Web-Oberfläche öffnen

Öffnen Sie im Browser: http://API_SERVER_IP:8080

Sie sehen nun eine Übersicht aller registrierten VMs mit: - Hostname - IP-Adresse - Status (online/offline) - Letzter Kontakt - Netzwerk-Interface

Typische Anwendungsfälle

Homelab / Selbst gehostete Infrastruktur

Behalten Sie den Überblick über alle VMs in Ihrem Homelab, ohne jeden Server manuell zu überprüfen.

Kubernetes-Cluster

Überwachen Sie Worker-Nodes und deren Netzwerk-Konfiguration.

Cloud-VMs

Verfolgen Sie dynamische IP-Adressen bei DHCP-basierten Infrastrukturen.

Entwicklungsumgebungen

Schnelle Übersicht über Test-VMs und deren aktuelle IP-Adressen.

Nächste Schritte