Änderungsprotokoll (Audit-Log): wer hat wann was geändert

Wozu dient das

Das Änderungsprotokoll zeigt, wer wann was geändert hat. Es erfasst automatisch jede schreibende Aktion aus der Admin-Oberfläche, der Public API, der Selbstbedienung der Endbenutzer (auch Agenten- und Attendant-Portal) sowie aus Hintergrundjobs und der Warteschlange. Je CUCM-Verbindung kommen Änderungen hinzu, die direkt am CUCM gemacht wurden.

Sie brauchen es, um eine Störung auf eine Änderung zurückzuführen („seit gestern klingelt das Telefon nicht mehr“), für Nachweise gegenüber Revision und Datenschutz und für Supportfälle. Anmeldungen an EasyUC stehen ebenfalls im Protokoll, erfolgreich wie fehlgeschlagen, ohne Kennwort. Reine Lesezugriffe werden nicht protokolliert, Exporte schon.

Jede Zeile ist eine Aktion, zum Beispiel „Gerät ändern“. Was dabei tatsächlich geschrieben wurde, etwa die einzelnen AXL-Aufrufe an den CUCM, steht als Einzeländerungen in der Detailansicht. Kennwörter, PINs, Schlüssel und der Inhalt von Anfragen werden nie gespeichert.

Voraussetzungen

Seitenrolle ROLE_APP_VIEW_LOG_PAGE für den Menüpunkt und ROLE_APP_LIST_LOG (im Rolleneditor „Logs: bisherige Liste und Änderungsprotokoll“) für Liste und Details.
Für den Reiter Technisch und IP-Adressen im Export: ROLE_APP_VIEW_AUDIT_TECHNICAL. Wegen der IP-Adressen nur gezielt vergeben.
Für Exportieren und das Support-Protokoll: ROLE_APP_EXPORT_AUDIT.
Für Einstellungen (Aufbewahrung, Quellen): ROLE_APP_EDIT_AUDIT_SETTINGS.
Die Rollen vergeben Sie im Benutzer-Editor unter Verwaltung → Zugriff & Darstellung → Administratoren & Rollen, Bereich Logs.
Standortbeschränkte Administratoren sehen nur Einträge ihrer Standorte und ihre eigenen Aktionen. Einträge ohne Standort sehen sie nicht.
Für Änderungen direkt am CUCM muss an der CUCM-Verbindung das CUCM-Änderungsprotokoll eingeschaltet sein.

Schritt für Schritt: Eine Änderung finden

Wählen Sie in der Kopfzeile die CUCM-Verbindung, zu der das Objekt gehört.
Öffnen Sie Logs → EasyUC Logs. Die Seite heißt Änderungsprotokoll.
Tragen Sie in das Suchfeld ein, was Sie kennen: Gerätename oder MAC-Adresse, Rufnummer, Benutzer-ID, E-Mail-Adresse oder den Namen des Ausführenden. Unter dem Feld steht „Gesucht als: …“ und zeigt, wie die Eingabe verstanden wurde.
Klicken Sie auf Suchen.
Stellen Sie unter Zeitraum Heute, Letzte 7 Tage, Letzte 30 Tage oder Frei wählen ein. Vorgabe sind die letzten 7 Tage.
Fügen Sie über Filter hinzufügen weitere Filter hinzu: Quelle, Ergebnis, Art der Änderung, Objekttyp, Aktion, Ausgeführt von oder Standort. Jeder Filter erscheint als Marke und lässt sich einzeln entfernen.

Originalansicht zur Anleitung Zu Schritt 6
Über der Ergebnisliste grenzen Sie die Einträge nach Zeitraum, Quelle und Ergebnis ein. Darunter stehen echte Systemeinträge aus der Labumgebung. Öffnen Sie einen passenden Eintrag, um die Änderung im Detail zu prüfen.

EasyUC · Lab-/Demoumgebung
Änderungsprotokoll filtern

Originalprotokoll der Laborumgebung mit Zeit-, Quellen- und Ergebnisfiltern. Die sichtbaren Einträge dokumentieren vorhandene Laboraktivitäten, überwiegend Hintergrundabrufe; keine Einträge wurden für die Aufnahme erzeugt.
Klicken Sie in der Liste auf die Zeile. Die Seitenleiste Details öffnet sich.
Lesen Sie im Reiter Änderungen je Feld Vorher und Nachher.
Öffnen Sie den Reiter Beteiligte, um die Einzeländerungen mit Ergebnis und Fehlertext sowie alle betroffenen Objekte zu sehen.
Klicken Sie bei Bedarf auf Alle Einträge dieses Vorgangs anzeigen, um alle Schritte derselben Aktion zu sehen, auch die im Hintergrund weitergelaufenen.
Mit Weitere laden holen Sie ältere Treffer nach. Alle Filter zurücksetzen stellt die Ausgangsansicht her.

Schritt für Schritt: Exportieren und Support-Protokoll erzeugen

Stellen Sie Suche und Filter so ein, dass die Liste die gewünschten Einträge zeigt.
Klicken Sie oben rechts auf Exportieren und wählen Sie Als CSV exportieren oder Als Excel-Datei (XLSX) exportieren.
Sind es mehr Treffer als erlaubt, bietet die Seite Nur die neuesten … exportieren an.
Für einen Supportfall: Führen Sie das Problem erneut aus und klicken Sie danach im Kasten Support-Protokoll herunterladen auf Letzte 5 Minuten oder Letzte 10 Minuten. Sie erhalten alle EasyUC- und CUCM-Aktionen dieses Zeitfensters als CSV.

Schritt für Schritt: Aufbewahrung und Quellen einstellen

Klicken Sie oben rechts auf Einstellungen. Der Dialog Aufbewahrung und Quellen öffnet sich.
Tragen Sie unter EasyUC-Einträge aufbewahren (Monate) und CUCM-Einträge aufbewahren (Monate) die Fristen ein.
Tragen Sie unter IP-Adressen entfernen nach (Tagen) die Frist für IP-Adressen ein.
Schalten Sie unter Erfasste Quellen je Quelle Erfassen ein oder aus.
Klicken Sie auf Speichern. Die Änderung wirkt in allen Diensten spätestens nach 30 Sekunden.

Felder und Optionen

Felder und Optionen
Feld / Aktion	Bedeutung und Verwendung
Suchfeld	MAC oder SEP-Name sucht Geräte. Ziffern oder `+` suchen Nummern: `4711` findet genau oder endend auf 4711, `4711` beginnt mit, `4711` endet auf. `@` sucht E-Mail und Benutzer-ID. Alles andere sucht den Anfang von Namen, Beschreibungen, Benutzern und Ausführenden.
Zeitraum	Heute, Letzte 7 Tage (Vorgabe), Letzte 30 Tage oder frei, höchstens 366 Tage.
Mögliche Rückmeldungen eigener Änderungen anzeigen	Ändert EasyUC etwas am CUCM, meldet der CUCM diese Änderung zurück. Nicht sicher zuordenbare Rückmeldungen sind gespeichert, aber standardmäßig ausgeblendet. Diese Option blendet sie ein.
Exportieren	CSV bis 200.000 Zeilen, Excel bis 10.000 Zeilen, jeweils mit den aktuellen Filtern. CSV mit Trennzeichen `;` und UTF-8. Jeder Export steht selbst im Änderungsprotokoll.
EasyUC-Einträge aufbewahren (Monate)	Vorgabe 12, erlaubt 1 bis 120.
CUCM-Einträge aufbewahren (Monate)	Gilt für die Quellen CUCM direkt und CUCM-Audit-Log. Vorgabe 3, erlaubt 1 bis 120.
IP-Adressen entfernen nach (Tagen)	Vorgabe 90, erlaubt 1 bis 3650.
Erfasste Quellen	Je Quelle schaltbar, Vorgabe alle an. Unabhängig davon immer protokolliert: Anmeldungen, Änderungen an EasyUC-Benutzern, ihren Rollen und an API-Benutzern sowie Export und Einstellungen des Änderungsprotokolls.
CUCM-Quellen je Verbindung	Zeigt je CUCM-Verbindung, ob Change-Feed und CUCM-Audit-Log eingeschaltet sind. Bearbeiten führt zur Einstellung an der Verbindung.
Alte Ansicht	Öffnet die bisherige Protokollliste. Von dort bzw. über Ursprünglichen Eintrag anzeigen in den Details geht weiterhin Wiederherstellen für Einträge aus dem alten Protokoll.

So lesen Sie die Liste und die Details

So lesen Sie die Liste und die Details
Feld / Aktion	Bedeutung und Verwendung
Zeit	Relativ („vor 5 Minuten“), die genaue Uhrzeit beim Überfahren mit der Maus. Ein Uhr-Symbol kennzeichnet ungenaue Zeiten: bei CUCM-Änderungen auf das Abrufintervall genau, bei übernommenen Alteinträgen aus dem alten Protokoll.
Quelle	Admin-Oberfläche, Selbstbedienung, Public API, Hintergrundjob, Asynchron (Warteschlange), CUCM direkt, CUCM-Audit-Log oder Altes Protokoll.
Ausgeführt von	EasyUC-Benutzer, API-Benutzer, Endbenutzer, System, CUCM-Administrator oder Unbekannt. Unbekannt steht bei direkten CUCM-Änderungen, solange das CUCM-Audit-Log den Benutzer nicht geliefert hat.
Aktion	Beschriftung der Aktion mit farbiger Marke für die Art: Anlegen, Ändern, Löschen, Anmelden, Abmelden, Ausführen oder Sonstiges.
Objekt	Hauptobjekt der Aktion, zum Beispiel Telefon, Benutzer, Leitung oder Gruppe.
Betroffen	Suchschlüssel wie Gerätename, MAC-Adresse, Rufnummer oder Benutzer-ID. Ein Klick filtert danach.
Standort	Standort des Objekts, sonst Ohne Standort.
Ergebnis	Erfolgreich, Fehlgeschlagen, Teilweise erfolgreich oder Unbekannt.
Marke „Nicht abgeschlossen“	Die Aktion wurde begonnen, aber nie abgeschlossen, zum Beispiel weil ein Dienst währenddessen neu gestartet wurde.
Marke „Mögliche Rückmeldung“	Wahrscheinlich das Echo einer EasyUC-Änderung, das der CUCM zurückgemeldet hat.
Reiter Änderungen	Feld, Vorher, Nachher. Bei Geheimnissen steht nur „Geändert (Wert wird nicht gespeichert)“.
Reiter Beteiligte	Einzeländerungen (zum Beispiel jeder AXL-Aufruf mit Ergebnis und Fehlertext) und betroffene Objekte.
Reiter Technisch	IP-Adresse, Request-ID, HTTP-Status, Routenparameter und technische Rohdaten in redigierter Form. Nur mit eigener Rolle sichtbar.
Verknüpften Eintrag öffnen	Springt bei CUCM-Einträgen zur zugehörigen EasyUC-Aktion und umgekehrt.

Ergebnis prüfen und Fehler eingrenzen

Prüfen Sie die Funktion mit einer eigenen kleinen Änderung, etwa der Beschreibung eines Testtelefons. Sie erscheint sofort mit Quelle Admin-Oberfläche, Ihrem Benutzer und dem Feld unter Änderungen.
Sie sehen einen Eintrag nicht: Prüfen Sie den Zeitraum (Vorgabe 7 Tage), die CUCM-Verbindung in der Kopfzeile und Ihre Standortbeschränkung.
„Ihnen fehlt die Berechtigung für das Änderungsprotokoll.“: Es fehlt ROLE_APP_LIST_LOG. Die Rechte für die Log-Kachel oder den Verlauf im Endbenutzerprofil reichen nicht.
„Für technische Details fehlt die Berechtigung.“: Es fehlt ROLE_APP_VIEW_AUDIT_TECHNICAL.
„Der Filter ist ungültig (…). Bitte die Eingabe prüfen.“: Das genannte Filterfeld korrigieren, zum Beispiel einen Zeitraum über 366 Tage.
„Zu viele Treffer für den Export: höchstens … Zeilen.“: Filter einschränken oder nur die neuesten Einträge exportieren.
Eine Änderung erscheint doppelt: einmal als EasyUC-Aktion und einmal als mögliche Rückmeldung vom CUCM. Rückmeldungen sind nur sichtbar, wenn die Option dazu eingeschaltet ist.
Bei „CUCM direkt“ steht kein Benutzer: Der Change-Feed des CUCM kennt den Benutzer nicht. Das CUCM-Audit-Log ergänzt ihn, wenn es an der Verbindung eingeschaltet ist.
Ältere Einträge löscht ein täglicher Hintergrundjob nach den eingestellten Fristen. Große Umgebungen erzeugen mehrere GB pro Jahr. Behalten Sie das Datenbankvolumen im Blick; die Aufbewahrungsfristen sind der Hebel dafür.
Ist die Quelle Admin-Oberfläche ausgeschaltet, werden die übrigen Aktionen in der Oberfläche nicht mehr protokolliert. Schalten Sie Quellen nur bewusst ab.