> 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/english/documentation-of-our-shopware-6-plugins/log-watch-with-ai-analysis-and-ticket-workflow/readme.md).

# README

## What does the plugin do?

Every Shopware 6 shop constantly writes technical messages to its log files (`var/log`). Warnings, errors and critical exceptions hide in there—often hundreds of lines per day—hard to scan and hard to judge. Important problems drown in harmless noise, and the origin (your own code, a third-party plugin, or the Shopware core) is not obvious at a glance.

The **Log watch** takes exactly this work off your hands:

* It reads the logs **automatically** (hourly via cron) and merges identical errors into **one** clear error group.
* It rates every error **using plain PHP—for free**—as **serious**, **recurring**, or **harmless**, and already derives a **concrete action** from it.
* It assigns each error an **origin** (own plugin / third-party plugin / Shopware core) and tells you **who is responsible**.
* **Only on demand** does an **AI** (Anthropic Claude or OpenAI ChatGPT) analyse a single error in detail—never automatically, never in the background.
* From the analysis, it optionally generates a ready-to-send **ticket text** for the vendor's support (third-party plugin) or a **fix guide** (your own plugin)—ready to copy.
* It sends **email reports** at fixed times and **instant alerts** for serious errors.

## The core principle: free first, AI only when needed

The entire day-to-day operation is **free**: scanning, rating, grouping, list, statistics, reports, and instant mails run purely via PHP—**without** external services and **without** ongoing cost.

The **AI is never called automatically**. Costs only arise when you actively click **"Analyse with AI"** on a specific error or generate a **ticket text / fix guide** via AI. This keeps you in full control of effort and budget, including a monthly budget lock and cost display in €.

## Feature overview

* **Dashboard** with connection status/test for the AI providers, usage & budget, statistics, and maintenance.
* **Error list** with grouping, coloured level indication (Critical/Error/Warning/Deprecated/Notice), search, and filter.
* **Detail page** with a free **PHP analysis**, an optional **AI analysis**, the **ticket/fix workflow**, and the **"Affected locations"** overview.
* **Mapping list** where the origin per causer is maintained, with protected core/vendor entries.
* **Reports & instant mails** including a responsibility recommendation, a quiet-days cadence, and instant-mail patterns as a safety net.
* **Data protection (GDPR):** personal data is masked before storing and before sending to the AI.
* Multilingual; all texts can be adjusted per language via **snippets**.

{% hint style="warning" %}

## Important note (standard installation)

We develop and test this plugin on the basis of a **standard Shopware 6 installation**. On heavily customised systems—e.g. with deep core modifications, unusual log configurations, a different directory structure, special mail/queue setups, or conflicts with other plugins—the behaviour may differ. In such cases, we cannot guarantee flawless operation.
{% endhint %}

The plugin only **reads** the logs; it does not modify or delete any log files. The only exception is the deliberate dev button **"Clear log file(s)"** with a safety prompt.

{% hint style="warning" %}
**AI use & GDPR:** When the AI analysis is actively used, the masked error message is transmitted to and processed by the selected provider (Anthropic or OpenAI). Enabling this is at your own responsibility; we accept no liability for the transmission to the AI provider. Please check compatibility with your data protection requirements.
{% endhint %}

The following chapters guide you through installation, setup, all features, and the complete configuration.

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