CUCM Collected Logs: Trace-Dateien eines Dienstes abholen

Wozu dient das

Mit CUCM Collected Logs holen Sie die Log- und Trace-Dateien eines CUCM-Dienstes für ein Zeitfenster ab, ohne RTMT zu starten. Sie brauchen das, wenn der Cisco-Support oder Ihr eigener Techniker die Originaldateien verlangt, etwa die Traces von Cisco CallManager oder Cisco CTIManager rund um einen Fehlerzeitpunkt.

EasyUC legt dafür einen Sammelauftrag an. Ein Hintergrunddienst fragt die Log-Collection-Schnittstelle des CUCM nach den Dateien des Dienstes im Zeitfenster, lädt sie und legt sie auf dem EasyUC-Server ab. Die Seite zeigt je Auftrag den Stand und bietet die Dateien zum Herunterladen an. Am CUCM wird nichts geändert.

Voraussetzungen

Lizenzmodul cucm und eine funktionierende CUCM-Verbindung.
Seitenrolle ROLE_APP_VIEW_LOG_PAGE für den Menüpunkt.
Der AXL-Benutzer der Verbindung darf am CUCM Traces abrufen (CUCM-Rollen Standard CCM Admin Users und Standard RealtimeAndTraceCollection).
Die gewünschten Traces sind am CUCM für den Dienst eingeschaltet. EasyUC kann nur abholen, was der CUCM geschrieben hat.
Der Hintergrunddienst für die CUCM-Log-Sammlung läuft.

Schritt für Schritt: Logs sammeln und herunterladen

Wählen Sie in der Kopfzeile die CUCM-Verbindung.
Öffnen Sie Logs → CUCM Collected Logs. Die Seite heißt Gesammelte CUCM-Logs.
Klicken Sie oben rechts auf Dienst zum Herunterladen von Logs erstellen.
Wählen Sie im Dialog Neuen Dienst zum Sammeln von CUCM-Logs speichern unter Select Service den CUCM-Dienst.
Prüfen Sie die Zeitzone.
Wählen Sie im Kalender den Tag bzw. den Datumsbereich.
Stellen Sie Start Zeit und End Zeit ein. Halten Sie das Fenster so klein wie möglich.
Klicken Sie auf Speichern. Der Auftrag erscheint in der Liste mit dem Status „Download from CUCM in Pending“.
Warten Sie, bis der Status wechselt. Rufen Sie die Seite bei Bedarf erneut auf.
Klicken Sie in der Zeile auf Aktionen → Dateien herunterladen. Der Browser lädt die Dateien des Auftrags einzeln herunter.
Löschen Sie den Auftrag nach der Auswertung über Aktionen → Löschen. Dabei werden auch die Dateien auf dem EasyUC-Server entfernt.

Felder und Optionen

Felder und Optionen
Feld / Aktion	Bedeutung und Verwendung
Select Service	CUCM-Dienst, dessen Logs gesammelt werden. Die Liste kommt vom CUCM.
Zeitzone	Zeitzone, in der Start und Ende gemeint sind.
Datumsbereich, Start Zeit, End Zeit	Zeitfenster, für das der CUCM Dateien liefern soll. Auswahl in Minutenschritten.
Filter Dienstname (Spaltenkopf)	Zeigt nur Aufträge eines Dienstes.
Datumsfilter (Kopfzeile)	Zeigt nur Aufträge aus dem gewählten Zeitraum.
Dateien herunterladen	Erscheint, sobald der Auftrag Dateien enthält.
Abruf vom CUCM wiederholen	Erscheint nur bei teilweise erfolgreichen Aufträgen und holt die fehlenden Dateien erneut.
Löschen	Entfernt den Auftrag einschließlich der Dateien nach einer Sicherheitsabfrage.

So lesen Sie die Liste

So lesen Sie die Liste
Feld / Aktion	Bedeutung und Verwendung
Dienstname	CUCM-Dienst des Auftrags.
Von (Datum/Uhrzeit) / Bis (Datum/Uhrzeit)	Angefragtes Zeitfenster.
Status „Download from CUCM in Pending“ (blau)	Der Auftrag wartet oder läuft.
Status „Download from CUCM Success“ (grün)	Alle Dateien wurden geladen.
Status „Download from CUCM Success Partial“ (gelb)	Nur ein Teil der Dateien wurde geladen. Details stehen im Info-Symbol.
Status „Download from CUCM Error“ (rot)	Der Abruf ist fehlgeschlagen.
Status „No Files Found“ (dunkel)	Der CUCM hat für Dienst und Zeitfenster keine Dateien geliefert.
Info-Symbol neben dem Status	Öffnet je Datei Name, Status (Pending, Success, Error), Zeitstempel und bei Fehlern den Fehlertext.
Erstellt am / Aktualisiert am	Zeitpunkt des Auftrags und der letzten Statusänderung.

Ergebnis prüfen und Fehler eingrenzen

Erfolg erkennen Sie am grünen Status und daran, dass Dateien herunterladen die Trace-Dateien liefert.
„No Files Found“: Zeitfenster und Zeitzone prüfen. Für den Dienst muss am CUCM Tracing aktiv sein, und die Dateien dürfen noch nicht überschrieben sein.
Bleibt der Status dauerhaft auf „Download from CUCM in Pending“, arbeitet der Hintergrunddienst nicht. Prüfen Sie die Hintergrunddienste im EasyUC Manager.
Bei „Download from CUCM Success Partial“ öffnen Sie das Info-Symbol, lesen den Fehler der betroffenen Datei und wählen Abruf vom CUCM wiederholen.
Bei „Download from CUCM Error“ prüfen Sie die Erreichbarkeit der CUCM-Knoten und die CUCM-Rollen des AXL-Benutzers.
Große Zeitfenster erzeugen viele und große Dateien. Prüfen Sie den freien Platz unter Speicherverwaltung und löschen Sie erledigte Aufträge.
Für die Frage, was bei einem einzelnen Anruf passiert ist, ist die Anrufdiagnose der kürzere Weg: Sie filtert die Traces bereits auf den Anruf.
Trace-Dateien enthalten Rufnummern und Geräteadressen. Geben Sie sie nur an den vorgesehenen Empfänger weiter.