Workspace-Eigentümer können unsere Audit-Logs auf Workspace-Ebene verwenden, um Situationen wie Fehler, unerlaubte Zugriffe und böswillige Aktionen zu untersuchen.
Verfügbarkeit und Limits von Funktionen variieren je nach Plan und Benutzerrolle. Mehr erfahren.
API-Integration
Integriere dein Audit-Log in deine externen Systeme oder exportiere Logs als Referenz für die Compliance über unsere API.
Vom Audit-Log erfasste Ereignisse
Ereignisse sind Benutzeraktionen, die protokolliert werden. Dies sind die Workspace-Audit-Logs:
- Benutzer: Das Benutzer-Log erfasst Authentifizierungs- und Autorisierungsereignisse, wie Benutzeranmeldungen und -abmeldungen, Rollenänderungen und Benutzereinladungen.
- Aufgabe: Das Aufgaben-Log erfasst ausgewählte Aufgabenaktivitäten nach Benutzer und Aufgabenaktivitätstyp.
- Felder: Das Felder-Log erfasst Ereignisse zu benutzerdefinierten Feldern, z. B. wenn Benutzerdefinierte Felder erstellt oder entfernt werden.
- Hierarchie: Das Hierarchie-Log erfasst Hierarchieereignisse, z. B. wenn ein Ordner erstellt oder eine Liste gelöscht wird.
- Agents: Das Agents-Log erfasst Super Agent-Aktivitäten nach Workspace-Benutzer oder Agent und Aktivitätstyp.
- Sonstiges: Das Log „Sonstiges" erfasst Ereignisse zu benutzerdefinierten Emojis.
Ereignisdaten
Die Logs generieren für jedes Ereignis die folgenden Daten:
- Datum
- Benutzer
- Rolle
- Ereignis
- Status
Ein Ereignis-Log liefert mehr Details. So rufst du das Ereignis-Log auf:
- Klicke links neben dem Datum in einer beliebigen Zeile des Audit-Logs auf das Dropdown.
Das Ereignis-Log ist ein internes Berichtssystem, das unsere Benennungsschemata verwendet. Einige Informationen, wie Benutzerrollen, werden durch eine Zahl dargestellt.
Die folgende Tabelle zeigt beispielhafte Ereignis-Log-Daten, die generiert werden, wenn ein Administrator sich erfolgreich über 2FA anmeldet:
| Informationen | Beschreibung | Ereignis-Log |
| Datum 31. Juli 2024 10:59:04 Uhr |
Datum und Uhrzeit des Ereignisses. | startTime: "2024-07-31T17:59:04.238Z endTime: "2024-07-31T17:59:04.238Z |
| Benutzer username@email.com |
Der Benutzer, der die Aktion ausgeführt hat. | userId: 123 clientIp: 123.123.123.123 userName: User Name userEmail: username@email.com |
| Rolle Administrator |
Die Rolle des handelnden Benutzers. | userRole: 2 |
| Ereignis Benutzeranmeldung (2FA) |
Benutzeraktionen, die protokolliert werden. | title: User Login (2FA) eventType: USER_LOGIN |
| Status Erfolgreich |
Der Zustand des Ereignisses, z. B. Erfolg oder Fehlschlag. | eventStatus: success |
Vom Benutzer-Log erfasste Ereignisse
Die folgende Tabelle beschreibt die vom Benutzer-Log erfassten Ereignisse:
| Ereignis | Beschreibung |
| 2FA-Richtlinie geändert | Ein Eigentümer oder Admin hat die 2FA-Pflichtrichtlinie des Workspace geändert. |
| Zugriffsanfrage erstellt | Jemand hat Zugriff auf eine Aufgabe angefragt. |
| Zugriffsanfrage bearbeitet | Die Anfrage zum Zugriff auf eine Aufgabe wurde genehmigt oder abgelehnt. |
| Erweiterte Einstellungen aktualisiert | Ein Eigentümer oder Admin hat eine erweiterte Workspace-Berechtigung aktualisiert. |
| App-Verbindung erstellt | Jemand hat eine persönliche oder Workspace-Verbindung für eine App eingerichtet. Dies umfasst auch externe MCP-Server-Verbindungen. |
| App-Verbindung gelöscht | Jemand hat eine persönliche oder Workspace-Verbindung für eine App getrennt. Dies umfasst auch Verbindungen zu externen MCP-Servern. |
| App-Verbindung aktualisiert | Jemand hat die Einstellungen einer vorhandenen verbundenen App geändert, zum Beispiel durch Aktivieren oder Deaktivieren der verbundenen Suche. |
| SSO-Umgehung aktiviert | Ein Eigentümer oder Admin hat die Einstellung SSO umgehen aktiviert. |
| Chat-Aufbewahrungseinstellung gelöscht | Ein Eigentümer oder Admin hat die Chat-Datenaufbewahrungseinstellung auf den Standardwert „Läuft nie ab" zurückgesetzt. |
| Chat-Aufbewahrungseinstellung aktualisiert | Ein Eigentümer oder Admin hat die Chat-Datenaufbewahrungseinstellung auf 30, 90, 180 oder 360 Tage geändert. |
| KI-Notetaker-Aufbewahrungseinstellung deaktiviert | Wird protokolliert, wenn ein Eigentümer oder Admin den KI-Notetaker-Datenaufbewahrungszeitraum auf „Läuft nie ab" zurücksetzt. |
| KI-Notetaker-Aufbewahrungseinstellung aktualisiert | Wird protokolliert, wenn ein Eigentümer oder Administrator einen Datenaufbewahrungszeitraum für den KI-Notetaker festlegt. |
| ClickApp aktualisiert | Die angegebene ClickApp wurde aktualisiert. |
| Benutzerdefinierte Rolle erstellt | Ein Eigentümer oder Administrator hat eine neue benutzerdefinierte Rolle erstellt. |
| Benutzerdefinierte Rolle gelöscht | Ein Eigentümer oder Administrator hat eine benutzerdefinierte Rolle gelöscht. |
| Benutzerdefinierte Rolle aktualisiert | Ein Eigentümer oder Administrator hat eine benutzerdefinierte Rolle aktualisiert. |
| Rollenberechtigungen geändert | Der Nutzer hat die Berechtigungen eines anderen Nutzers geändert. |
| SSO-Konfiguration aktualisiert | Ein Eigentümer oder Administrator hat die SSO-Anforderung oder den Anbieter des Workspace geändert. |
| Space-ClickApp-Massenaktualisierung | Massenaktualisierung von ClickApps für Spaces. |
| Space-ClickApp aktualisiert | ClickApps aktualisieren für einen bestimmten Space. |
| Team erstellt | Ein Team wurde erstellt. |
| Team gelöscht | Ein Team wurde gelöscht. |
| Team aktualisiert | Ein Team wurde aktualisiert. |
| Benutzer über SCIM aktualisiert Weitere Informationen zur Verwendung von SCIM mit ClickUp findest du in den folgenden Artikeln: • Microsoft Entra ID SCIM-Konfigurationsanleitung • Okta SCIM ClickUp-Konfigurationsanleitung |
Das Profil des Benutzers wurde über SCIM aktualisiert. |
| Benutzer über SCIM deprovisioniert | Der Benutzer wurde über SCIM deprovisioniert. |
| Benutzer über SCIM provisioniert | Der Benutzer wurde über SCIM provisioniert. |
| Benutzer zu Team hinzugefügt | Ein Benutzer wurde einem Team hinzugefügt. |
| Benutzer hat 2FA geändert | Ein Benutzer hat die 2FA-Einstellungen für sein Konto aktiviert oder deaktiviert. |
| Benutzer hat E-Mail-Adresse geändert | Der Benutzer hat seine E-Mail-Adresse geändert. |
| Benutzer hat Passwort geändert | Der Benutzer hat sein Passwort geändert. |
| Benutzer zum Workspace eingeladen | Der Benutzer hat einen neuen Benutzer eingeladen, dem Workspace beizutreten. |
| Benutzer ist Workspace beigetreten | Der Benutzer hat eine Einladung angenommen, dem Workspace beizutreten. |
| Benutzer hat Workspace verlassen | Der Benutzer hat den Workspace verlassen. |
| Benutzeranmeldung | Der Benutzer hat sich angemeldet. |
| Benutzerabmeldung | Der Benutzer hat sich abgemeldet. |
| Nutzer aus Team entfernt | Der Nutzer wurde aus einem Team entfernt. |
| Nutzer aus Workspace entfernt | Der Nutzer hat einen anderen Nutzer aus dem Workspace entfernt. |
| Nutzer hat Passwortwiederherstellung angefordert | Der Nutzer hat eine Passwortwiederherstellung angefordert. |
| Nutzer hat Einladung angefordert | Ein Nutzer mit Einladungsberechtigungen hat einen anderen Nutzer eingeladen. |
| Nutzerrolle geändert | Der Nutzer hat die Rolle eines anderen Nutzers geändert. |
App-Verbindungsereignisse ermöglichen es Admins derzeit nicht, zu erkennen, wer eine persönliche Drittanbieter-Verbindung erstellt oder entfernt hat. Erste Scans und regelmäßige Neuindizierungen können im Quellsystem als wiederholter Dateizugriff erscheinen.
Bei den Enterprise- und Max-Plänen kann die Rollenberechtigung Persönliche Integrationen neue persönliche Verbindungen verhindern. Diese Berechtigung wird schrittweise eingeführt und ist in deinem Workspace möglicherweise noch nicht sichtbar. Das Verhalten kann sich ändern.
Vom Aufgabenprotokoll erfasste Ereignisse
Die folgende Tabelle listet die vom Aufgabenprotokoll erfassten Ereignisse auf:
| Ereignis |
| Aufgabe archiviert |
| Aufgabe – zugewiesene Personen geändert |
| Aufgabe erstellt |
| Aufgabe – Werte des benutzerdefinierten Felds geändert |
| Aufgabe gelöscht |
| Aufgabe verschoben |
| Aufgabe – Priorität geändert |
| Aufgabe wiederhergestellt |
| Aufgabe – Status geändert |
| Aufgabe aus Archiv wiederhergestellt |
Aktionen von Super Agents sind eingeschlossen.
Vom Felder-Protokoll erfasste Ereignisse
Die folgende Tabelle listet die vom Felder-Protokoll erfassten Ereignisse auf:
| Ereignis | Beschreibung |
| Benutzerdefiniertes Feld konvertiert | Der Benutzer hat ein vorhandenes benutzerdefiniertes Feld in einen anderen Feldtyp konvertiert. |
| Benutzerdefiniertes Feld erstellt | Der Benutzer hat ein benutzerdefiniertes Feld erstellt. |
| Benutzerdefiniertes Feld aktualisiert | Der Benutzer hat ein benutzerdefiniertes Feld bearbeitet. Audit-Protokolle erfassen keine Bearbeitungen der Optionen für benutzerdefinierte Felder vom Typ Dropdownmenü oder Bezeichnungen. Zum Beispiel das Ändern des Namens eines Dropdownmenü-Felds. |
| Benutzerdefiniertes Feld entfernt | Der Benutzer hat ein benutzerdefiniertes Feld von einem Speicherort entfernt, ohne es aus dem Workspace zu löschen. |
| Benutzerdefiniertes Feld dauerhaft entfernt | Der Benutzer hat ein benutzerdefiniertes Feld aus dem Workspace gelöscht. Oder ein benutzerdefiniertes Feld befand sich mehr als 30 Tage lang im Papierkorb. Nach 30 Tagen werden benutzerdefinierte Felder dauerhaft gelöscht. |
| Benutzerdefiniertes Feld wiederhergestellt | Der Benutzer hat ein benutzerdefiniertes Feld aus dem Papierkorb wiederhergestellt. |
| Benutzerdefiniertes Feld dupliziert | Der Benutzer hat ein benutzerdefiniertes Feld dupliziert. |
| Benutzerdefiniertes Feld zusammengeführt | Der Benutzer hat ein benutzerdefiniertes Feld zusammengeführt. |
| Speicherort für benutzerdefiniertes Feld hinzugefügt | Der Benutzer hat ein benutzerdefiniertes Feld zu einem neuen Speicherort hinzugefügt. |
| Speicherort für benutzerdefiniertes Feld aktualisiert | Der Benutzer hat ein benutzerdefiniertes Feld von einem Speicherort zu einem anderen verschoben. |
| Speicherort für benutzerdefiniertes Feld entfernt | Der Benutzer hat ein benutzerdefiniertes Feld von einem Speicherort entfernt. |
| Mitgliedsberechtigung für benutzerdefiniertes Feld festgelegt | Die Benutzerberechtigungen für dieses benutzerdefinierte Feld wurden festgelegt oder bearbeitet. |
| Mitgliedsberechtigung für benutzerdefiniertes Feld entfernt | Eine Benutzerberechtigung für dieses benutzerdefinierte Feld wurde entfernt. |
| Gruppenmitgliedsberechtigung für benutzerdefiniertes Feld aktualisiert | Die Benutzerberechtigung eines Teams für dieses benutzerdefinierte Feld wurde aktualisiert. |
| Gruppenmitgliedsberechtigung für benutzerdefiniertes Feld entfernt | Die Benutzerberechtigung eines Teams für dieses benutzerdefinierte Feld wurde entfernt. |
Aktionen, die von Super Agents durchgeführt werden, sind eingeschlossen.
Vom Hierarchie-Protokoll erfasste Ereignisse
Die folgende Tabelle listet die vom Hierarchie-Protokoll erfassten Ereignisse auf:
| Ereignis | Beschreibung |
| Ordner-Zugriff aktualisiert | Die Freigabe- oder Berechtigungseinstellungen eines Benutzers für einen Ordner oder Unterordner wurden aktualisiert. |
| Ordner archiviert | Ein Ordner oder Unterordner wurde archiviert. |
| Ordner erstellt | Ein Ordner oder Unterordner wurde erstellt. |
| Ordner gelöscht | Ein Ordner oder Unterordner wurde gelöscht. |
| Ordner dupliziert | Ein Ordner oder Unterordner wurde dupliziert. |
| Ordner verschoben | Ein Ordner oder Unterordner wurde verschoben. |
| Öffentliche/private Einstellung des Ordners aktualisiert | Die öffentliche oder private Einstellung eines Ordners oder Unterordners wurde aktualisiert. |
| Ordner umbenannt | Ein Ordner oder Unterordner wurde umbenannt. |
| Ordner aktualisiert | Eine Einstellung eines Ordners oder Unterordners wurde aktualisiert. Zum Beispiel wurde die Ordnerfarbe geändert. |
| Listen-Zugriff aktualisiert | Die Freigabe- oder Berechtigungseinstellungen eines Benutzers für eine Liste wurden aktualisiert. |
| Liste archiviert | Eine Liste wurde archiviert. |
| Liste erstellt | Eine Liste wurde erstellt. |
| Liste gelöscht | Eine Liste wurde gelöscht. |
| Liste dupliziert | Eine Liste wurde dupliziert. |
| Liste verschoben | Eine Liste wurde verschoben. |
| Öffentliche/private Einstellung der Liste aktualisiert | Die öffentliche oder private Einstellung einer Liste wurde aktualisiert. |
| Liste umbenannt | Eine Liste wurde umbenannt. |
| Liste aus dem Archiv geholt | Eine Liste wurde aus dem Archiv geholt. |
| Liste aktualisiert | Eine Einstellung der Liste wurde aktualisiert. Zum Beispiel wurde der Status der Liste geändert. |
| Space-Zugriff aktualisiert | Die Freigabe- oder Berechtigungs-einstellungen eines Benutzers für einen Space wurden aktualisiert. |
| Space archiviert | Ein Space wurde archiviert. |
| Space erstellt | Ein Space wurde erstellt. |
| Space gelöscht | Ein Space wurde gelöscht. |
| Space dupliziert | Ein Space wurde dupliziert. |
| Öffentliche/private Einstellung des Space aktualisiert | Die öffentliche oder private Einstellung eines Space wurde aktualisiert. |
| Space umbenannt | Ein Space wurde umbenannt. |
| Space aktualisiert | Eine Space-Einstellung wurde aktualisiert. Zum Beispiel wurden Farbe und Symbol geändert. |
Aktionen von Super Agents sind eingeschlossen.
Im Agents-Protokoll erfasste Ereignisse
Dieses Protokoll gilt nur für Super Agents. Aktivitäten des Autopilot Agent werden im Automatisierungsprotokoll erfasst.
Die folgende Tabelle listet die Ereignisse auf, die vom Agents-Protokoll erfasst werden:
| Ereignis | Beschreibung |
| Aktiv-Einstellung des Agents aktualisiert | Der Super Agent wurde aktiviert. Das bedeutet, dass der Super Agent gerade erstellt oder ein vorhandener Super Agent reaktiviert wurde. |
| Zugewiesene-Person-Einstellung des Agents aktualisiert | Der Aufgabe-zuweisen-Trigger des Super Agents wurde deaktiviert. |
| Agent erstellt | Der Super Agent wurde erstellt. |
| Direktnachricht-Einstellung des Agents aktualisiert | Der Direktnachrichten-Trigger des Super Agents wurde deaktiviert. |
| Agent gelöscht | Der Super Agent wurde gelöscht. |
| Wissens-Einstellung des Agents aktualisiert | Das Wissen des Super Agents wurde bearbeitet. |
| Erwähnungs-Einstellung des Agents aktualisiert | Der Erwähnungs-Trigger des Super Agents wurde deaktiviert. |
| Prompt-Einstellung des Agents aktualisiert | Die Anweisungen des Super Agents wurden bearbeitet. |
| Tools-Einstellung des Agents aktualisiert | Die Tools des Super Agents wurden bearbeitet. |
| Trigger-Einstellung des Agents aktualisiert | Die Trigger des Super Agents wurden aktualisiert. |
| Zeitplan-Einstellung des Agents aktualisiert | Der Zeitplan des Super Agents wurde aktualisiert. |
Im Sonstige-Protokoll erfasste Ereignisse
| Ereignis | Beschreibung |
| Emoji erstellt, gelöscht oder aktualisiert | Ein benutzerdefiniertes Emoji wurde erstellt, gelöscht oder aktualisiert. |
Auf deine Audit-Protokolle zugreifen
Audit-Protokolle werden in den Einstellungen deines ClickUp Workspace generiert und können auch mit der ClickUp API verwendet werden.
So greifst du über ClickUp auf Audit-Protokolle zu:
- Klicke oben links auf deinen Workspace-Avatar und wähle Einstellungen.
- Klicke in der Seitenleiste „Alle Einstellungen" auf Audit-Protokolle.
- Klicke auf den Tab Benutzer, Aufgabe, Felder oder Hierarchie, um ein Protokoll auszuwählen.
Audit-Logs durchsuchen
Im Audit-Logs-Modal in deinen Workspace-Einstellungen kannst du beide Logs mithilfe der folgenden Filter durchsuchen:
Datum
Das Datum, an dem das Ereignis stattgefunden hat. So suchst du nach Datum:
- Wähle den Tab Benutzer oder Aufgabe aus.
- Klicke unterhalb der Tabs auf das Dropdown-Menü Datum.
- Wähle im Datumsauswahl-Dialog eine oder beide Optionen aus:
- Von Datum: Wann das Ereignis begann.
- Bis Datum: Wann das Ereignis endete.
Benutzer
Der Benutzer, der die Aktion ausgeführt hat. So suchst du nach Benutzer:
- Wähle den Tab Benutzer oder Aufgabe aus.
- Klicke unterhalb der Tabs auf das Dropdown-Menü Benutzer.
- Wähle im Personenauswahl-Dialog einen Benutzer aus.
Status
Der Status der abgeschlossenen Aktion. Zum Beispiel „Erfolgreich" oder „Fehler". So zeigst du ihn an:
- Wähle den Tab Benutzer oder Aufgabe aus.
- Klicke unterhalb der Tabs auf das Dropdown-Menü Status.
- Wähle im Dropdown-Menü einen oder mehrere der folgenden Status aus:
- Erfolgreich
- Fehlgeschlagen
Admins das Anzeigen von Audit-Logs erlauben
Eigentümer können Admins erlauben, Audit-Logs anzuzeigen. Mitglieder und Gäste können keine Audit-Logs anzeigen.
So erlaubst du Admins das Anzeigen von Logs:
- Klicke in der oberen linken Ecke auf deinen Workspace-Avatar und wähle Einstellungen aus.
- Klicke in der Seitenleiste „Alle Einstellungen" auf Sicherheit & Berechtigungen.
- Erstelle eine benutzerdefinierte Berechtigung, die die Admin-Rolle erbt.
- Scrolle nach unten zum Abschnitt Workspace-Aktionen.
- Klicke in der Spalte der neuen Rolle auf den Schalter Audit-Logs anzeigen, um ihn zu aktivieren.