Zum Inhalt

Hosts anlegen

Ein Host in Vesana ist eine konkrete überwachte Maschine oder Gerät — ein Linux-Server, ein Switch, eine UPS, eine Firewall.

Wege, einen Host zu erzeugen

Weg Wann
Manuell über das Host-Formular Einzelnes Gerät, du weißt schon was es ist
Discovery Du willst das Netz scannen lassen und Hits als Hosts übernehmen
Bulk-Import (CSV / API) Mehrere Hosts auf einen Schlag

Diese Seite beschreibt den manuellen Weg. Für Discovery siehe Discovery.

Schritte

1 — Profil wählen

Hosts → Neu öffnet einen visuellen Profil-Selector. Profile sind nach Kategorie gruppiert (Server, Network Devices, Storage, UPS, …) und zeigen ihre Capabilities als Pills.

Wähle das Profil, das am besten zum Gerät passt. Wenn du unsicher bist:

  • Bei Linux/Windows-Servern: Generic Linux Server / Generic Windows Server
  • Bei Switches: Generic Network Device → später bei Discovery wird ein spezifischeres Profil vorgeschlagen
  • Bei UPS / Storage / Firewall: spezifisches Vendor-Profil wenn vorhanden, sonst Generic

Profile-Capabilities steuern die Felder, die als nächstes erscheinen.

2 — Pflichtfelder ausfüllen

Feld Wann sichtbar
Hostname immer
IP-Adresse wenn profile.ip_required = true (alle SNMP/Ping/HTTP-Profile)
Tenant bei Super-Admin sichtbar; normale User sind auf ihren Tenant fixiert
Description optional
Tags optional, kommagetrennt

Hostname muss innerhalb eines Tenants eindeutig sein. Bei Bedarf den FQDN nehmen.

3 — Monitoring-Modus festlegen

Drei Modi sind möglich, je nach Profil-Capabilities und gewünschter Architektur:

Modus Wann Voraussetzung
Agent Linux/Windows-Server, alle Workstations Profil mit agent_capable = true, Agent-Installation
Collector Switches, UPS, Firewalls, Storage, alles über SNMP/Ping/SSH Collector-VM im Kundennetz
Aktiv Wenig genutzt, nur wo Server-direkter Check ausreicht Direkte Netzwerksicht zum Ziel

Du kannst pro Service entscheiden — viele Hosts haben Agent + Collector gleichzeitig (Agent für lokale CPU/RAM, Collector für SNMP-Sensoren).

4 — Speichern

Nach Speichern landest du auf der Host-Detail-Seite. Hier siehst du:

  • Status-Summary (Anzahl OK / WARN / CRIT / NO_DATA Services)
  • Services-Tabelle (zunächst leer)
  • Agent-Box (wenn agent_capable)
  • Visual (wenn profile.visual_type gesetzt ist)
  • Änderungsverlauf (Audit-Tab)

5 — Agent-Token generieren (wenn Agent-Modus)

Im Agent-Bereich der Host-Detail-Seite:

  1. Agent einrichten klicken
  2. Token wird einmal angezeigt — sofort kopieren
  3. Token in den Agent-Installer einsetzen (siehe Agent-Installation)

Agent-Token sind nicht wiederherstellbar

Wenn du das Token verlierst: Token widerrufen und neues erzeugen. Der alte Agent meldet sich dann nicht mehr — Re-Install nötig.

6 — Services hinzufügen

Wenn das Profil auto_add Profile-Checks hat, sind die Services bereits da. Sonst manuell:

  • Service hinzufügen auf der Host-Detail-Seite
  • Profile-Check aus dem Dropdown wählen (gefiltert nach Capabilities + OS)
  • Optional: Schwellwert-Override, Intervall-Override, Config-Override

Details: Profile bearbeiten.

Validierungs-Regeln im Backend

Beim POST /api/v1/host-services/ gelten Backend-Validierungen, die du in der UI nicht umgehen kannst:

  • Agent-Checks → Host muss agent_managed = true haben (Token generiert)
  • Passive Checks → Host muss einem Collector zugewiesen sein
  • Netzwerk-Checks (ping, port, snmp, ssh_) → ip_address Pflicht
  • Intervall zwischen 10 s und 7 Tagen
  • Retry-Intervall ≥ 5 s und ≤ Hauptintervall
  • check_type ist nach Erstellung unveränderlich — wenn du den Typ ändern willst, Service neu anlegen

Bulk-Operationen

Auf der Hosts-Übersicht (/hosts):

  • Mehrere Hosts auswählen → Tags ergänzen / Tenant zuweisen / Profil wechseln
  • Filter nach Status, Tag, Tenant
  • Suche im Hostname

Massen-Profilwechsel löst beim Apply die Auto-Add-Checks aus — bestehende Services bleiben erhalten, neue kommen dazu.

Anschluss