# 3. Konfiguration

Die Plugin-Konfiguration finden Sie unter **Erweiterungen → Meine Erweiterungen → Admin Aktivitätsprotokoll → Konfigurieren**.

![Plugin-Konfigurationsseite mit Entitätsauswahl, Aufbewahrungszeitraum und Systemaktionen-Toggle](https://2916094232-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LtiS3-dzuXFp_IH7yRw-887967055%2Fuploads%2Fgit-blob-8382ea167b06943d7b4b895e4c69b340e135c693%2F5.png?alt=media)

## Überwachte Entitäten

| Einstellung             | Wert                                               |
| ----------------------- | -------------------------------------------------- |
| Konfigurationsschlüssel | `trackedEntities`                                  |
| Standardwert            | Produkte, Bestellungen, Kunden, Kategorien, Medien |
| Typ                     | Multi-Select                                       |

Wählen Sie aus, welche Entitätstypen im Aktivitätsprotokoll erfasst werden sollen. Änderungen an nicht ausgewählten Entitäten werden nicht protokolliert.

Verfügbare Entitätstypen:

* Produkte
* Bestellungen
* Kunden
* Kategorien
* Medien
* Hersteller
* Eigenschaften
* Versandmethoden
* Zahlungsmethoden
* Verkaufskanäle
* CMS-Seiten

**Hinweis:** Änderungen am Entitätsumfang wirken sich sofort auf neue Protokolleinträge aus – ohne Cache-Leerung oder Neustart. Bestehende Protokolleinträge für abgewählte Entitäten bleiben erhalten.

**Hinweis:** Statusübergänge bei Bestellungen, Lieferungen und Zahlungen werden automatisch erfasst, ohne dass Sie „Bestellungen" explizit in der Konfiguration auswählen müssen. Drittanbieter-Plugins können zusätzliche Entitäten registrieren – weitere Informationen finden Sie im Abschnitt [Erweiterung für Entwickler](https://docs.momocode.de/shopware-6/admin-aktivitaetsprotokoll/5.-erweiterung).

## Aufbewahrungszeitraum

| Einstellung             | Wert            |
| ----------------------- | --------------- |
| Konfigurationsschlüssel | `retentionDays` |
| Standardwert            | 90 Tage         |
| Typ                     | Single-Select   |

Legen Sie fest, wie lange Protokolleinträge aufbewahrt werden, bevor sie automatisch gelöscht werden.

| Option      | Beschreibung                                                      |
| ----------- | ----------------------------------------------------------------- |
| 30 Tage     | Einträge älter als 30 Tage werden täglich gelöscht                |
| 60 Tage     | Einträge älter als 60 Tage werden täglich gelöscht                |
| **90 Tage** | **Standard** – Einträge älter als 90 Tage werden täglich gelöscht |
| 180 Tage    | Einträge älter als 180 Tage werden täglich gelöscht               |
| 365 Tage    | Einträge älter als 365 Tage werden täglich gelöscht               |
| Unbegrenzt  | Keine automatische Löschung                                       |

Die Bereinigung erfolgt täglich durch einen Scheduled Task. Ältere Einträge inklusive der zugehörigen Feldänderungen werden dabei vollständig entfernt.

## Systemaktionen protokollieren

| Einstellung             | Wert               |
| ----------------------- | ------------------ |
| Konfigurationsschlüssel | `logSystemActions` |
| Standardwert            | aktiviert          |
| Typ                     | Boolean (Ja/Nein)  |

Steuert, ob Schreibvorgänge protokolliert werden, die durch folgende Quellen ausgelöst werden:

* CLI-Befehle (`bin/console`)
* Scheduled Tasks (geplante Aufgaben)
* API-Integrationen ohne angemeldeten Admin-Benutzer

**Aktiviert (Standard):** Alle Schreibvorgänge werden protokolliert, unabhängig von der Quelle. API-Integrationen erscheinen mit dem Integrationsnamen und einem „Integration"-Badge.

**Deaktiviert:** Nur Änderungen, die direkt von einem angemeldeten Admin-Benutzer ausgelöst werden, erscheinen im Protokoll.

**Hinweis:** Login-Ereignisse (MAAL-13) werden unabhängig von dieser Einstellung immer protokolliert.
