El conjunto de documentos para este producto aspira al uso de un lenguaje no discriminatorio. A los fines de esta documentación, "no discriminatorio" se refiere al lenguaje que no implica discriminación por motivos de edad, discapacidad, género, identidad de raza, identidad étnica, orientación sexual, nivel socioeconómico e interseccionalidad. Puede haber excepciones en la documentación debido al lenguaje que se encuentra ya en las interfaces de usuario del software del producto, el lenguaje utilizado en función de la documentación de la RFP o el lenguaje utilizado por un producto de terceros al que se hace referencia. Obtenga más información sobre cómo Cisco utiliza el lenguaje inclusivo.
Cisco ha traducido este documento combinando la traducción automática y los recursos humanos a fin de ofrecer a nuestros usuarios en todo el mundo contenido en su propio idioma. Tenga en cuenta que incluso la mejor traducción automática podría no ser tan precisa como la proporcionada por un traductor profesional. Cisco Systems, Inc. no asume ninguna responsabilidad por la precisión de estas traducciones y recomienda remitirse siempre al documento original escrito en inglés (insertar vínculo URL).
Este documento describe los diversos registros disponibles en NSO, para qué se utilizan y cómo habilitarlos.
Para ver, habilitar y establecer registros, necesita un usuario con acceso al entorno host que ejecuta el servicio NSO, así como acceso al puerto NSO CLI y NSO IPC.
Cisco Crosswork Network Service Orchestrator (NSO) versión 6.4.1
Este documento se ha escrito para las opciones de registro disponibles a partir de NSO 6.4. Aunque la mayor parte de la información de este documento se aplica a todas las versiones, algunos registros pueden haberse dejado de utilizar o agregado en comparación con la versión que está utilizando. Este documento no cubre la configuración para exportar registros fuera del sistema NSO.
Los comandos proporcionados en este documento asumen que un NSO instalado en el sistema utiliza la configuración de directorio predeterminada. En su entorno, las ubicaciones de ciertos archivos pueden diferir.
La información que contiene este documento se creó a partir de los dispositivos en un ambiente de laboratorio específico. Todos los dispositivos que se utilizan en este documento se pusieron en funcionamiento con una configuración verificada (predeterminada). Si tiene una red en vivo, asegúrese de entender el posible impacto de cualquier comando.
La habilitación de registros con mayor detalle puede aumentar la carga y los requisitos de espacio en disco del servidor NSO. Esto se tiene especialmente en cuenta para los registros muy activos como devel.log. Habilitar la verbosidad durante breves períodos de tiempo durante la resolución de problemas no suele ser una preocupación, pero al habilitarlos durante períodos de tiempo más largos, asegúrese de tener en cuenta los recursos y el espacio en disco.
To generate a tech report for NSO, run the script at /opt/ncs/current/bin/ncs-collect-tech-report.
Opciones:--install-dir
: Especifica el directorio para la instalación de los archivos estáticos de NCS, como la opción —install-dir del instalador.
--full
: Recopila una copia de seguridad de ncs del sistema, lo que facilita al equipo de soporte técnico de Cisco reproducir los errores.
--num-debug-dumps
: Predeterminado 1, Genera una instantánea de debug-dump. Para los casos que rastrean fugas de recursos, como fugas de memoria/descriptor de archivo, establezca esto en 3.
Opciones recomendadas:/opt/ncs/current/bin/ncs-collect-tech-report --num-debug-dumps 3
Se puede recopilar una copia de seguridad y proporcionarla por separado para limitar el tamaño de archivo del paquete y facilitar así las cargas.
El informe técnico se genera en el directorio actual desde el que se ejecuta el script.
Nota: Un informe técnico recopila el contenido del directorio de registro de NSO. Verifique que este directorio no contenga informes técnicos o copias de seguridad anteriores antes de generar su nuevo informe técnico.
/opt/ncs/current/bin/ncs-backup
Los backups se generan en /var/opt/ncs/backups/.
Cuando se archiva o elimina un archivo de registro, NSO necesita crear un nuevo archivo. Por lo general, esto sucede automáticamente, pero en caso de que no lo hiciera, utilice el comando:/opt/ncs/current/bin/ncs_cmd -c reopen_logs
.
Nota: Al restringir el acceso al puerto IPC, por ejemplo, usando la configuración ipc-access en ncs.conf, asegúrese de definir las variables necesarias como parte de cron o anacron para que la rotación de registros semanal pueda volver a abrir correctamente los registros.
Se deben cumplir ciertas condiciones para que Linux genere un vaciado de memoria. La configuración ulimit es el parámetro más común que impide un volcado. Consulte la Página de Manual de Linux para obtener una lista completa de los requisitos
Nota: El informe técnico de NCS no recopila los registros del sistema, pero pueden ser útiles para problemas relacionados con el rendimiento y el desperfecto.
Nota: Los cambios en los parámetros de configuración del archivo ncs.conf se aplican mediante la ejecución del ncs --reload
comando. ncs --reload, it
vuelve a cargar los valores del archivo ncs.conf y actualiza el sistema en ejecución, así como cierra y vuelve a abrir todos los archivos de registro para que se apliquen los cambios de registro. Esto no interrumpe los servicios.
/opt/ncs/current/src/ncs/ncs_config/tailf-ncs-config.yang
archivo.logs container
, es decir, entre
y
en el archivo ncs.conf. Este registro está activado de forma predeterminada. Para habilitar este registro, abra /etc/ncs/ncs.conf y cambie el contenido de <ncs-log>.
true
${NCS_LOG_DIR}/ncs.log
true
Después de editar ncs.conf, ejecute ncs —reload.
Este registro está activado de forma predeterminada. Para habilitar este registro, abra /etc/ncs/ncs.conf y cambie el contenido de <audit-log>.
true
${NCS_LOG_DIR}/audit.log
true
Después de editar ncs.conf, ejecute ncs —reload.
Este registro no está habilitado de forma predeterminada. Para habilitar este registro, abra /etc/ncs/ncs.conf y agregue el contenido después de <audit-log>.
true
${NCS_LOG_DIR}/audit.log
true
true
true
Después de editar ncs.conf, ejecute ncs —reload.
Este registro está habilitado de forma predeterminada en información detallada. Para habilitar y cambiar el nivel de detalle de este registro, abra /etc/ncs/ncs.conf y cambie el contenido de <developer-log>.
true
${NCS_LOG_DIR}/devel.log
true
trace
Después de editar ncs.conf, ejecute ncs —reload.
Este registro está habilitado de forma predeterminada en información detallada. Es posible establecer la verbosidad de los elementos individuales administrados por java-vm. La verbosidad se altera desde la CLI de NSO, a la que se puede acceder a través de SSH o ncs_cli -C -noaaa
Para aumentar la verbosidad de todos los elementos de Java en com.tailf:
config
java-vm java-logging logger com.tailf level level-trace
commit no-networking
Para aumentar el detalle de un paquete NED específico:
config
java-vm java-logging logger com.tailf.packages.ned.<NED-name> level-trace
commit no-networking
Para aumentar la verbosidad del cliente SSHJ utilizado en los paquetes NED de Java:
config
java-vm java-logging logger net.schmizz.sshj level level-error
commit no-networking
Nota: Cisco recomienda configurar el registro para el cliente SSHJ en error de nivel. Está desactivada de forma predeterminada.
Para revertir el registro de un elemento Java específico:
config
no java-vm java-logging logger com.tailf
commit no-networking
Para ver la configuración de registro actual de java-vm:
show running-config java-vm java-logging
Este registro está habilitado de forma predeterminada en información detallada. La verbosidad se altera desde la CLI de NSO, a la que se puede acceder a través de SSH o ncs_cli -C -noaaa.
Para establecer la verbosidad de los registros de todas las VM de Python.
config
python-vm logging level level-debug
commit no-networking
Para retroceder:
config
no python-vm logging level level-debug
commit no-networking
Para ver la configuración de registro actual de python-vm:
show running-config python-vm logging
Este registro está activado de forma predeterminada. Para habilitar este registro, abra /etc/ncs/ncs.conf y cambie el contenido de <upgrade-log>.
true
${NCS_LOG_DIR}/upgrade.log
true
Después de editar ncs.conf, ejecute ncs —reload.
Este registro está habilitado de forma predeterminada en información detallada. Para habilitar y establecer la verbosidad de este registro, abra /etc/ncs/ncs.conf y cambie el contenido de <raft-log>.
true
${NCS_LOG_DIR}/raft.log
true
trace
Después de editar ncs.conf, ejecute ncs —reload.
Este registro no está habilitado de forma predeterminada. Para habilitar este registro, abra /etc/ncs/ncs.conf y cambie el contenido de <xpath-trace-log>.
true
${NCS_LOG_DIR}/xpath.trace
Después de editar ncs.conf, ejecute ncs —reload.
Este registro registra una cantidad limitada de información. NSO mantiene 5 archivos de error, cada uno con un tamaño máximo de 1 MB de forma predeterminada. En la rara situación en la que ocurre un problema que crea más de 5MB en los datos de registro, necesita aumentar el tamaño máximo. Este registro está activado de forma predeterminada. Para modificar el tamaño máximo de este registro a 10 MB por archivo, abra /etc/ncs/ncs.conf y cambie el contenido de <error-log>.
true
${NCS_LOG_DIR}/ncserr.log
S10M
Después de editar ncs.conf, ejecute ncs —reload.
Este registro no está habilitado de forma predeterminada, pero sí en ncs.conf en la primera instalación. Para habilitar este registro, abra /etc/ncs/ncs.conf y cambie el contenido de <transaction-error-log>.
true
${NCS_LOG_DIR}/transerr.log
Después de editar ncs.conf, ejecute ncs —reload.
Este registro no está habilitado de forma predeterminada, pero sí en ncs.conf en la primera instalación. Para habilitar este registro, abra /etc/ncs/ncs.conf y cambie el contenido de <progress-trace>.
true
${NCS_LOG_DIR}
Después de editar ncs.conf, ejecute ncs —reload.
Este registro no está habilitado de forma predeterminada. El registro se habilita desde la CLI de NSO, a la que se puede acceder a través de SSH o ncs_cli -C -noaaa. Para habilitar este registro:
config
smart-license smart-agent stdout-capture enabled
commit no-networking
Para revertir el cambio de registro:
config
no smart-license smart-agent stdout-capture enabled
commit no-networking
Este registro está activado de forma predeterminada. El nombre de este registro varía según el puerto HTTP. De forma predeterminada, 8080 y 8888. Para habilitar este registro, abra /etc/ncs/ncs.conf y cambie el contenido de <webui-access-log>.
true
${NCS_LOG_DIR}
Después de editar ncs.conf, ejecute ncs —reload.
Este registro no está habilitado de forma predeterminada. los logs de traffic.trace se generan en un directorio como /var/log/ncs/trace_20240628_010010/. Para habilitar este registro, abra /etc/ncs/ncs.conf y cambie el contenido de <webui-access-log>.
true
${NCS_LOG_DIR}
true
Después de editar ncs.conf, ejecute ncs —reload.
Este registro está activado de forma predeterminada. Para habilitar este registro, abra /etc/ncs/ncs.conf y agregue el contenido después de <netconf-log>.
true
${NCS_LOG_DIR}/netconf.log
true
Después de editar ncs.conf, ejecute ncs —reload
Opción adicional: Inserte
después de para que NSO registre el estado de respuesta rpc "ok" o "error".
Este registro no está habilitado de forma predeterminada. Para habilitar este registro, abra /etc/ncs/ncs.conf y cambie el contenido de <netconf-trace-log>.
true
${NCS_LOG_DIR}/netconf-trace.log
Después de editar ncs.conf, ejecute ncs —reload.
Este registro no está habilitado de forma predeterminada. Para habilitar este registro, abra /etc/ncs/ncs.conf y agregue el contenido después de <jsonrpc-log>.
true
${NCS_LOG_DIR}/json-rpc.log
true
Después de editar ncs.conf, ejecute ncs —reload.
Este registro no está habilitado de forma predeterminada. El registro se habilita desde la CLI de NSO, a la que se puede acceder a través de SSH o ncs_cli -C -noaaa.
Para habilitar un seguimiento para un dispositivo:
config
devices device <devicename> trace raw
devices device <devicename> end-setting <ned-id> logger level debug
commit no-networking
Para ver todas las configuraciones de registro aplicadas a un dispositivo, utilice show devices device <devicename> active-settings.
Para borrar el contenido de un archivo de seguimiento de dispositivos, utilice devices device <devicename> clear-trace.
Para deshabilitar el seguimiento de dispositivos:
config
no devices device <devicename> trace
commit no-networking
Este registro no está habilitado de forma predeterminada. Para habilitar este registro, abra /etc/ncs/ncs.conf y agregue el contenido después de <audit-network-log>.
true
${NCS_LOG_DIR}/audit-network.log
true
Después de editar ncs.conf, ejecute ncs —reload.
Revisión | Fecha de publicación | Comentarios |
---|---|---|
2.0 |
04-Jun-2025 |
Se ha corregido o mejorado la sección de seguimiento de dispositivos |
1.0 |
01-Apr-2025 |
Versión inicial |