docs/getting-started/Dashboard-Übersicht

Dashboard-Übersicht

Dashboard Übersicht

Das KiroCloud Bot-Dashboard ist die zentrale Schaltzentrale für die Steuerung, Überwachung und Konfiguration deiner Discord-Bots. Dank moderner WebSocket-Technologie und einer responsiven Benutzeroberfläche behältst du den aktuellen Status, Server-Metriken und Live-Logs jederzeit latenzfrei im Blick.


1. Bot-Status & Schnellaktionen (Quick Actions)

Im oberen Bereich des Dashboards findest du die wichtigsten Kontroll- und Statusanzeigen deines Bots:

  • Status-Badge:
    • Online (Grün): Der Bot ist mit dem Discord-Gateway verbunden und verarbeitet Events.
    • Offline (Grau): Der Bot ist gestoppt und verbraucht keine Ressourcen.
    • Starting (Gelb): Der Bot initialisiert Module und stellt die Gateway-Verbindung her.
    • Error (Rot): Beim Starten ist ein Fehler aufgetreten (z. B. ungültiger Token oder fehlende Intents).
  • Steuerungs-Buttons:
    • Starten: Fährt den Bot-Container hoch und stellt die Discord-Verbindung her.
    • Stoppen: Beendet den Bot-Prozess sicher.
    • Neustarten: Führt einen Warm-Restart durch, um geänderte Einstellungen oder Module neu zu laden.
  • Server-Info: Zeigt das verbundene Discord-Guild-Icon, den Servernamen und die Bot-Client-ID an.

!TIP Die meisten Moduländerungen (wie Ticket-Texte oder Willkommensnachrichten) werden dank unseres dynamischen Config-Cachings in Echtzeit übernommen, ohne dass ein Bot-Neustart erforderlich ist!


2. Ressourcen-Monitoring & Telemetrie

KiroCloud überwacht die Performance deines Bots kontinuierlich und stellt die Metriken in übersichtlichen Widgets dar:

MetrikBeschreibungEmpfohlener Richtwert
CPU-Auslastung (%)Aktuelle Prozessor-Nutzung des Bot-ProzessesUnter 15% im Normalbetrieb
RAM-Nutzung (MB / %)Belegter Arbeitsspeicher der isolierten Node.js-LaufzeitTypisch 60–250 MB (je nach Servergröße)
Gateway Ping (ms)Latenzzeit zwischen KiroCloud und den Discord-WebSocket-Servern10–60 ms
Commands ExecutedGesamtzahl der erfolgreich ausgeführten Slash- und Chat-BefehleStatistischer Zähler

!NOTE Sollte der RAM-Verbrauch deines Bots ungewöhnlich stark ansteigen, prüfe bitte aktive Caches oder Bild-Generierungsfunktionen in benutzerdefinierten Modulen.


3. Integriertes Live-Terminal & Log-Viewer

Über das WebSocket-gestützte Live-Terminal (basierend auf Xterm.js) kannst du die Konsole deines Bots in Echtzeit verfolgen:

  • Latenzfreies Streaming: Logs werden per WebSocket direkt vom Backend an den Browser gepusht.
  • Historie: Die letzten 500 Log-Einträge bleiben im Buffer gespeichert und stehen auch nach einem Tab-Wechsel bereit.
  • Farbcodierte Log-Level:
    • \x1b[36m INFO (Cyan): Allgemeine System- und Startmeldungen.
    • \x1b[33m WARN (Gelb): Warnungen (z. B. Rate-Limit Annäherungen, fehlende optionale Berechtigungen).
    • \x1b[31m ERROR (Rot): Kritische Fehler und unhandled Exceptions.
    • \x1b[32m CMD (Grün): Ausgeführte Benutzer-Befehle und Interaktionen.
    • \x1b[35m EVT (Magenta): Discord-Gateway-Events (z. B. Member Join, Channel Create).

4. Modul-Verwaltung & Konfiguration

Über die Navigations-Tabs im Dashboard kannst du spezialisierte Module per Klick aktivieren und detailliert anpassen:

  • Tickets: Vollständiges Support-Ticket-System mit Dropdown-Kategorien, Claiming und Transcripts.
  • Verify (Verifikation): Schutz vor Raids durch Captcha-, Button- oder Minecraft-Account-Verifikation.
  • Welcome & Leave: Begrüßungs- und Verabschiedungsnachrichten mit dynamischem Embed-Builder.
  • AutoMod & Security: Automatischer Spam-Schutz, Anti-Invite-Filter, Caps-Sperre und Mass-Mention-Schutz.
  • Level & Coins: Community-Gamification mit XP-Tracking, Rängen und virtuellem Server-Shop.
  • Giveaways: Vollautomatische Gewinnspiele mit Reaktions-/Button-Teilnahme und Auslosung.
  • Custom Commands & Schedules: Eigene Textbefehle und automatisierte Cronjobs zu festen Uhrzeiten.

5. Server-Management & Bot-Schedules

  • Server-Übersicht: Sieh auf einen Blick, auf welchen Servern dein Bot autorisiert ist, und generiere maßgeschneiderte Einladungslinks.
  • Bot-Schedules (Cronjobs): Plane wiederkehrende Aufgaben – wie tägliche Ankündigungen, automatisches Bereinigen von temporären Kanälen oder periodische Statusmeldungen.
  • Team-Management: Teile den Dashboard-Zugriff mit deinen Teammitgliedern (Moderatoren oder Entwicklern), ohne deinen Bot-Token weitergeben zu müssen.
Cookie-Einstellungen

Wir verwenden Cookies, um deine Erfahrung zu verbessern und unsere Dienste optimal anzubieten. Du kannst deine Einstellungen jederzeit anpassen.

main/e609418