Diagnose & Überwachung
CUCM-Änderungsprotokoll: direkte Änderungen am CUCM erfassen
Change-Feed und CUCM-Audit-Log je CUCM-Verbindung einschalten und die Einträge einordnen.
In EasyUC: Verwaltung → CUCM & Bereitstellung → CUCM-Verbindungen → Aktionen → CUCM-Änderungsprotokoll
Wozu dient das
Nicht jede Änderung läuft über EasyUC. Wer direkt in der CUCM-Administration ein Telefon ändert, taucht im Änderungsprotokoll von EasyUC nur auf, wenn EasyUC den CUCM danach fragt. Das CUCM-Änderungsprotokoll schaltet diese Erfassung je CUCM-Verbindung ein.
Es gibt zwei Stufen. Der Change-Feed fragt den CUCM regelmäßig über AXL nach geänderten Objekten. Er zeigt, was wann geändert wurde, aber nicht von wem. Die Einträge erscheinen mit der Quelle CUCM direkt etwa ein bis zwei Minuten nach der Änderung.
Die zweite Stufe wertet zusätzlich das Audit-Log des CUCM aus. Sie ergänzt den CUCM-Benutzer und die Client-IP. EasyUC liest dazu alle 10 Minuten die Audit-Dateien jedes aktiven CUCM-Knotens über die Log-Collection-Schnittstelle. Der Benutzer erscheint deshalb erst 5 bis 20 Minuten nach der Änderung. Am CUCM selbst ändert EasyUC nichts.
Voraussetzungen
- Zugriff auf die CUCM-Verbindungen in der Verwaltung.
- Für den Change-Feed: eine funktionierende AXL-Verbindung. Er ist je Verbindung standardmäßig eingeschaltet.
- Für das CUCM-Audit-Log am CUCM: unter Cisco Unified Serviceability → Tools → Audit Log Configuration sind Enable Audit Log und Detailed Audit Logging eingeschaltet und mit Apply to All Nodes gespeichert.
- Die Network Services Cisco Audit Event Service und Cisco Log Partitions Monitoring Tool laufen auf allen Knoten.
- Der AXL-Benutzer der Verbindung darf Serviceability-Protokolle lesen, zum Beispiel über die CUCM-Rolle Standard CCM Server Monitoring.
- EasyUC erreicht jeden aktiven CUCM-Knoten unter seinem Namen aus dem CUCM (HTTPS, Port 8443). IM&P- und Unity-Knoten werden übersprungen.
- In den Einstellungen des Änderungsprotokolls sind die Quellen CUCM direkt und CUCM-Audit-Log nicht abgeschaltet.
Schritt für Schritt: Erfassung an der Verbindung einschalten
Felder und Optionen
| Feld / Aktion | Bedeutung und Verwendung |
|---|---|
| Änderungen am CUCM abrufen (Change-Feed) | Fragt den CUCM regelmäßig nach geänderten Objekten. Vorgabe: eingeschaltet. Ausgeschaltet erscheinen direkte Änderungen am CUCM nicht im Änderungsprotokoll. Nach dem Wiedereinschalten beginnt der Abruf neu, ohne die Zeit dazwischen. |
| Überwachte Objekttypen | Telefon, Geräteprofil, Leitung, Benutzer, Remote Destination und Remote Destination Profile, Hunt Pilot, Hunt List, Line Group, Pickup Group, Translation Pattern und Route Pattern. Alle wählt alle Typen. |
| Abrufabstand (Sekunden) | Erlaubt 60 bis 300 Sekunden. Vorgabe ist ein Abruf je Minute. |
| CUCM-Audit-Log auswerten (wer hat geändert) | Ergänzt Benutzer und IP-Adresse aus dem Audit-Log des CUCM. Vorgabe: ausgeschaltet. |
| Weitere AXL-Benutzer von EasyUC | Änderungen dieser Benutzer gelten als EasyUC-Änderungen und werden nicht als direkte CUCM-Änderung gezeigt. Der AXL-Benutzer der Verbindung zählt immer dazu. |
So lesen Sie die Einträge
| Feld / Aktion | Bedeutung und Verwendung |
|---|---|
| Quelle CUCM direkt | Vom Change-Feed erkannte Änderung. Zeigt Objekt, Aktion und geänderte Felder. Der Zeitpunkt ist auf das Abrufintervall genau. Ausgeführt von lautet zunächst Unbekannt. |
| Ausgeführt von: CUCM-Administrator | Das CUCM-Audit-Log hat den Benutzer geliefert. Er wird einmalig am Eintrag „CUCM direkt“ ergänzt und ist wie ein EasyUC-Benutzer durchsuchbar. |
| Quelle CUCM-Audit-Log | Eigener Eintrag aus dem Audit-Log, wenn es keinen passenden Eintrag „CUCM direkt“ gab oder ein sonstiges Ereignis protokolliert wurde, zum Beispiel ein Dienstneustart. |
| Mögliche Rückmeldung | Eine Änderung, die wahrscheinlich EasyUC selbst ausgelöst hat. Standardmäßig ausgeblendet. |
| „Lücke im Change-Feed“ | Der CUCM hat seine Änderungsliste neu gestartet, zum Beispiel nach einem Neustart des AXL-Dienstes. Änderungen dazwischen werden durch einen Abgleich nachgetragen und tragen den Zusatz „Durch Abgleich erkannt, Zeitpunkt ungenau“. |
| Nicht gespeichert | An- und Abmeldungen am CUCM werden standardmäßig nicht übernommen. Werte sensibler Felder wie PIN oder Passwort erscheinen nur als geändert. |
Ergebnis prüfen und Fehler eingrenzen
- Erfolg erkennen Sie daran, dass die Teständerung nach ein bis zwei Minuten mit Quelle CUCM direkt erscheint und, bei eingeschaltetem Audit-Log, nach 5 bis 20 Minuten der CUCM-Benutzer ergänzt ist.
- Kein Eintrag „CUCM direkt“: Prüfen Sie, ob der Objekttyp unter Überwachte Objekttypen gewählt ist und ob in den Einstellungen des Änderungsprotokolls die Quelle eingeschaltet ist.
- Der Benutzer fehlt dauerhaft: Prüfen Sie am CUCM die Audit-Log-Konfiguration auf allen Knoten, die beiden Network Services und die Serviceability-Rechte des AXL-Benutzers. Ohne dieses Recht ist nur der Abruf des Audit-Logs betroffen; andere Funktionen laufen weiter.
- „Erlaubt: 60 bis 300 Sekunden“: Abrufabstand korrigieren.
- „Bitte mindestens einen Objekttyp wählen.“: Einen Objekttyp auswählen oder den Change-Feed ausschalten.
- „Für diese Verbindung ist noch nichts gespeichert – angezeigt werden die Vorgaben.“: Reiner Hinweis. Mit Speichern übernehmen Sie die Vorgaben.
- Die Zuordnung von Benutzer und Änderung ist zeitbasiert. Ändern zwei Administratoren dasselbe Objekt innerhalb weniger Minuten, kann der Benutzer am falschen Eintrag stehen. Die Zeilen des Audit-Logs bleiben als Details erhalten.
- Werden die Audit-Dateien am CUCM schneller überschrieben als abgerufen, gehen Zeilen verloren. Nach einer Pause liest EasyUC höchstens 7 Tage nach.
- Änderungen durch LDAP-Synchronisation erscheinen als „CUCM direkt“ ohne Benutzer, wenn das Audit-Log dazu nichts enthält.