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).
In questo documento viene descritto come impostare e raccogliere tracce in Cisco Unified Contact Center Enterprise (CCE).
Cisco raccomanda la conoscenza dei seguenti argomenti:
Le informazioni fornite in questo documento si basano sulle seguenti versioni software:
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.
Sono disponibili diverse opzioni per raccogliere i log del client Finesse.
Save
il file per ulteriori analisi.Opzione 3: Console del browser Web
save
copiarlo.Save
come HAR con contenuto.Opzione 1: Tramite interfaccia utente - Servizi Web (richiesti) e registri aggiuntivi
save
.Nota: il metodo consigliato per raccogliere i log del server Cisco Finesse è tramite Secure Shell (SSH) e Secure File Transfer Protocol (SFTP). Questo metodo non consente solo di raccogliere i log dei servizi Web, ma anche tutti i log aggiuntivi come Fippa, openfire, Realm e Clientlogs.
Opzione 2: Tramite SSH e SFTP (Secure File Transfer Protocol) - Opzione consigliata
file get activelog desktop recurs compress reltime hours 2
Nota: questa pagina fornisce buone informazioni su CVP CallServer ed è molto utile per risolvere alcuni scenari.
7. Dopo aver riprodotto il problema, assicurarsi di ripristinare le tracce al livello predefinito. Selezionare com.dynamicsoft.DsLibs.DsUALibs dal server. Mgr menu a discesa nell'angolo superiore sinistro e impostarlo su errore.
In casi molto rari è necessario aumentare il livello delle tracce delle applicazioni server VXML. D'altra parte, si consiglia di non aumentarlo a meno che non sia richiesto da un tecnico Cisco.
Per raccogliere i log dell'applicazione del server VXML, passare alla directory dell'applicazione specifica nel server VXML, ad esempio: C:\Cisco\CVP\VXMLServer\applications\{nome dell'applicazione}\logs\ActivityLog\ e raccogliere i log attività.
Nella maggior parte dei casi, il livello predefinito delle tracce di OAMP e ORM è sufficiente per determinare la causa principale del problema. Tuttavia, se è necessario aumentare il livello delle tracce, eseguire questa azione nei passaggi seguenti:
omgr.traceMask=-1 omgr.logLevel=DEBUG org.hibernate.logLevel=DEBUG org.apache.logLevel=ERROR net.sf.ehcache.logLevel=ERROR
Informazioni sui livelli di traccia
Livello traccia |
Descrizione |
Livello log |
Maschera di traccia |
0 |
Installazione predefinita del prodotto. Impatto minimo o nullo sulle prestazioni. |
INFORMAZIONI |
Nessuna |
1 |
Messaggi di analisi meno dettagliati con un impatto ridotto sulle prestazioni. |
DEBUG |
CONFIGURAZIONE_PERIFERICA + |
2 |
Messaggi di analisi dettagliati con un impatto medio sulle prestazioni. |
DEBUG |
CONFIGURAZIONE_PERIFERICA + |
3 |
Messaggio di traccia dettagliato con impatto sulle prestazioni elevato. |
DEBUG |
CONFIGURAZIONE_PERIFERICA + |
4 |
Messaggio di analisi dettagliato con impatto molto elevato sulle prestazioni. |
DEBUG |
VARIE + |
5 |
Messaggio di traccia più dettagliato. |
DEBUG |
VARIE + |
In CVB, un file di traccia è un file di log che registra l'attività dei sottosistemi e dei passaggi del componente Cisco VB.
Cisco VB ha due componenti principali:
È possibile specificare i componenti per i quali si desidera raccogliere informazioni e il livello di informazioni che si desidera raccogliere.
I livelli di log si estendono da:
Avviso: Xdebugging5 non deve essere abilitato nel sistema di produzione caricato.
I log più comuni che è necessario raccogliere sono il motore. Il livello predefinito delle tracce per le tracce del motore CVB è sufficiente per risolvere la maggior parte dei problemi. Tuttavia, se è necessario modificare il livello delle tracce per uno scenario specifico, Cisco consiglia di utilizzare i profili di registro del sistema predefiniti.
Profili registro di sistema
Nome |
Scenario in cui è necessario attivare il profilo |
VVBpredefinito |
I registri generici sono abilitati. |
AppAdminVB |
Per problemi relativi all'amministrazione Web tramite AppAdmin, Cisco VB Serviceability e altre pagine Web. |
MediaVB |
Per problemi relativi alla configurazione o alla trasmissione dei supporti. |
VoiceBrowser VB |
Per i problemi relativi all'handle delle chiamate. |
MRCPVB |
Per problemi con ASR/TTS con interazione Cisco VB. |
CallControlVB |
Per i problemi relativi al segnale SIP, vengono pubblicati nel registro. |
save
il file e quindi fare clic su Apri.Opzione 2: tramite SSH e SFTP - Opzione consigliata
file get activelog /uccx/log/MIVR/*
#conf t
service timestamps debug datetime msec
service timestamps log datetime msec
service sequence-numbers
no logging console
no logging monitor
logging buffered 5000000 7
end
clear logging
Avviso: qualsiasi modifica apportata al software Cisco IOS® GW di produzione può causare un'interruzione dell'alimentazione.
logging <syslog server ip>
logging trap debugs
show proc cpu hist
Avviso: se l'utilizzo della CPU raggiunge il 70-80%, il rischio di un impatto sui servizi correlati alle prestazioni aumenta notevolmente. Pertanto, non abilitare i debug aggiuntivi se il GW raggiunge il 60%.
debug voip ccapi inout
debug ccsip mess
After you make the call and simulate the issue, stop the debugging:
#undebug all
term len 0
show ver
show run
show log
(cusp)> config
(cusp-config)> sip logging
(cusp)> trace enable
(cusp)> trace level debug component sip-wire
Raccogli i registri
username <userid> create
username <userid> password <password>
username <userid> group pfs-privusers
Cisco consiglia di impostare i livelli di traccia e raccogliere le tracce tramite il portale di Diagnostis Framework o gli strumenti CLI di sistema.
Nota: per ulteriori informazioni su Diagnostic Framework Portico e System CLI, visitare il capitolo Diagnostic tools della Guida alla manutenzione di Cisco Unified ICM/Contact Center Enterprise, versione 12.5(1).
Quando si risolvono i problemi relativi alla maggior parte degli scenari UCCE, se il livello predefinito delle tracce non fornisce informazioni sufficienti, impostare il livello delle tracce su 3 nei componenti richiesti (con alcune eccezioni).
Nota: per ulteriori informazioni, visitare la sezione Trace Level nella guida alla disponibilità di Cisco Unified ICM/Contact Center Enterprise, versione 12.5(1).
Ad esempio, se si risolvono i problemi relativi a Dialer in uscita, il livello delle tracce deve essere impostato sul livello 2 se Dialer è occupato.
Per CTISVR (CTISVR) il livello 2 e il livello 3 non impostano l'esatto livello del Registro di sistema consigliato da Cisco. Il registro di traccia consigliato per CTISVR è 0XF8.
Avvertenza: impostare il livello delle tracce sul livello 3 durante il tentativo di riprodurre il problema. Dopo la riproduzione del problema, impostare il livello di traccia predefinito. Prestare particolare attenzione quando si impostano le tracce JTAPIGW, poiché il livello 2 e il livello 3 impostano le tracce di livello basso e questo può causare un impatto sulle prestazioni. Impostare il livello 2 o il livello 3 in JTAPIGW durante il tempo di non produzione o in un ambiente lab.
Raccolta log
save
il file nel percorso desiderato.PCCE dispone di un proprio strumento per impostare i livelli di traccia. Non è applicabile agli ambienti UCCE in cui il Portico di Diagnostic Framework o la CLI di sistema sono i modi preferiti per abilitare e raccogliere i log.
Save
Il file zip si trova in un percorso appropriato.file get activelog /cuic/logs/cuic/*.* recurs compress reltime hours 1
file get activelog /cuic/logs/cuicsrvr/*.* recurs compress reltime hours 1
file get activelog tomcat/logs/*.* recurs compress
file get activelog livedata/logs/*.*
file get activelog ids/log/*.* recurs compress reltime days 1
Per CUIC:
Per LD:
Per IDS:
Per i servizi di piattaforma, in genere è consigliabile selezionare i registri di Tomcat e Visualizzatore eventi:
save
visualizzare i registri.Per avviare l'acquisizione, stabilire una sessione SSH sul server VOS da autenticare con l'account di amministratore della piattaforma.
1 bis. Sintassi dei comandi
Il comando è utils network capture
e la sintassi è:
Syntax:
utils network capture [options]
options optional
page,numeric,file fname,count num,size bytes,src addr,dest addr,port
num,host protocol addr
options are:
page
- pause output
numeric - show hosts as dotted IP
addresses
file fname - output the information to a file
Note: The file is saved in platform/cli/fname.cap
fname should not contain the "." character
count num - a
count of the number of packets to capture
Note: The maximum count
for the screen is 1000, for a file is 100000
size bytes -
the number of bytes of the packet to capture
Note: The maximum
number of bytes for the screen is 128
For a file it can be
any number or ALL
src addr - the source address of the
packet as a host name or IPV4 address
dest addr - the
destination address of the packet as a host name or IPV4 address
port
num - the port number of the packet (either src or dest)
host
protocol addr - the protocol should be one of the following:
ip/arp/rarp/all. The host address of the packet as a host name or IPV4
address. This option will display all packets to and from that address.
Note: If "host" is provided, do not provide "src" or "dest"
1 ter. Acquisisci tutti i traffici
Per un'acquisizione tipica, è possibile raccogliere TUTTI i pacchetti di tutte le dimensioni da e verso l'indirizzo ALL in un file di acquisizione denominato packets.cap. Per eseguire questa operazione, è sufficiente utilizzare la CLI di amministrazione utils network capture eth0 file packets count 100000 size all
1 quater. Acquisizione basata sul numero di porta
Per risolvere un problema di comunicazione con Cluster Manager, è possibile utilizzare l'opzione della porta per acquisire i dati in base a una porta specifica (8500).
Per ulteriori informazioni sui servizi che richiedono comunicazioni su ciascuna porta, consultare la guida all'uso delle porte TCP e UDP per la versione applicabile del rispettivo componente.
1 quinquies. Acquisizione basata su host
Per risolvere un problema relativo a VOS e a un host specifico, può essere necessario utilizzare l'opzione 'host' per filtrare il traffico da e verso un host specifico.
Può anche essere necessario escludere un determinato host, in questo caso utilizzare un punto interrogativo (!) davanti all'indirizzo IP. utils network capture eth0 file packets count 100000 size all host ip !10.1.1.1
Durante l'acquisizione viene riprodotto il sintomo o la condizione del problema in modo che i pacchetti necessari vengano inclusi nell'acquisizione. Se il problema è intermittente, può essere necessario eseguire l'acquisizione per un periodo di tempo esteso. Se l'acquisizione termina, è perché il buffer è pieno, riavviare l'acquisizione e l'acquisizione precedente viene rinominata automaticamente in modo da non perdere l'acquisizione precedente. Se l'acquisizione è necessaria per un lungo periodo di tempo, utilizzare una sessione di monitoraggio su uno switch per l'acquisizione a livello di rete.
Per interrompere la cattura, tenere premuto il tasto Control e premere C sulla tastiera. In questo modo, il processo di acquisizione viene terminato e non vengono aggiunti nuovi pacchetti al dump di acquisizione.
4 bis. Trasferire il file di acquisizione dalla CLI a un server SFTP
Usare il comando file get activelog platform/cli/packets.cap
per raccogliere il file packets.cap sul server SFTP.
In alternativa, per raccogliere tutti i file .cap memorizzati sul server, utilizzare 'file get activelog platform/cli/*.cap
Infine, immettere le informazioni relative all'IP/FQDN, alla porta, al nome utente, alla password e alla directory del server SFTP:
La CLI indica l'esito positivo o negativo del trasferimento di file al server SFTP.
4 ter. Utilizzare RTMT per trasferire un file di acquisizione su un PC locale.
Avviare RTMT. Se non è installato sul PC locale, installare la versione appropriata dalla pagina di amministrazione di VOS e accedere al menu Applicazioni->Plugin.
Fare clic su System, Trace & Log Central, quindi fare doppio clic su Collect Files. Fare clic su Avanti nel primo menu.
Nel secondo menu selezionare la casella di controllo Registri acquisizione pacchetti sul server su cui è stata eseguita l'acquisizione, quindi fare clic su Avanti.
Nella schermata finale scegliere un intervallo di tempo in cui è stata eseguita la cattura e una directory di download sul PC locale.
RTMT chiude la finestra e procede con la raccolta del file e l'archiviazione nel PC locale nel percorso specificato.
Revisione | Data di pubblicazione | Commenti |
---|---|---|
1.0 |
31-Aug-2022 |
Versione iniziale |