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 i vari log disponibili in NSO, il loro utilizzo e come abilitarli.
Per visualizzare, abilitare e impostare i registri, è necessario disporre dell'accesso all'ambiente host su cui è in esecuzione il servizio NSO, nonché dell'accesso alla CLI NSO e alla porta IPC NSO.
Cisco Crosswork Network Service Orchestrator (NSO) versione 6.4.1
Questo documento è stato redatto per le opzioni di registrazione disponibili a partire dalla versione 6.4 di NSO. Sebbene la maggior parte delle informazioni contenute in questo documento siano valide per più versioni, alcuni log possono essere stati deprecati o aggiunti rispetto alla versione in uso. Questo documento non copre la configurazione per l'esportazione dei log al di fuori del sistema NSO.
I comandi forniti in questo documento presuppongono un NSO di installazione del sistema che utilizza l'impostazione predefinita della directory. Nell'ambiente in uso, la posizione di alcuni file può variare.
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.
L'attivazione dei registri con un livello di dettaglio superiore può causare un aumento del carico e dei requisiti di spazio su disco per il server NSO. Questa considerazione è particolarmente utile per i log altamente attivi, ad esempio devel.log. L'attivazione del livello di dettaglio per brevi periodi di tempo durante la risoluzione dei problemi non rappresenta in genere un problema, ma quando si attiva il livello di dettaglio per periodi di tempo più lunghi, assicurarsi di tenere in considerazione le risorse e lo spazio su disco.
To generate a tech report for NSO, run the script at /opt/ncs/current/bin/ncs-collect-tech-report.
Options:--install-dir
: Specifica la directory per l'installazione dei file statici NCS, ad esempio l'opzione —install-dir del programma di installazione.
--full
: Raccoglie un backup ncs del sistema, semplificando la riproduzione degli errori da parte del supporto Cisco.
--num-debug-dumps
: Impostazione predefinita: 1. Genera uno snapshot di debug-dump. Per i casi in cui viene tenuta traccia delle perdite di risorse, ad esempio le perdite di memoria/descrittore del file, impostare questo valore su 3.
Opzioni consigliate:/opt/ncs/current/bin/ncs-collect-tech-report --num-debug-dumps 3
È possibile raccogliere e fornire separatamente un backup per limitare le dimensioni dei file del bundle in modo da facilitare il caricamento.
Il report tecnico viene generato nella directory corrente da cui viene eseguito lo script.
Nota: Un report tecnico raccoglie il contenuto della directory dei log NSO. Verificare che questa directory non contenga alcun report o backup tecnici precedenti alla generazione del nuovo report.
/opt/ncs/current/bin/ncs-backup
I backup vengono generati in /var/opt/ncs/backups/.
Quando un file di registro viene archiviato o eliminato, NSO deve creare un nuovo file. In genere ciò si verifica automaticamente ma, in caso contrario, utilizzare il comando:/opt/ncs/current/bin/ncs_cmd -c reopen_logs
.
Nota: Quando si limita l'accesso alla porta IPC, ad esempio utilizzando l'impostazione ipc-access nel file ncs.conf, assicurarsi di definire le variabili necessarie come parte di cron o anacron in modo che la rotazione settimanale dei registri possa riaprire correttamente i registri.
Affinché Linux generi un dump di base, è necessario che siano soddisfatte alcune condizioni. La configurazione massima è l'impostazione più comune che impedisce un dump. Vedere Pagina Manuale Linux per un elenco completo dei requisiti
Nota: I registri di sistema non vengono raccolti dal rapporto tecnico NCS, ma possono essere utili per problemi di prestazioni e di crash.
Nota: La modifica delle impostazioni di configurazione nel file ncs.conf viene applicata eseguendo il ncs --reload
comando. ncs --reload, it
ricarica i valori dal file ncs.conf e aggiorna il sistema in esecuzione, oltre a chiudere e riaprire tutti i file di registro in modo da applicare le modifiche di registrazione. Ciò non interrompe i servizi.
/opt/ncs/current/src/ncs/ncs_config/tailf-ncs-config.yang
file.logs container
, che indica tra
e
nel file ncs.conf. Questo registro è attivato per impostazione predefinita. Per attivare questo registro, aprire /etc/ncs/ncs.conf e modificare il contenuto di <ncs-log>.
true
${NCS_LOG_DIR}/ncs.log
true
Dopo aver modificato ncs.conf, eseguite ncs —reload.
Questo registro è attivato per impostazione predefinita. Per attivare questo registro, aprire /etc/ncs/ncs.conf e modificare il contenuto di <audit-log>.
true
${NCS_LOG_DIR}/audit.log
true
Dopo aver modificato ncs.conf, eseguite ncs —reload.
Per impostazione predefinita, questo registro non è attivato. Per attivare questo registro, aprire /etc/ncs/ncs.conf e aggiungere il contenuto dopo <audit-log>.
true
${NCS_LOG_DIR}/audit.log
true
true
true
Dopo aver modificato ncs.conf, eseguite ncs —reload.
Per impostazione predefinita, questo registro è attivato al livello di dettaglio INFO. Per attivare e modificare il livello di dettaglio per questo registro, aprire /etc/ncs/ncs.conf e modificare il contenuto di <developer-log>.
true
${NCS_LOG_DIR}/devel.log
true
trace
Dopo aver modificato ncs.conf, eseguite ncs —reload.
Per impostazione predefinita, questo registro è attivato al livello di dettaglio INFO. È possibile impostare il livello di dettaglio per singoli elementi gestiti da Java-vm. Il livello di dettaglio viene modificato dalla CLI di NSO a cui è possibile accedere tramite SSH o ncs_cli -C -noaa
Per aumentare il livello di dettaglio in tutti gli elementi java in com.tailf:
config
java-vm java-logging logger com.tailf level-trace
eseguire il commit senza connessione di rete
Per aumentare il livello di dettaglio per un pacchetto END specifico:
config
java-vm java-logging logger com.tailf.packages.end.<NED-name> level-trace
eseguire il commit senza connessione di rete
Per aumentare il livello di dettaglio per il client SSHJ utilizzato nei pacchetti Java NED:
config
java-vm java-logging logger net.schmizz.sshj level-error
eseguire il commit senza connessione di rete
Nota: Cisco consiglia di impostare la registrazione per il client SSHJ su errore di livello. Per impostazione predefinita, è disabilitato.
Per ripristinare la registrazione di un elemento Java specifico:
config
no java-vm java-logging logger com.tailf
eseguire il commit senza connessione di rete
Per visualizzare le impostazioni di registrazione della Java VM corrente:
show running-config java-vm java-logging
Per impostazione predefinita, questo registro è attivato al livello di dettaglio INFO. Il livello di dettaglio viene modificato dalla CLI di NSO a cui è possibile accedere tramite SSH o ncs_cli -C -noaa.
Per impostare il livello di dettaglio per i log di tutte le VM Python.
config
debug livello di registrazione python-vm
eseguire il commit senza connessione di rete
Per tornare indietro:
config
no python-vm logging level-debug
eseguire il commit senza connessione di rete
Per visualizzare le impostazioni di registrazione correnti della macchina virtuale Python:
show running-config python-vm logging
Questo registro è attivato per impostazione predefinita. Per abilitare questo registro, aprire /etc/ncs/ncs.conf e modificare il contenuto di <upgrade-log>.
true
${NCS_LOG_DIR}/upgrade.log
true
Dopo aver modificato ncs.conf, eseguite ncs —reload.
Per impostazione predefinita, questo registro è attivato al livello di dettaglio INFO. Per attivare e impostare il livello di dettaglio per questo registro, aprire /etc/ncs/ncs.conf e modificare il contenuto di <raft-log>.
true
${NCS_LOG_DIR}/raft.log
true
trace
Dopo aver modificato ncs.conf, eseguite ncs —reload.
Per impostazione predefinita, questo registro non è attivato. Per attivare questo registro, aprire /etc/ncs/ncs.conf e modificare il contenuto di <xpath-trace-log>.
true
${NCS_LOG_DIR}/xpath.trace
Dopo aver modificato ncs.conf, eseguite ncs —reload.
In questo registro viene registrata una quantità limitata di informazioni. NSO mantiene 5 file di errore, ciascuno con una dimensione massima di 1 MB per impostazione predefinita. Nelle rare situazioni in cui si verifica un problema che crea più di 5 MB di dati di registro, è necessario aumentare le dimensioni massime. Questo registro è attivato per impostazione predefinita. Per modificare le dimensioni massime di questo registro a 10 MB per file, aprire /etc/ncs/ncs.conf e modificare il contenuto di <error-log>.
true
${NCS_LOG_DIR}/ncserr.log
S10M
Dopo aver modificato ncs.conf, eseguite ncs —reload.
Per impostazione predefinita, questo registro non è attivato, ma lo è in ncs.conf alla prima installazione. Per abilitare questo registro, aprire /etc/ncs/ncs.conf e modificare il contenuto di <transaction-error-log>.
true
${NCS_LOG_DIR}/transerr.log
Dopo aver modificato ncs.conf, eseguite ncs —reload.
Per impostazione predefinita, questo registro non è attivato, ma lo è in ncs.conf alla prima installazione. Per abilitare questo registro, aprire /etc/ncs/ncs.conf e modificare il contenuto di <progress-trace>.
true
${NCS_LOG_DIR}
Dopo aver modificato ncs.conf, eseguite ncs —reload.
Per impostazione predefinita, questo registro non è attivato. Il registro è abilitato dalla CLI di NSO a cui è possibile accedere tramite SSH o ncs_cli -C -noaaa. Per abilitare questo registro:
config
smart-license smart-agent stdout-capture abilitata
eseguire il commit senza connessione di rete
Per annullare la modifica della registrazione:
config
nessuna acquisizione stdout smart-agent smart-license abilitata
eseguire il commit senza connessione di rete
Questo registro è attivato per impostazione predefinita. Il nome di questo registro varia in base alla porta HTTP. Per impostazione predefinita, 8080 e 8888. Per abilitare questo registro, aprire /etc/ncs/ncs.conf e modificare il contenuto di <webui-access-log>.
true
${NCS_LOG_DIR}
Dopo aver modificato ncs.conf, eseguite ncs —reload.
Per impostazione predefinita, questo registro non è attivato. i registri traffic.trace vengono generati in una directory quale /var/log/ncs/trace_20240628_010010/. Per abilitare questo registro, aprire /etc/ncs/ncs.conf e modificare il contenuto di <webui-access-log>.
true
${NCS_LOG_DIR}
true
Dopo aver modificato ncs.conf, eseguite ncs —reload.
Questo registro è attivato per impostazione predefinita. Per abilitare questo registro, aprire /etc/ncs/ncs.conf e aggiungere il contenuto dopo <netconf-log>.
true
${NCS_LOG_DIR}/netconf.log
true
Dopo aver modificato ncs.conf, eseguite ncs —reload
Opzione aggiuntiva: Inserire
dopo che NSO registri lo stato di rpc-reply "ok" o "error".
Per impostazione predefinita, questo registro non è attivato. Per abilitare questo registro, aprire /etc/ncs/ncs.conf e modificare il contenuto di <netconf-trace-log>.
true
${NCS_LOG_DIR}/netconf-trace.log
Dopo aver modificato ncs.conf, eseguite ncs —reload.
Per impostazione predefinita, questo registro non è attivato. Per attivare questo registro, aprire /etc/ncs/ncs.conf e aggiungere il contenuto dopo <jsonrpc-log>.
true
${NCS_LOG_DIR}/json-rpc.log
true
Dopo aver modificato ncs.conf, eseguite ncs —reload.
Per impostazione predefinita, questo registro non è attivato. Il registro è abilitato dalla CLI di NSO a cui è possibile accedere tramite SSH o ncs_cli -C -noaaa.
Per abilitare una traccia per un dispositivo:
config
device device device <nomeperiferica> trace raw
device device <nomeperiferica> end-setting <id-finale> logger level debug
eseguire il commit senza connessione di rete
Per visualizzare tutte le impostazioni di registro applicate a un dispositivo, utilizzare show devices <nomedispositivo> active-settings.
Per cancellare il contenuto di un file di traccia del dispositivo, utilizzare devices device <nomedispositivo> clear-trace.
Per disabilitare la traccia del dispositivo:
config
nessuna traccia di device device <devicename>
eseguire il commit senza connessione di rete
Per impostazione predefinita, questo registro non è attivato. Per attivare questo registro, aprire /etc/ncs/ncs.conf e aggiungere il contenuto dopo <audit-network-log>.
true
${NCS_LOG_DIR}/audit-network.log
true
Dopo aver modificato ncs.conf, eseguite ncs —reload.
Revisione | Data di pubblicazione | Commenti |
---|---|---|
2.0 |
04-Jun-2025 |
Sezione traccia dispositivo corretta/migliorata |
1.0 |
01-Apr-2025 |
Versione iniziale |