FAQ¶

Lizenz und Tester-Mode¶

Wir wollen erst mal nur testen — was kostet uns das?¶

Community-Edition reicht für 25 Hosts und einen Tenant. Kostenlos. Setup wie normal, kein Lizenzschlüssel nötig.

Was ist der Unterschied zwischen Tester-Mode und Community?¶

Tester-Mode (VESANA_TESTER_MODE=true) gibt alle Features, ohne Lizenz, mit Phone-Home an license.vesana.org. Community ist limitiert auf bestimmte Features. Tester-Mode ist für Beta-Tester gedacht, die wir explizit eingeladen haben.

Wie lange läuft eine Offline-Lizenz?¶

Standardmäßig 1 Jahr. Erneuerung muss vor Ablauf — der Server warnt 30 Tage vorher per Banner.

Kann ich eine Lizenz auf eine andere Instanz übertragen?¶

Ja: alte Instanz deaktivieren, Lizenz im Portal auf neue Instanz-UUID umstellen.

Tenants und Multi-Mandant¶

Brauche ich für eine Single-Org-Nutzung Multi-Tenant?¶

Nein. Ein einziger Tenant „Internal" reicht.

Kann ein User in mehreren Tenants sein?¶

Aktuell ein Hauptrolle pro User. Cross-Tenant-Sichtbarkeit über Custom-Roles mit tenant.cross_view.

Sieht ein Kunden-User andere Kunden-Tenants?¶

Nein. Tenant-Isolation auf ORM-Ebene — eine Query ohne Tenant-Filter wirft Runtime-Error.

Agents¶

Mein Agent zeigt „outdated" — was tun?¶

Auto-Update läuft beim nächsten Config-Refresh (5 Min). Ungeduldig: Service neu starten triggert Update sofort.

Agent-Token verloren — was nun?¶

Host-Detail-Seite → Token widerrufen → Neu erzeugen. Auf der Maschine Re-Install mit neuem Token.

Kann ich einen Agent-Build von Hand machen?¶

Ja — Repo-Code, cd agent && make build-all VERSION=v1.X.Y. Auto-Update via VERSION-Datei für eigene Builds: VESANA_AUTO_UPDATE=false in der Agent-Config setzen.

Wie viel CPU/RAM braucht der Agent?¶

Idle: ~10 MB RAM, < 1 % CPU. Bei aktiven Logs etwas mehr. Richtwert: vernachlässigbar im Vergleich zur überwachten Anwendung.

Kann der Agent auf Macs laufen?¶

Aktuell nur Linux/Windows. Mac-Support in Roadmap.

Collectors¶

Brauche ich pro Standort einen Collector?¶

Wenn Standorte über VPN unterscheidbar sind: ja, ein Collector pro Standort.

Was macht der Collector wenn er den Server nicht erreicht?¶

Puffert Check-Results lokal (Disk-Queue, ähnlich Agent), schickt sie nach, sobald die Verbindung wieder steht.

Skaliert ein Collector mit der Anzahl SNMP-Hosts?¶

Bis ~500 Hosts pro Collector ohne Probleme. Darüber hinaus zweiten Collector aufsetzen, Hosts aufteilen.

Checks und Profile¶

Warum sind manche Check-Typen ausgegraut?¶

Capability-Filter:

Agent-Checks brauchen Profil mit agent_capable = true + Token erzeugt
SNMP-Checks brauchen snmp_enabled = true
Netzwerk-Checks brauchen ip_address

Ich will einen Check-Type ändern — geht nicht?¶

Korrekt. check_type ist nach Erstellung unveränderlich. Service löschen und neu anlegen.

Wie kriege ich einen modifizierten Builtin zurück?¶

Profile-Modal → Reset. Nur möglich wenn is_modified = true.

Kann ich mehrere Werte aus einem Skript zurückgeben?¶

Ja — agent_script mit Expected-Output nagios und Perfdata: OK - text | metric1=v1 metric2=v2 metric3=v3. Alle Perfdata werden in check_results.perfdata JSONB.

Dashboard¶

Mein Custom-Dashboard ist langsam¶

Mögliche Ursachen:

viele Widgets mit gleicher Query → Query-Caching nutzen
Heatmap mit zu großer Auflösung → Bucket vergrößern
Variable mit multi=true und 1000 Hosts → Variable-Werte begrenzen

Wie teile ich ein Dashboard öffentlich?¶

Edit-Mode → Sichtbarkeit auf Public, Token-URL bekommen. URL teilen.

Verlieren öffentliche Dashboards Daten beim Token-Wechsel?¶

Ja. Wenn du den Token rotierst, ist der alte Link tot.

Alerts und Notifications¶

Wie verhindere ich Alert-Sturm bei großen Outages?¶

Drei Mittel:

Gruppierung in der Alert-Rule (grouping.by)
Inhibition über Dependencies (Eltern-Switch CRIT → Kinder-Alerts unterdrücken)
Rate-Limit pro Channel (Throttle)

Alert kommt zu spät¶

Soft/Hard-State-Modell: Default 3 Versuche × 60 s = 3 Min. Mit Retry-Intervall (15 s) kürzer. Pro Profile-Check anpassen.

Bekomme ich Recovery-Notifications?¶

Default ja. Pro Channel abschaltbar.

Was ist mit Time-Periods („nur Mo–Fr 8–18 alarmieren")?¶

Aktuell nicht direkt. Workaround: Cron-Filter in Alert-Rule. Native Time-Period kommt in Roadmap.

Mobile App¶

iOS?¶

Aktuell kein iOS-Build. In Roadmap.

Tritt manchmal auf — api.resetClient() setzt den axios-Client auf null. App neu starten oder Server trennen + neu koppeln.

Push kommt offline an, wenn Server wieder online geht?¶

Nicht automatisch — FCM verwirft Notifications, die das Device im Offline-Zustand nicht angenommen hat. Im App-Notification-Screen siehst du sie nachträglich.

Updates¶

Update bricht mit „Health-Check timeout" ab¶

Migrationen sind langsam bei großen Tabellen. Auto-Rollback hat ausgelöst — alte Version läuft weiter. Maßnahmen:

in .env UPDATE_HEALTH_TIMEOUT=300 setzen
Update außerhalb von Geschäftszeiten anstoßen, wenn DB lasterm
Bei Verdacht auf konkretes Migrationsproblem: Issue mit Logs öffnen

Wann werden Spalten gedroppt?¶

Frühestens 2 Major-Releases nach Deprecation. Migrationen sind additiv — Rollback bedingt möglich (innerhalb des Deprecation-Fensters).

Kann ich eine bestimmte Version pinnen?¶

Ja: in .env VESANA_UPDATE_CHANNEL=pinned:0.18.5. GUI-Updater pullt dann nur diese Version.

Backup und Restore¶

Wie oft werden Backups gemacht?¶

Mit Backup-Sidecar default täglich 02:00 UTC, 7 Tage Retention. Konfigurierbar.

Wie kriege ich den `FIELD_ENCRYPTION_KEY` zurück, wenn er weg ist?¶

Gar nicht. Verschlüsselte DB-Felder sind dann verloren. Daher: Schlüssel in Passwort-Manager + ausgedruckt im Tresor.

Kann ich nur einen einzelnen Tenant exportieren?¶

Nicht direkt — pg_dump ist die ganze DB. Workaround: Custom-Skript, das Tenant-Daten via API exportiert.

API¶

Bietet Vesana einen Read-Replicate-Endpoint?¶

Nein. Bei Bedarf: API-Replicas hinter pgbouncer hochziehen.

Kann ich PATCH-Operationen batchen?¶

Aktuell jede PATCH einzeln. Bulk-Operations gibt es nur für Tags und Profil-Apply.

Wie hoch ist das Rate-Limit?¶

600 req/min pro User für reguläre Endpoints, 10 req/min/IP für Login/2FA.

AI¶

Was passiert mit unseren Daten bei Anthropic?¶

Anfrage-Inhalt geht zu Anthropic-API. Bei Datenschutz-Bedenken Provider auf Ollama lokal — dann verlässt nichts den Stack.

Wie viel kostet AI?¶

Bei Anthropic: pro Anfrage ein paar Cent. Bei vielen Anfragen kann das im Monat zu zweistelligen Eurobeträgen werden — Kosten-Cap im Anthropic-Dashboard setzen.

Brauche ich Internet für AI?¶

Nur bei Cloud-Providern. Bei Ollama lokal: Internet nur zum Modell-Download.

Sonstiges¶

Kann ich Vesana hinter eine VPN/Bastion stellen?¶

Ja, alle Web-Endpoints sind reines HTTPS — beliebige Reverse-Proxy-/VPN-Topologie davor.

Macht Vesana Telemetry?¶

Optional Update-Check gegen license.vesana.org. Tester-Mode hat zusätzlich Phone-Home mit {instance_id, hostname, version}. Sonst nichts. Inhalte (Hosts, Checks, Werte) verlassen den Server nie automatisch.

Wird ESXi unterstützt?¶

Über SSH (ssh_command, ssh_cpu, ssh_mem, ssh_disk). Direkter vSphere-API-Zugriff aktuell als Custom-Skript.

Kann ich Vesana in einem Kubernetes-Cluster betreiben?¶

Aktuell unterstützen wir Docker Compose. Helm-Chart in Roadmap. Wer es selbst probiert: Compose-File ist die Vorlage, Migration auf Manifests ist mechanisch.

Anschluss¶

Troubleshooting — strukturierte Symptom-Liste
System-Health