La documentazione per questo prodotto è stata redatta cercando di utilizzare un linguaggio senza pregiudizi. Ai fini di questa documentazione, per linguaggio senza di pregiudizi si intende un linguaggio che non implica discriminazioni basate su età, disabilità, genere, identità razziale, identità etnica, orientamento sessuale, status socioeconomico e intersezionalità. Le eventuali eccezioni possono dipendere dal linguaggio codificato nelle interfacce utente del software del prodotto, dal linguaggio utilizzato nella documentazione RFP o dal linguaggio utilizzato in prodotti di terze parti a cui si fa riferimento. Scopri di più sul modo in cui Cisco utilizza il linguaggio inclusivo.
Cisco ha tradotto questo documento utilizzando una combinazione di tecnologie automatiche e umane per offrire ai nostri utenti in tutto il mondo contenuti di supporto nella propria lingua. Si noti che anche la migliore traduzione automatica non sarà mai accurata come quella fornita da un traduttore professionista. Cisco Systems, Inc. non si assume alcuna responsabilità per l’accuratezza di queste traduzioni e consiglia di consultare sempre il documento originale in inglese (disponibile al link fornito).
Questo documento descrive come utilizzare il processo di raccolta delle tracce di Cisco Unified Communications Manager (CUCM/CallManager).
Cisco raccomanda la conoscenza dei seguenti argomenti:
Nota: per utilizzare questi strumenti, è necessario essere un client Cisco registrato.
Le informazioni fornite in questo documento si basano su CUCM 9.X e versioni successive.
Nota: per informazioni sulla versione precedente di CUCM 8.6.2, vedere Raccolta delle tracce CUCM da CUCM 8.6.2 per un TAC SR.
Le informazioni discusse in questo documento fanno riferimento a dispositivi usati in uno specifico ambiente di emulazione. Su tutti i dispositivi menzionati nel documento la configurazione è stata ripristinata ai valori predefiniti. Se la rete è operativa, valutare attentamente eventuali conseguenze derivanti dall'uso dei comandi.
Se si collabora con un tecnico di assistenza tecnica (TAC) per un problema di Communications Manager, è necessario raccogliere le tracce CUCM. Potrebbe trattarsi di un'operazione che non si esegue di frequente o che non si è mai eseguita prima.
In questo scenario, è possibile risolvere i problemi relativi a una chiamata che non è stata registrata anche se la configurazione lato CUCM sembra corretta. L'amministratore riceve un messaggio di allarme per ciascuna chiamata che non è riuscita a registrare, quindi il tecnico TAC ha richiesto di riprodurre il problema e di raccogliere le tracce dettagliate di CallManager, le tracce dettagliate di CTI Manager e i registri del Visualizzatore eventi dal lato CUCM. Questi registri acquisiscono gli eventi di segnalazione delle chiamate, i messaggi CTI scambiati con il server che registra le chiamate e gli allarmi della chiamata che non è stato possibile registrare.
Per completare l'operazione:
In CUCM, l'applicazione RTMT viene utilizzata per raccogliere le tracce per la maggior parte dei tipi di problemi. A ogni versione principale e secondaria di CUCM è associata una versione dell'applicazione RTMT. Se nel PC non è presente un gruppo di programmi RTMT unificato in Start > Programmi > Cisco, oppure se la versione RTMT non corrisponde al cluster CUCM, è necessario installare lo strumento RTMT per la versione CUCM prima di procedere.
Viene visualizzata la pagina System Summary (Riepilogo sistema).
È stato verificato che RTMT sia installato e che sia possibile accedere al cluster CUCM con lo strumento.
In CUCM 9.X e versioni successive, la traccia dettagliata è attivata per impostazione predefinita per il servizio CallManager. Prima di procedere, verificare che la traccia dettagliata sia ancora configurata. In caso contrario, configurarla.
Se si utilizza una versione precedente di CUCM, è necessario configurare manualmente le impostazioni di traccia in modo che corrispondano all'illustrazione. Nelle versioni precedenti, il pulsante Imposta predefinito imposta Debug Trace Level su Error e non su Detailed.
Per impostazione predefinita, in CUCM 9.X e versioni successive la funzione di traccia dettagliata è attivata anche per il servizio CTI Manager. Prima di procedere, confermare o configurare questa funzionalità.
Il sistema è configurato per la traccia dettagliata predefinita, come mostrato nell'immagine:
6. Se queste impostazioni sono state modificate e si utilizza CUCM versione 9.x o successiva:
7. Confermare la configurazione della traccia negli altri server del cluster.
Come per le impostazioni di traccia di CallManager, se si utilizza una versione precedente di CUCM è necessario configurare manualmente le impostazioni di traccia in modo che corrispondano alle impostazioni della figura precedente. Se è necessario impostare il livello di traccia di debug su Errore, fare clic su Imposta predefinito nelle versioni precedenti.
Nota: i registri del Visualizzatore eventi Non è necessario modificare i livelli di debug del Visualizzatore eventi, dei registri applicazioni o del Visualizzatore eventi né dei registri di sistema. È necessario procedere con la riproduzione del problema.
In questo scenario è possibile effettuare chiamate di test per generare un errore. Consente al tecnico TAC di analizzare la chiamata se vengono fornite informazioni sul set di tracce che non contengono informazioni sulle chiamate di test. Inoltre, si rischia la raccolta di dati per un intervallo di tempo errato e, in tal caso, è necessario ricominciare.
Per ogni chiamata di prova, registrare le seguenti informazioni:
Poiché le tracce CUCM possono essere molto lunghe, TAC necessita di tali dettagli per poter trovare le chiamate di prova nei dati.
Dopo aver riprodotto il problema, raccogliere immediatamente le tracce richieste da TAC. In tal caso, i file non vengono sovrascritti prima di poterli raccogliere.
In questo scenario è necessario raccogliere le tracce di CallManager, le tracce di CTI Manager e tutti i registri del Visualizzatore eventi. A meno che TAC non abbia fornito altre istruzioni, è necessario raccogliere tali file da tutti i server per l'intervallo di tempo completo che copre la chiamata o le chiamate di prova. In questo modo si evita la perdita di tracce da un server che non si sapeva fosse presente nel flusso di chiamata.
La finestra Raccogli file viene aggiornata con lo stato della raccolta di traccia. Mentre la raccolta di tracce continua, è possibile visualizzare un pulsante Annulla disponibile. Al termine della raccolta, il pulsante Annulla è disattivato.
Esaminare i file raccolti per verificare che coprano l'intervallo di tempo del problema. Il modo più semplice per eseguire questa operazione consiste nell'esaminare i file TraceCollectionResult*.xml.
Quando RTMT raccoglie un insieme di file, scrive un file TraceCollectionResult*.xml nella directory dei file di download per ogni server da cui raccoglie i dati. È possibile visualizzare questi file insieme alle sottodirectory per ciascun server CUCM. Nei file TraceCollectionResult*.xml vengono indicati i file scaricati correttamente da ogni server. Le sottodirectory contengono i file di log e di traccia effettivi.
Aprire ogni file TraceCollectionResult e verificare se la data di modifica del file o dei file elencati corrisponde all'intervallo di data e ora della raccolta di tracce. Se, ad esempio, non è possibile raccogliere i file di traccia, questi vengono sovrascritti e quindi vengono persi.
Se conoscete le versioni precedenti di CUCM, questa versione differisce in quanto le tracce di Cisco CallManager sono un singolo set di tracce SDL*, non un set di tracce di SDL* e un set di tracce di CCM*. Ciò è dovuto al fatto che in CUCM 9.X e versioni successive le tracce vengono intrecciate in un unico set di file per semplificare l'analisi. Lo stesso vale per il servizio Cisco CTI Manager. Anziché le tracce di SDL* e le tracce di Cti*, tutti i dati sono presenti nelle tracce di SDL* per quel servizio.
I problemi di raccolta delle tracce possono in genere essere evitati se si raccolgono le tracce subito dopo la riproduzione di un problema.
Nota: i file TraceCollectionResult*.xml contengono semplicemente un elenco di file raccolti correttamente da ciascun server CUCM. TAC deve esaminare i file di traccia e di registro effettivi raccolti.
Ora che si dispone di una serie completa di tracce per la chiamata di riproduzione del problema, è necessario inviarle al tecnico TAC.
Quando sono state scaricate le tracce, è stata specificata una nuova directory per il file di download. Questa directory ora contiene tutti i file di log e di traccia, nonché i file TraceCollectionResult*.xml. TAC richiede l'invio di tutto il contenuto della directory dei file di download, non solo di uno o due file.
Per semplificare questa operazione, caricare un singolo file .zip con lo strumento Case File Uploader:
Viene eseguito il reindirizzamento a una pagina di accesso. Eseguire l'accesso con il nome utente e la password CCO.
Viene aperto Case File Uploader.
Le tracce di Cisco CallManager/CTI Manager relative alla chiamata specifica possono essere analizzate dallo strumento Collaboration Solutions Analyzer (diagramma ladder/annotazioni/registri filtrati/firme diagnostiche). Consultare la documentazione relativa all'utilizzo dello strumento:
Revisione | Data di pubblicazione | Commenti |
---|---|---|
3.0 |
17-Feb-2023 |
Certificazione. |
2.0 |
14-Jul-2022 |
Revisione |
1.0 |
27-Oct-2016 |
Versione iniziale |