> ## Documentation Index
> Fetch the complete documentation index at: https://storekit.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Audit-Log

> Verfolgen Sie Mitarbeiteraktionen in storekit mit durchsuchbarem, exportierbarem Audit-Log: Wer hat was, wann und von wo geändert und war erfolgreich.

Das Audit-Log gibt Ihnen einen manipulationssicheren Verlauf der Aktionen, die Ihre Mitarbeiter in Ihrem Konto durchführen: wer hat was getan, an welcher Ressource, von wo aus, und ob es erfolgreich war. Nutzen Sie es, um Änderungen zu untersuchen, Compliance-Anforderungen zu erfüllen und Fragen zu beantworten wie "Wer hat diese Bestellung storniert?" oder "Wann wurde dieser Menüartikel aktualisiert?".

<Info>
  Das Audit-Log ist auf **Kontoinhaber und Admins** beschränkt. Mitarbeiter mit anderen Rollen sehen beim Versuch, es zu öffnen, eine "restricted"-Meldung.
</Info>

## Wo Sie es finden

<Steps>
  <Step title="Reports öffnen">
    Gehen Sie im Dashboard zu **Reports → Logs**.
  </Step>

  <Step title="Audit-Log öffnen">
    Wählen Sie im Abschnitt **Security** die Option **Audit Log**.
  </Step>

  <Step title="Suchen und filtern">
    Die neuesten Ereignisse werden automatisch geladen. Grenzen Sie die Ergebnisse mit Filtern ein oder exportieren Sie, was Sie sehen, als CSV.
  </Step>
</Steps>

## Was aufgezeichnet wird

Jeder Eintrag erfasst den vollständigen Kontext einer einzelnen Mitarbeiteraktion:

| Dimension    | Was er Ihnen sagt                                                                      |
| ------------ | -------------------------------------------------------------------------------------- |
| **Time**     | Wann die Aktion stattgefunden hat (erfasst im Moment der Aktion, nicht beim Speichern) |
| **Actor**    | Der Mitarbeiter – Name, E-Mail und Rolle zum Zeitpunkt                                 |
| **Action**   | `create`, `update`, `delete`, `read` oder `export`                                     |
| **Resource** | Die Art der betroffenen Sache (z. B. `order`, `menu`, `discount`) und deren ID         |
| **Store**    | Die Location, auf die sich die Aktion bezieht, falls zutreffend                        |
| **Outcome**  | Ob die Anfrage erfolgreich war, plus HTTP-Status                                       |

Das Auswählen einer Zeile erweitert ein Detailfenster mit der Anfragemethode, dem Pfad, der Route, IP-Adresse, User-Agent, Request-ID und Trace-ID sowie dem Fehlertyp bei fehlgeschlagenen Aktionen.

### Welche Aktionen protokolliert werden

* **Alle Änderungen** werden aufgezeichnet – alles, was Daten erstellt, aktualisiert oder löscht (einschließlich Aktionen wie Archivieren, Stornieren, Wiederherstellen oder Veröffentlichen).
* **Sensitive Reads** werden aufgezeichnet – Anzeigen oder Herunterladen von Berichten, Exporten, Rechnungen und Abrechnungen. Das Öffnen des Audit-Logs selbst wird als `read` aufgezeichnet, und das Exportieren wird als `export` aufgezeichnet.
* **Routinemäßige Reads** (Durchsuchen von Listen, Öffnen von Detailansichten, Hintergrund-Polling) werden **nicht** aufgezeichnet, damit das Log auf sinnvolle Aktivitäten fokussiert bleibt.

<Note>
  Aktionen von Kunden, die Bestellungen aufgeben, und von API-Schlüsseln liegen außerhalb des Umfangs des Audit-Logs – es konzentriert sich auf **Mitarbeiteraktionen** im Dashboard.
</Note>

## Suchen und Filtern

Das Audit-Log verwendet eine facettenbasierte Suchleiste. Fügen Sie einen oder mehrere Filter hinzu und klicken Sie auf **Apply**; aktive Filter erscheinen als entfernbare Pillen. Verfügbare Facetten:

| Filter            | Beschreibung                                                                   |
| ----------------- | ------------------------------------------------------------------------------ |
| **Action**        | Auf `create`, `update`, `delete`, `read` oder `export` beschränken             |
| **Outcome**       | Nur erfolgreiche oder nur fehlgeschlagene Aktionen anzeigen                    |
| **Resource type** | z. B. `order`, `menu`, `product`, `discount`                                   |
| **Resource ID**   | ID eines bestimmten Datensatzes                                                |
| **Actor**         | Ein bestimmter Mitarbeiter                                                     |
| **Store**         | Eine oder mehrere Locations (auf Stores beschränkt, auf die Sie Zugriff haben) |

Standardmäßig zeigt das Log die letzten **30 Tage**. Ergebnisse sind paginiert – verwenden Sie **Load more**, um ältere Ereignisse abzurufen. Sie können alles mit **Clear all** löschen.

<Tip>
  Kombinieren Sie Facetten, um einen Vorfall einzugrenzen – filtern Sie zum Beispiel nach **Actor** und **Action: delete**, um alles zu sehen, was ein bestimmter Benutzer entfernt hat.
</Tip>

## Nach CSV exportieren

Klicken Sie auf **Export**, um die aktuell gefilterten Ergebnisse als CSV-Datei herunterzuladen (mit denselben Filtern und demselben Datumsbereich). Dies ist praktisch, um sie mit Auditoren zu teilen oder außerhalb von storekit zu archivieren.

<Info>
  Exporte sind auf 50.000 Zeilen begrenzt. Wenn Sie das Limit erreichen, grenzen Sie den Datumsbereich ein oder fügen Sie Filter hinzu und exportieren Sie in kleineren Chargen.
</Info>

## Datenschutz und Datenverarbeitung

Das Audit-Log ist so konzipiert, dass es **aufzeichnet, was sich geändert hat, ohne sensible Inhalte zu erfassen**:

* Es speichert die **Namen der Felder**, die an einer Änderung beteiligt waren (z. B. "price, availability") – niemals die tatsächlich übermittelten Werte.
* Feldnamen, die sensibel aussehen (Passwörter, Tokens, Schlüssel, Kartendetails, PINs und ähnliches), werden **automatisch verworfen** und niemals aufgezeichnet.
* Datensätze sind **append-only**: Einträge werden niemals bearbeitet oder einzeln gelöscht, damit die Historie vertrauenswürdig bleibt.

## Aufbewahrung

Audit-Einträge werden standardmäßig **30 Tage** aufbewahrt. Enterprise-Konten können eine längere Aufbewahrungsfrist anfordern.

<AccordionGroup>
  <Accordion title="Wer kann das Audit-Log sehen?">
    Nur Kontoinhaber und Admins. Andere Mitarbeiterrollen können es nicht anzeigen oder exportieren.
  </Accordion>

  <Accordion title="Warum sehe ich keine routinemäßigen Seitenaufrufe?">
    Das Log zeichnet absichtlich nur Änderungen und Sensitive Reads (Berichte, Exporte, Rechnungen, Abrechnungen) auf. Alltägliches Durchsuchen und Hintergrundanfragen werden ausgeschlossen, damit das Log auf sinnvolle Aktivitäten fokussiert bleibt.
  </Accordion>

  <Accordion title="Speichert das Log die Daten, die ich geändert habe?">
    Nein. Es zeichnet auf, welche Felder an einer Änderung beteiligt waren, aber nicht die übermittelten Werte. Sensible Feldnamen werden vollständig verworfen.
  </Accordion>

  <Accordion title="Wie weit zurück kann ich schauen?">
    Einträge werden standardmäßig 30 Tage aufbewahrt. Wenn Sie eine längere Aufbewahrung für Compliance benötigen, [kontaktieren Sie unser Team](/docs/de/getting-started/contact-support).
  </Accordion>

  <Accordion title="Kann ich das gesamte Log exportieren?">
    Sie können die gefilterten Ergebnisse exportieren, bis zu 50.000 Zeilen pro Export. Für größere Bereiche teilen Sie den Export in kleinere Zeitfenster auf.
  </Accordion>
</AccordionGroup>


## Related topics

- [Integrationen – Übersicht](/docs/de/guides/integrations/overview.md)
- [Log blockierter Bestellungen: abgelehnte Kassenversuche überprüfen](/docs/de/guides/orders/advanced/blocked-orders.md)
- [PLU-Mapping-Leitfaden](/docs/de/guides/integrations/pos/advanced/plu-mapping.md)
- [Webhooks testen](/docs/de/developers/webhooks/testing-webhooks.md)
- [Sicherheitsrichtlinie](/docs/de/privacy-security/security-policy.md)