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

# Audit Logs

> Instanzweites Aktivitätsprotokoll – filtern, analysieren und exportieren.

Die Audit Logs protokollieren alle relevanten Aktionen auf Ihrer Localmind-Instanz. Sie dienen als zentrale Anlaufstelle für Compliance-Prüfungen, Sicherheitsanalysen und die Nachverfolgung von Änderungen.

<Warning>
  Audit Logs gibt es auf zwei Ebenen: Das **instanzweite Gesamtprotokoll** in den Instanz-Einstellungen erfordert **Instanz-Administrator-Rechte**. Zusätzlich sehen Org-Admins und Rollen mit der Berechtigung **Audit Logs → Lesen** die **Org-Ansicht** mit den Ereignissen ihrer eigenen Organisation (**Org-Einstellungen → Sicherheit**). Eine Übersicht aller Diagnose-Ansichten finden Sie unter [Observability](/administration/observability).
</Warning>

## Funktionen

<CardGroup cols={2}>
  <Card title="Filtern" icon="funnel">
    Grenzen Sie die Einträge gezielt ein – nach Zeitraum, Benutzer, Aktionstyp oder betroffener Ressource. So finden Sie relevante Ereignisse auch in großen Log-Beständen schnell.
  </Card>

  <Card title="CSV-Export" icon="file-spreadsheet">
    Exportieren Sie die gefilterten Ergebnisse als CSV-Datei für externe Auswertungen, Archivierung oder die Weitergabe an Compliance-Beauftragte.
  </Card>

  <Card title="Letzte Aktivitäten" icon="history">
    Schnellansicht der zuletzt protokollierten Ereignisse – ideal, um aktuelle Änderungen auf einen Blick zu erfassen, ohne erst Filter setzen zu müssen.
  </Card>

  <Card title="Top-Aktionen & Top-Ressourcen" icon="chart-bar">
    Zusammenfassende Widgets, die zeigen, welche Aktionen am häufigsten ausgeführt und welche Ressourcen am meisten aufgerufen wurden.
  </Card>
</CardGroup>

## Nachrichteninhalt in Logs

Audit Logs enthalten neben Metadaten (Benutzer, Zeitstempel, Aktionstyp, Ressource) auch den **eigentlichen Nachrichteninhalt** der protokollierten Ereignisse – etwa den Text einer gesendeten Chat-Nachricht. Das erhöht die Aussagekraft für Compliance- und Sicherheitsanalysen erheblich.

<Note>
  **Datenschutz-Implikation:** Da Audit Logs jetzt potenziell sensible Inhalte enthalten, sollten Org-Admins die Berechtigung **Audit Logs → Lesen** in [Org-](/settings/instance/Role-Templates) und [Space-Rollen](/settings/organization/Space-Rollen) bewusst und sparsam vergeben. Prüfen Sie regelmäßig, wer Zugriff auf die Logs hat, und stimmen Sie die Aufbewahrungsdauer mit Ihrer Datenschutzrichtlinie ab.
</Note>

## Aufbewahrungsdauer

Audit Logs werden **180 Tage** aufbewahrt (vor v1.0.0-beta.5: 30 Tage). Nach Ablauf werden Einträge automatisch entfernt. Stimmen Sie diese Dauer mit Ihrer Datenschutzrichtlinie ab — bei strengeren Anforderungen können Sie Logs vorab über den CSV-Export sichern.

*Geändert in v1.0.0-beta.5: Retention von 30 auf 180 Tage erhöht.*

## Detail-Ansicht

Klicken Sie auf einen einzelnen Audit-Log-Eintrag, um die **Detail-Ansicht** zu öffnen. Diese zeigt alle erfassten Felder eines Ereignisses in voller Tiefe – inklusive Nachrichteninhalt, betroffener Ressourcen-IDs, Benutzerkontext und technischer Metadaten. Die Ansicht ist insbesondere für forensische Analysen einzelner Vorfälle hilfreich, bei denen Sie über die Tabellenübersicht hinausgehen müssen.

## Identitätsanzeige und Statusindikator

Audit-Log-Einträge enthalten eine **verbesserte Identitätsanzeige**: Der auslösende Benutzer wird klarer und eindeutiger dargestellt, sodass Sie bei der Analyse schneller erkennen, wer ein Ereignis verursacht hat. Zusätzlich besitzt jeder Eintrag einen **Statusindikator pro Ereignis**, der auf einen Blick zeigt, ob die protokollierte Aktion erfolgreich war oder fehlschlug.

Beide Verbesserungen erleichtern die schnelle Durchsicht großer Log-Bestände, ohne dass Sie für jeden Eintrag die [Detail-Ansicht](#detail-ansicht) öffnen müssen.

<Info>
  Eingeführt in [Localmind 1.0.0-beta.7](/changelog/v1.0.0-beta.7).
</Info>

## CSV-Export

Der CSV-Export erfasst jetzt **alle Felder eines Audit-Log-Eintrags**, einschließlich Nachrichteninhalt und Detail-Metadaten. Das macht den Export geeignet für externe Compliance-Reviews, Archivierung in Drittsystemen und Offline-Auswertungen.

<Steps>
  <Step title="Filter setzen">
    Schränken Sie die Ergebnisse zuerst auf den relevanten Zeitraum, Benutzer oder Aktionstyp ein. Ein ungefilterter Vollexport kann sehr große Dateien erzeugen.
  </Step>

  <Step title="Export starten">
    Klicken Sie auf **CSV-Export**. Die aktuell sichtbare, gefilterte Auswahl wird exportiert.
  </Step>

  <Step title="Datei sichern">
    Speichern Sie die Datei in einem zugriffsgeschützten Ablagesystem. Da der Export potenziell sensible Nachrichteninhalte enthält, gelten dieselben Datenschutzanforderungen wie für die Logs selbst.
  </Step>
</Steps>

## Aktualisierung

Die Audit Logs können über den **Refresh-Button** manuell aktualisiert werden, um die neuesten Einträge nachzuladen.