> For the complete documentation index, see [llms.txt](https://docs.pixeleyes.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.pixeleyes.de/anleitungen-instructions/deutsch/dokumentation-unserer-shopware-6-plugins/log-wachter-mit-ki-analyse-und-ticket-workflow.md).

# Log-Wächter mit KI-Analyse und Ticket-Workflow

## Was macht das Plugin?

Jeder Shopware-6-Shop schreibt laufend technische Meldungen in seine Log-Dateien (`var/log`). Dort verstecken sich Warnungen, Fehler und kritische Ausnahmen – oft hunderte Zeilen pro Tag, unübersichtlich und schwer zu bewerten. Wichtige Probleme gehen zwischen harmlosem Rauschen unter, und die Ursache (eigener Code, ein Drittanbieter-Plugin oder der Shopware-Core) ist nicht auf den ersten Blick erkennbar.

Der **Log-Wächter** nimmt Ihnen genau diese Arbeit ab:

* Er liest die Logs **automatisch** (stündlich per Cron) ein und fasst identische Fehler zu **einer** übersichtlichen Fehlergruppe zusammen.
* Er stuft jeden Fehler **rein per PHP – kostenlos** – als **gravierend**, **wiederkehrend** oder **harmlos** ein und leitet daraus bereits eine **konkrete Maßnahme** ab.
* Er ordnet jeden Fehler einer **Herkunft** zu (eigenes Plugin / Fremd-Plugin / Shopware-Core) und sagt Ihnen, **wer zuständig** ist.
* **Erst auf Knopfdruck** analysiert eine **KI** (Anthropic Claude oder OpenAI ChatGPT) einen einzelnen Fehler ausführlich – nie automatisch, nie im Hintergrund.
* Aus der Analyse erzeugt er auf Wunsch einen fertigen **Ticket-Text** für den Hersteller-Support (Fremd-Plugin) oder eine **Fix-Anleitung** (eigenes Plugin) – zum Kopieren.
* Er verschickt **E-Mail-Berichte** zu festen Zeiten und **Sofortmeldungen** bei gravierenden Fehlern.

## Das Grundprinzip: erst kostenlos, KI nur bei Bedarf

Der komplette Dauerbetrieb ist **kostenlos**: Scan, Einstufung, Gruppierung, Liste, Statistik, Berichte und Sofortmails laufen ausschließlich per PHP – **ohne** externe Dienste und **ohne** laufende Kosten.

Die **KI wird nie automatisch** aufgerufen. Kosten entstehen ausschließlich dann, wenn Sie bei einem konkreten Fehler aktiv auf **„Mit KI analysieren"** klicken oder einen **Ticket-Text / eine Fix-Anleitung** per KI erzeugen. So behalten Sie die volle Kontrolle über Aufwand und Budget (inkl. Monatsbudget-Sperre und Kostenanzeige in €).

## Funktionsüberblick

* **Dashboard** mit Verbindungsstatus/-test der KI-Anbieter, Verbrauch & Budget, Statistik und Wartung.
* **Fehlerliste** mit Gruppierung, farblicher Level-Kennzeichnung (Kritisch/Fehler/Warnung/Veraltet/Hinweis), Suche und Filter.
* **Detailseite** mit kostenloser **PHP-Analyse**, optionaler **KI-Analyse**, **Ticket-/Fix-Workflow** und der Übersicht **„Betroffene Stellen"**.
* **Zuordnungsliste**, in der die Herkunft je Verursacher gepflegt wird (mit geschützten Core-/Vendor-Einträgen).
* **Berichte & Sofortmails** inkl. Zuständigkeits-Empfehlung, Ruhetage-Takt und Sofortmail-Muster als Sicherheitsnetz.
* **Datenschutz (DSGVO):** personenbezogene Daten werden vor dem Speichern und vor dem Senden an die KI maskiert.
* Mehrsprachig; alle Texte sind über **Snippets** in der jeweiligen Sprache anpassbar.

## Wichtiger Hinweis (Standardinstallation)

{% hint style="warning" %}
Wir entwickeln und testen dieses Plugin auf Basis einer **Standard-Installation von Shopware 6**. Auf stark angepassten Systemen – etwa mit tiefgreifenden Core-Anpassungen, ungewöhnlichen Log-Konfigurationen, abweichender Verzeichnisstruktur, speziellen Mail-/Queue-Setups oder Konflikten mit anderen Plugins – kann das Verhalten abweichen. In solchen Fällen können wir eine einwandfreie Funktion nicht garantieren.
{% endhint %}

Das Plugin **liest** die Logs nur; es verändert oder löscht keine Log-Dateien (einzige Ausnahme: der bewusste Dev-Button „Log-Datei(en) leeren" mit Sicherheitsabfrage).

{% hint style="warning" %}
**KI-Nutzung & DSGVO:** Wird die KI-Analyse aktiv genutzt, wird die (maskierte) Fehlermeldung an den gewählten Anbieter (Anthropic bzw. OpenAI) übertragen und dort verarbeitet. Die Aktivierung erfolgt auf eigene Verantwortung; für die Übermittlung an den KI-Anbieter übernehmen wir keine Haftung. Bitte prüfen Sie die Vereinbarkeit mit Ihren Datenschutzvorgaben.
{% endhint %}

***

Die folgenden Kapitel führen Sie durch Installation, Einrichtung, alle Funktionen und die komplette Konfiguration.

© Pixeleyes GmbH · Support & Kontakt: <https://www.pixeleyes.de>