Plugin konfigurieren
Nach der Installation eines Plugins verwalten Sie es ueber Dashboard -> Einstellungen -> Plugins. Diese Seite listet jede Installation in Ihrem Subkonto mit ihrem Gesundheitszustand, ihrer Konfiguration und ihrem Audit-Protokoll auf.
Die Seite installierte Plugins
Jede Zeile zeigt:
| Spalte | Was es bedeutet |
|---|---|
| Plugin | Logo + Name + Version |
| Status | Aktiv, Deaktiviert, Fehlerhaft oder Wird deinstalliert |
| Letztes Ereignis | Zeitstempel der juengsten Webhook-Zustellung |
| 24h-Erfolgsrate | Prozentsatz der erfolgreichen Webhook-Versuche |
| Aktionen | Zahnradsymbol -> vollstaendiges Verwaltungspanel |
Status-Indikatoren
- Aktiv (gruen) - Installation ist gesund, Webhooks werden zugestellt, Token gueltig.
- Deaktiviert (grau) - Betreiber hat Webhook-Zustellung pausiert; Konfiguration beibehalten, Token noch gueltig.
- Fehlerhaft (Bernstein) - juengste Webhook-Zustellungen schlagen fehl; der Endpunkt des Anbieters ist wahrscheinlich offline.
- Wird deinstalliert (grau) - 30-Tage-Soft-Delete-Fenster laeuft; die Zeile wird entfernt, sobald es endet.
Ein Plugin, das 7 ununterbrochene Tage im Status Fehlerhaft bleibt, wird von Levy automatisch deaktiviert. Sie koennen es wieder aktivieren, sobald der Endpunkt des Anbieters wieder verfuegbar ist.
Konfiguration bearbeiten
Klicken Sie auf das Zahnradsymbol -> Konfigurieren. Dasselbe Formular, das Sie bei der Installation gesehen haben, oeffnet sich erneut mit Ihren aktuellen Werten vorausgefuellt. Speichern Sie Ihre Aenderungen und das Plugin verwendet die neue Konfiguration bei der naechsten Ereigniszustellung.
Sie muessen nicht deinstallieren und neu installieren, um eine Einstellung zu aendern. Haeufige Gruende fuer Konfigurationsaenderungen:
- Slack-Benachrichtigungen in einen anderen Kanal verschieben
- Den Schwellenwert von Captur.ai fuer Parkbewertungen verschaerfen oder lockern
- Aendern, welches BigQuery-Dataset den taeglichen Export empfaengt
- Einen API-Schluessel aktualisieren, nachdem ein Anbieter seinen rotiert hat
Vorruebergehend deaktivieren
Klicken Sie auf Deaktivieren, um die Webhook-Zustellung zu pausieren, ohne zu deinstallieren. Das Plugin bleibt in Ihrer Liste, die Konfiguration und das Token werden beibehalten, aber Levy stoppt das Senden von Ereignissen. Verwenden Sie dies fuer:
- Wartungsfenster auf Anbieterseite
- Untersuchung eines ueberlaufenden Alarmvolumens
- Pausieren von ereignisbasierten Abrechnungs-Plugins waehrend des Debuggens
Klicken Sie auf Aktivieren, um fortzufahren.
API-Token des Plugins rotieren
Plugins authentifizieren sich zurueck zu /api/plugin/v1/* mit einem Token im Format lvy_plg_<install-id-prefix>_<random>. Wenn Sie ein Leak des Tokens vermuten:
Installation oeffnen
Einstellungen -> Plugins -> Zahnradsymbol neben der Installation.
Klicken Sie auf Token rotieren
Ein neues Token wird sofort ausgestellt. Das alte Token tritt in einen 24-Stunden-Karenzzeitraum ein, in dem beide funktionieren - lange genug fuer den Anbieter, um zu wechseln.
Anbieter benachrichtigen
Senden Sie das neue Token ueber den Support-Kanal des Anbieters. Nach 24 Stunden funktioniert das alte Token nicht mehr.
Die Rotation wird im Plugin-Audit-Protokoll protokolliert.
Audit-Protokoll anzeigen
Klicken Sie auf das Zahnradsymbol -> Audit-Protokoll. Jede gegen diese Installation ausgefuehrte Aktion wird aufgezeichnet:
| Aktion | Protokolliert |
|---|---|
install | Erstinstallation mit Berechtigungen + Konfiguration |
configure | Jede Konfigurationsspeicherung |
disable / enable | Pausieren / Fortsetzen |
token_rotated | Token-Rotation |
webhook_sent | Jedes ausgehende Webhook (bei Skalierung gesampled) |
webhook_failed | Fehlgeschlagene Zustellung mit Antwortkoerper-Auszug |
uninstall | Endgueltige Deinstallation mit Grund |
Protokolle werden 18 Monate aufbewahrt und sind als CSV exportierbar.
Fehlgeschlagenes Webhook erneut versenden
Wenn eine Webhook-Zustellung fehlgeschlagen ist, der Endpunkt des Anbieters jedoch wieder verfuegbar ist, koennen Sie es manuell erneut versenden:
Audit-Protokoll oeffnen
Einstellungen -> Plugins -> Zahnrad -> Audit-Protokoll.
Fehlgeschlagenes Ereignis finden
Nach Aktion = webhook_failed filtern. Jede Zeile hat einen Erneut versenden-Button.
Erneut versenden klicken
Das Ereignis wird sofort an den Anbieter erneut gesendet. Das Ergebnis wird als neue Audit-Zeile aufgezeichnet.
Sie haben ein 7-Tage-Replay-Fenster ab der urspruenglichen Ereigniszeit.
Deinstallieren
Klicken Sie im Zahnradmenue auf Deinstallieren. Sie werden zur Bestaetigung aufgefordert. Bei Bestaetigung:
- Das API-Token des Plugins wird sofort widerrufen.
- Webhook-Abonnements werden pausiert.
- Die Konfiguration tritt in ein 30-Tage-Soft-Delete-Fenster ein - wenn Sie innerhalb dieses Fensters neu installieren, kehrt Ihre Konfiguration zurueck.
- Der Anbieter erhaelt ein Loeschungs-Webhook, damit er seine Kopie Ihrer Daten loeschen kann (wichtig fuer die DSGVO-Konformitaet).
- Eine
uninstall-Audit-Zeile wird geschrieben.
Kostenpflichtige Abonnements werden in Stripe gekuendigt; Sie werden nur fuer die Nutzung bis zum Deinstallationszeitstempel berechnet.
Was kommt als naechstes
- Plugin-Abrechnung - wie Belastungen funktionieren
- Fehlerbehebung - Fehler diagnostizieren