Zum Inhalt

Support-Bundle & Feedback-Weg

Wenn keiner der anderen Troubleshooting-Leitfäden zur Ursache führt, ist ein Support-Bundle der schnellste Weg, uns die nötigen Informationen zu geben — ohne dass du selbst Logs zusammensuchen und Secrets von Hand schwärzen musst.

Support-Bundle erzeugen

Admin → Protokolle & Support → Support-Bundle (nur Super-Admins). Vorschau, Senden und Herunterladen verlangen eine frische Identitätsbestätigung (Passkey, Authenticator-Code oder Passwort).

Das Bundle ist bewusst eine Volldiagnose — es enthält alles, was zum Verstehen eines Bugs nötig ist: Versionen, System-Health, RAM/Disk/Load, Docker-Container-Zustand (Status, Restarts, OOM-Ereignisse, Image-Tags), Datenbank- und Redis-Statistiken, den Zustand der Check-Pipeline, alle aktuell nicht-OK-Checks mit ihrer effektiven Konfiguration, Hosts/Collectors/Agents, die letzten Diagnose-Ereignisse, das Benachrichtigungs-Log, Fehler-Zusammenfassungen, Rohlogs, Konfigurationswerte (bereinigt) und den Migrationsstand. Die einzige harte Grenze ist: echte Secrets kommen nie mit — Tokens, Passwörter, private Schlüssel, SMTP-Zugangsdaten und Zugangsdaten von Benachrichtigungskanälen (z. B. Telegram-Token, Webhook-Adressen) werden vor dem Verpacken automatisch erkannt und maskiert. Hast du eine eigene docker-compose.override.yml, steht im Bundle nur, dass sie aktiv ist und welche Dienste sie anfasst — keine Werte. Findet die Prüfung danach trotzdem noch einen Treffer, wird das ganze Bundle verworfen, statt es unvollständig geschwärzt zu verschicken.

Vor dem Senden: Sektionen abwählen

Du musst nicht alles mitschicken. Vor dem Senden oder Herunterladen kannst du:

  • einzelne Sektionen abwählen (z. B. Rohlogs weglassen, wenn du nur den Pipeline-Zustand zeigen willst)
  • eine kurze Beschreibung hinzufügen — was ist das Problem, was hast du schon versucht

Der tatsächlich versendete Stand wird server-seitig noch einmal durch die Maskierungs-Prüfung gezogen — auch wenn du Sektionen manuell bearbeitet hast, bevor du sendest.

Senden oder herunterladen

  • Senden — geht direkt ans Lizenzportal, landet dort in unserer Diagnose-Ansicht
  • Herunterladen — als Datei lokal speichern, z. B. um es per Mail an hello@vesana.org oder über einen bestehenden Kommunikationskanal zu schicken, wenn Senden über die GUI aus irgendeinem Grund nicht möglich ist

Feedback-Button

Für alles, was kein akutes Problem ist — Ideen, kleinere Unstimmigkeiten, „das könnte besser sein" — nutze den Feedback-Button in der Oberfläche (falls von deinem Admin aktiviert; am Computer unten rechts, am Handy oben in der Kopfzeile). Deine Einreichung wird lokal gespeichert und landet automatisch als Issue in unserem Tracking. Der Status fließt zurück und ist im Feedback-Widget unter „Meine Einreichungen" zu sehen.

Ist ein Fehler bei uns behoben, steht dort zuerst „Behoben, kommt mit dem nächsten Update" — „Erledigt" (mit der Version) erst, wenn das Update mit dem Fix für deine Instanz verfügbar ist. Hast du beim Einreichen einen Benachrichtigungs-Kanal gewählt, bekommst du genau dann eine Nachricht; sind mit einem Update mehrere deiner Meldungen erledigt, kommen sie gesammelt in einer Nachricht. Rückmeldungen wie „in Bearbeitung" oder „wird nicht umgesetzt" kommen sofort.

Ist der Feedback-Button auf deiner Instanz deaktiviert, oder du bevorzugst den direkten Weg: hello@vesana.org.

Wann welcher Weg?

Situation Weg
Konkreter Bug, den wir ohne Kontext nicht nachvollziehen können Support-Bundle senden
Kurze Frage, Idee, kleine Unstimmigkeit Feedback-Button oder Mail
Dringendes Problem auf einer produktiven Instanz Support-Bundle senden + direkt Mail an hello@vesana.org mit Hinweis auf Dringlichkeit
Frage zu Preisen/Lizenz hello@vesana.org (siehe Lizenz-Tiers)

Was du selbst schon prüfen kannst, bevor du ein Bundle schickst

Ein Support-Bundle beantwortet vieles automatisch — trotzdem lohnt sich vorher ein kurzer Blick auf die naheliegendsten Stellen, oft ist die Ursache schneller lokal gelöst:

Anschluss