Audit-Log
Wo du nachliest, wer wann was in deiner Organisation geändert hat, wer sich angemeldet hat, was über Webhooks und die REST-API gelaufen ist und welche Integrations-Accounts Probleme hatten, samt Filtern, Details und Export.
Unter Organisation › Audit-Log liest du nach, was in deiner Organisation passiert ist. Du siehst, wer wann welche Einstellung geändert hat und wer sich angemeldet hat. Außerdem siehst du, was über Webhooks und die REST-API gelaufen ist und wo es bei den Integrations-Accounts Probleme gab. Jeder Eintrag nennt den Zeitpunkt und lässt sich per Klick im Detail öffnen.
Kurz erklärt
Das Audit-Log besteht aus sechs Protokollen in drei Gruppen (Einstellungen, Login und Meldungen, Webhooks und API, Accounts). Jedes hat eigene Spalten und Filter. Anmeldungen und Änderungen an Einstellungen werden immer protokolliert. Einstellen lässt sich nur, wie lange die Einträge aufbewahrt werden. Das geht unter Organisation › Einstellungen › Organisation › Audit-Log.
Typische Aufgaben unter Organisation › Audit-Log:
- Jemand hat eine Einstellung geändert, und du willst wissen, wer: Herausfinden, wer eine Einstellung geändert hat.
- Du suchst einen bestimmten Eintrag: Einen Eintrag finden.
- Eine Prüfung verlangt einen Nachweis: Ein Protokoll exportieren.
- Ein Kollege bekommt die Anmelde-Mail nicht: Ein Kollege hat den Anmelde-Code oder die Passwort-Mail nicht bekommen.
Voraussetzungen
- Deine Benutzerrolle braucht das Recht Audit-Log. Im Rollen-Editor ist das die Zeile Audit-Log im Block Organisation. Fehlt es, erscheint der Menüpunkt Audit-Log gar nicht.
- Zum Ändern der Aufbewahrungszeit brauchst du das Recht Einstellungen (Zeile Einstellungen im Block Organisation). In seinen Detail-Rechten brauchst du außerdem im Abschnitt Organisation den Schalter Bereich aktiv und im Auswahlfeld Audit-Log mindestens Lesen + Bearbeiten.
Welche Protokolle es gibt
Links wählst du das Protokoll, das die Tabelle zeigt. Die Protokolle stehen in drei Gruppen:
Organisation
| Protokoll | Inhalt |
|---|---|
| Einstellungen | Protokoll der Änderungen an den Organisations-Einstellungen. Dazu zählen auch Mitglieder und Module |
| Login | Anmeldungen, 2FA, Passwort- und Profiländerungen der Org-Mitglieder |
| Meldungen | Anzeigen, Aufschübe und persönliche Bestätigungen von Meldungen |
Entwickler
| Protokoll | Inhalt |
|---|---|
| Webhooks | Ausgehende Webhook-Zustellungen an externe URLs |
| API | Eingehende Aufrufe der REST-API (v3) |
Integrationen
| Protokoll | Inhalt |
|---|---|
| Accounts | Auth-Prüfungen der Integrations-Accounts: Fehler, Ausfälle und Wiederherstellungen |
Beim Öffnen von Organisation › Audit-Log ist das Protokoll Einstellungen vorausgewählt. Jedes Protokoll hat eigene Spalten:
| Protokoll | Spalten |
|---|---|
| Einstellungen | Zeitpunkt, Benutzer, Aktion, Bereich, Objekt-ID, IP-Adresse |
| Login | Zeitpunkt, Benutzer, Aktion, Methode, Status, Gerät, IP-Adresse |
| Meldungen | Zeitpunkt, Meldung, Empfänger, Ereignis |
| Webhooks | Zeitpunkt, Trigger, Methode, Ziel, Status, Versuch, Dauer, Request-ID |
| API | Zeitpunkt, Methode, Pfad, Status, Dauer, Token (Name des API-Tokens, darunter klein seine Beschreibung), IP-Adresse, Request-ID |
| Accounts | Zeitpunkt, Account, Anbieter, Aktion (Auth-Prüfung oder Revalidierung), Status, Auslöser (Manuell oder Automatisch) |
Im Protokoll Accounts steht in der Spalte Account der Name des Accounts. Ist der Account inzwischen gelöscht, steht dort der Name des Anbieters. Protokolliert werden dort nur Auffälligkeiten und die Rückkehr eines fehlerhaften Accounts zu einer funktionierenden Verbindung. Auffälligkeiten sind etwa abgelehnte Zugangsdaten oder ein nicht erreichbarer Anbieter. Erfolgreiche Routineprüfungen erscheinen nicht. Die Accounts selbst verwaltest du unter Accounts.
Jedes Protokoll ist nach Zeitpunkt vorsortiert, neueste zuerst. Ein Klick auf eine andere Spaltenüberschrift sortiert danach.
Im Protokoll Meldungen zeigen die Details den angezeigten Inhalt und bei einer Bestätigung auch die Checkbox-Texte und Antworten. Angezeigt belegt allein noch kein Lesen. Die Meldungen legst du unter Organisation › Einstellungen › Organisation › Meldungen an. Ihre Aufbewahrungsfrist steht separat unter Organisation › Einstellungen › Organisation › Audit-Log › Meldungen.
Einen Eintrag finden
- Öffne Organisation › Audit-Log und wähle links das Protokoll.
- Grenze die Einträge mit der Leiste über der Tabelle ein:
- Suchen… durchsucht die bereits geladenen Zeilen in allen sichtbaren Spalten. Ein Datum in der Schreibweise der Spalte Zeitpunkt, zum Beispiel 28.08.2026, findet die Suche nicht. Dafür gibt es den Zeitraum-Filter.
- Der Filter daneben gehört zum jeweiligen Protokoll (siehe Tabelle unten).
- Der Filter ganz rechts steht auf Gesamter Zeitraum und lässt sich auf Letzte 7 Tage, Letzte 30 Tage oder Letzte 90 Tage umstellen.
- Klicke auf eine Spaltenüberschrift, um danach zu sortieren.
Welchen eigenen Filter ein Protokoll mitbringt:
| Protokoll | Filter |
|---|---|
| Einstellungen | Alle Aktionen: Erstellt, Geändert, Gelöscht, Dupliziert, Neu generiert, Deaktiviert, Erneut gesendet, Secret angezeigt, Secret rotiert |
| Login | Alle Status: Erfolg, Fehlgeschlagen, Blockiert |
| Meldungen | Alle Ereignisse: Zugeordnet, Angezeigt, Bestätigt, Aufgeschoben, Geschlossen |
| Webhooks | Alle: Erfolg, Fehlgeschlagen |
| API | zwei Filter, Alle Methoden mit GET, POST, PUT, PATCH, DELETE und Alle mit 2xx OK, 4xx Fehler, 5xx Fehler |
| Accounts | Alle Status: Abgelehnt, Vorübergehend, Hängt fest, Wiederhergestellt |
Wechselst du links das Protokoll, werden Suche, Filter und Zeitraum zurückgesetzt, und ein offener Detailbereich schließt sich. Gibt es keine passenden Einträge, steht in der Tabelle „Keine Protokoll-Einträge“.
Zeitraum und Protokoll-Filter wirken auf alle gespeicherten Einträge, das Suchfeld nur auf die bereits geladenen Zeilen. Die Tabelle lädt zuerst die neuesten 200 Einträge und weitere im Hintergrund nach, je Ansicht höchstens 50.000. Einen Hinweis, dass die Grenze erreicht ist, gibt es nicht. Ältere Einträge eines sehr großen Protokolls erreichst du deshalb nur, indem du zuerst mit Zeitraum und Filter eingrenzt.
Details zu einem Eintrag ansehen
- Öffne Organisation › Audit-Log und wähle links das Protokoll.
- Klicke auf die Zeile, die dich interessiert.
Es öffnet sich ein Detailbereich mit den Daten des Eintrags.
In der Kopfzeile des Detailbereichs steht eine Kurzbezeichnung und darunter der Zeitpunkt. Bei Einstellungen lautet die Kurzbezeichnung etwa Deaktiviert · Mitglieder. Bei Accounts nennt sie Status und Account, zum Beispiel Abgelehnt · <Account>. Es folgt der Inhalt als schreibgeschützter Datenblock detail. Das Kopier-Symbol rechts in dessen Kopfzeile (JSON kopieren) legt den ganzen Block in die Zwischenablage.
Was im Datenblock steht, hängt vom Protokoll ab:
| Protokoll | Inhalt des Datenblocks |
|---|---|
| Einstellungen | Werte vor und nach der Änderung |
| Login | Schritt, Status, Anmeldeverfahren, Gerät und Browser, Sitzungskennung, dazu Fehlercode und Fehlermeldung, falls es einen gab |
| Webhooks | Anfrage und Antwort: Ziel-URL, Kopfzeilen, Inhalt, Statuscode und Fehlermeldung. Die Werte der gesendeten Kopfzeilen sind als *** ausgeblendet, damit keine Zugangsdaten im Protokoll stehen |
| API | Angaben zur Anfrage: Token, Route, Parameter, Kopfzeilen, Statuscode und Fehlermeldung. Die Antwort selbst wird nicht mitprotokolliert |
| Accounts | Prüfschritt, Status, Fehlercode und Fehlermeldung, Auslöser, Kennungen von Account und Integration, Anbieter, Accountinhaber und weitere Angaben zur Prüfung |
Bei Einträgen aus Login steht über dem Datenblock der Kasten Standort (IP-Geo) mit Ort, Region und Land, dazu der Anbieter, wenn er bekannt ist. i-Planner leitet diesen Wert beim Klick grob aus der IP-Adresse ab. Lässt sie sich nicht zuordnen, bleibt der Kasten weg. Lässt sich der Eintrag nicht nachladen, erscheint „Details konnten nicht geladen werden“. Klicke die Zeile dann erneut an.
Oben im Detailbereich schaltest du über die Symbole zwischen Layer-Modus und Dock-Modus um. Das X mit dem Hinweis Detailbereich ausblenden schließt ihn wieder.
Herausfinden, wer eine Einstellung geändert hat
Öffne Organisation › Audit-Log, bleibe links beim Protokoll Einstellungen und suche die Zeile. Die Spalte Bereich nennt den betroffenen Bereich, zum Beispiel Mitglieder, API-Tokens oder Webhooks. Aktion sagt, was passiert ist, und Benutzer, wer es war. Ein Klick auf die Zeile zeigt im Detailbereich die geänderten Werte.
Ein Protokoll exportieren
- Öffne Organisation › Audit-Log und wähle links das Protokoll.
- Setze Suche, Filter und Zeitraum so, wie der Export aussehen soll.
- Klicke rechts in der Leiste über der Tabelle auf die Export-Schaltfläche (das Drucker-Symbol).
- Wähle Als Excel (XLSX), Als CSV, Als JSON oder Als PDF.
Der Export enthält genau das, was du siehst: die sichtbaren Spalten in der aktuellen Reihenfolge und die aktuell gefilterten und sortierten Zeilen. Die Datei heißt audit-log mit der Endung des gewählten Formats.
Aufbewahrungszeit ändern
Wie lange die Einträge aufbewahrt werden, bevor sie automatisch gelöscht werden, stellst du nicht unter Organisation › Audit-Log ein. Das geht unter Organisation › Einstellungen › Organisation › Audit-Log. Dort gibt es für die Protokolle vier Einstellungen. Audit-Log gilt für die Protokolle Einstellungen, Login und Accounts, Meldungen für Meldungen, Webhook-Deliveries für Webhooks und API-Requests für API. Die fünfte, Mitteilungszentrale, gilt für die Mitteilungen in der Glocke. Wie lange du höchstens aufbewahren kannst, begrenzt die gebuchte Version. Die Fristen, die Obergrenzen und die Voreinstellung stehen auf der Seite Audit-Log unter Einstellungen.
Der Menüpunkt „Audit-Log“ fehlt
Deiner Benutzerrolle fehlt das Recht Audit-Log. Eine Person mit Administrator-Rolle kann es dir unter Organisation › Einstellungen › Team & Rollen › Benutzerrollen im Block Organisation geben. Ohne dieses Recht verschwindet der Menüpunkt vollständig. Auch wenn du die Seite direkt aufrufst, weist i-Planner dich mit „Keine Berechtigung für das Audit-Log.“ ab.
Ein alter Eintrag fehlt
Fehlt ein alter Eintrag im Audit-Log, gibt es drei mögliche Gründe. Erstens kann der Eintrag älter sein als die Aufbewahrungszeit, die unter Organisation › Einstellungen › Organisation › Audit-Log eingestellt ist. Dann wurde er gelöscht. Zweitens lädt die Tabelle je Ansicht höchstens 50.000 Einträge, und zwar ohne Hinweis. Bei sehr großen Protokollen fehlt dann der ältere Rest. Drittens durchsucht das Suchfeld nur die geladenen Zeilen. Grenze deshalb zuerst mit dem Zeitraum und dem Filter ein und suche dann.
Die Anmeldung eines Kollegen fehlt im Protokoll „Login“
Das Protokoll Login zeigt nur, was unter dieser Organisation passiert ist. Ist der Kollege in mehreren Organisationen Mitglied, bleiben seine Anmeldungen in einer anderen Organisation auch dort. Prüfe außerdem den Status-Filter. Steht er auf Erfolg, sind fehlgeschlagene und blockierte Versuche ausgeblendet.
Ein Kollege hat den Anmelde-Code oder die Passwort-Mail nicht bekommen
Öffne Organisation › Audit-Log, wechsle links auf Login und klicke den passenden Eintrag an. Bei Mails, die zur Anmeldung gehören, steht im Detailbereich unter delivery der Zustellstatus. Zur Anmeldung gehören die Mails mit dem Bestätigungscode, zur Bestätigung eines neuen Geräts und zum Zurücksetzen des Passworts. Der Zustellstatus lautet etwa zugestellt, unzustellbar, als Spam gemeldet oder Zustellnachweis fehlt, dazu kommen Empfängeradresse und Zeitpunkt. Für die Einladungs-Mail und den Login-Link aus Organisation › Team wird kein Zustellstatus protokolliert. Dort hilft nur, die Mail über das Drei-Punkte-Menü der Person erneut zu senden.
Häufige Fragen
Nein. Anmeldungen und Änderungen an Einstellungen werden immer protokolliert. Einstellbar ist nur, wie lange die Einträge aufbewahrt werden. Das geht unter Organisation › Einstellungen › Organisation › Audit-Log.
Ja. Das Protokoll Login zeigt die Ereignisse selbst, nicht die aktuelle Mitgliederliste. Einträge von ausgeschiedenen oder deaktivierten Mitgliedern bleiben deshalb sichtbar.
Den Eintrag System in der Spalte Benutzer gibt es im Protokoll Einstellungen. Er steht dort, wenn zu einem Eintrag kein Benutzerkonto hinterlegt ist. Das ist zum Beispiel der Fall, wenn das Mitglied, das die Änderung gemacht hat, inzwischen endgültig gelöscht wurde. Endgültig gelöscht wird ein Mitglied über Mitglied löschen auf seiner Detailseite unter Organisation › Team. Seine Einträge bleiben dann erhalten, aber die Verknüpfung zu seinem Benutzerkonto wird entfernt.
Aufrufe der REST-API weisen sich mit einem API-Token aus, nicht mit einem Benutzerkonto. Deshalb zeigt das Protokoll API statt einer Benutzer-Spalte die Spalte Token mit dem Namen des verwendeten Tokens. Ein – bedeutet, dass der Aufruf keinem Token deiner Organisation zugeordnet werden konnte.
Die Spalte Objekt-ID im Protokoll Einstellungen zeigt die interne Kennung des Datensatzes, den die Aktion betroffen hat. Meist ist das eine Nummer, manchmal eine lange Zeichenfolge. Sie hilft, mehrere Einträge zum selben Objekt zusammenzubringen. Bei Änderungen ohne einzelnen Datensatz bleibt sie leer.
Weitere Themen
- Audit-Log unter Einstellungen: die Aufbewahrungszeit der Protokolle einstellen.
- Accounts: die Integrations-Accounts, deren Prüfungen das Protokoll Accounts zeigt.
- Benutzerrollen: wer das Recht Audit-Log bekommt.
- Login-Link senden oder Zwei-Faktor zurücksetzen: wenn ein Kollege nicht mehr in sein Konto kommt.