Dans le cadre de la documentation associée à ce produit, nous nous efforçons d’utiliser un langage exempt de préjugés. Dans cet ensemble de documents, le langage exempt de discrimination renvoie à une langue qui exclut la discrimination en fonction de l’âge, des handicaps, du genre, de l’appartenance raciale de l’identité ethnique, de l’orientation sexuelle, de la situation socio-économique et de l’intersectionnalité. Des exceptions peuvent s’appliquer dans les documents si le langage est codé en dur dans les interfaces utilisateurs du produit logiciel, si le langage utilisé est basé sur la documentation RFP ou si le langage utilisé provient d’un produit tiers référencé. Découvrez comment Cisco utilise le langage inclusif.
Cisco a traduit ce document en traduction automatisée vérifiée par une personne dans le cadre d’un service mondial permettant à nos utilisateurs d’obtenir le contenu d’assistance dans leur propre langue. Il convient cependant de noter que même la meilleure traduction automatisée ne sera pas aussi précise que celle fournie par un traducteur professionnel.
Ce document décrit les différents journaux disponibles dans NSO, à quoi ils servent et comment les activer.
Pour afficher, activer et définir des journaux, vous devez disposer d'un utilisateur ayant accès à l'environnement hôte exécutant le service NSO, ainsi qu'à l'interface de ligne de commande NSO et au port NSO IPC.
Cisco Crosswork Network Service Orchestrator (NSO) version 6.4.1
Ce document a été écrit pour les options de journalisation disponibles depuis NSO 6.4. Bien que la plupart des informations de ce document s'appliquent à toutes les versions, certains journaux peuvent avoir été désapprouvés ou ajoutés par rapport à la version que vous utilisez. Ce document ne couvre pas la configuration pour exporter des journaux en dehors du système NSO.
Les commandes fournies dans ce document supposent un NSO d'installation du système utilisant la configuration de répertoire par défaut. Dans votre environnement, l'emplacement de certains fichiers peut varier.
The information in this document was created from the devices in a specific lab environment. All of the devices used in this document started with a cleared (default) configuration. Si votre réseau est en ligne, assurez-vous de bien comprendre l’incidence possible des commandes.
L'activation de journaux à un niveau de détail plus élevé peut entraîner une augmentation de la charge et des besoins en espace disque pour le serveur NSO. Ceci est particulièrement important pour les journaux très actifs tels que devel.log. L'activation du verbosité pendant de courtes périodes au cours du dépannage n'est généralement pas une préoccupation, mais lorsque vous l'activez pendant de plus longues périodes, assurez-vous de prendre en compte les ressources et l'espace disque.
To generate a tech report for NSO, run the script at /opt/ncs/current/bin/ncs-collect-tech-report.
Options:--install-dir
: Spécifie le répertoire d'installation des fichiers statiques NCS, comme l'option —install-dir du programme d'installation.
--full
: Collecte une sauvegarde ncs du système, ce qui facilite la reproduction des erreurs par l'assistance Cisco.
--num-debug-dumps
: Par défaut 1, génère un instantané debug-dump. Pour les cas de suivi des fuites de ressources, telles que les fuites de mémoire/descripteur de fichier, définissez cette valeur sur 3.
Options recommandées :/opt/ncs/current/bin/ncs-collect-tech-report --num-debug-dumps 3
Une sauvegarde peut être collectée et fournie séparément pour limiter la taille de fichier de l'offre pour faciliter les téléchargements.
Le rapport technique est généré dans le répertoire courant à partir duquel le script est exécuté.
Remarque : Un rapport technique collecte le contenu du répertoire du journal NSO. Vérifiez que ce répertoire ne contient pas de rapports techniques ou de sauvegardes antérieurs avant de générer votre nouveau rapport technique.
/opt/ncs/current/bin/ncs-backup
Les sauvegardes sont générées dans /var/opt/ncs/backups/.
Lorsqu'un fichier journal est archivé ou supprimé, NSO doit créer un nouveau fichier. Généralement, cela se produit automatiquement, mais dans le cas contraire, utilisez la commande :/opt/ncs/current/bin/ncs_cmd -c reopen_logs
.
Remarque : Lorsque vous restreignez l'accès au port IPC, par exemple, en utilisant le paramètre ipc-access dans ncs.conf, assurez-vous de définir les variables nécessaires dans cron ou anacron afin que la rotation hebdomadaire des journaux puisse rouvrir correctement les journaux.
Certaines conditions doivent être remplies pour que Linux puisse générer un core dump. La configuration ulimit est le paramètre le plus courant pour empêcher un vidage. Voir la page du manuel Linux pour une liste complète des exigences
Remarque : Les journaux système ne sont pas collectés par le rapport technique NCS, mais ils peuvent être utiles pour les problèmes de performances et de panne.
Remarque : Pour modifier les paramètres de configuration dans le fichier ncs.conf, exécutez la ncs --reload
commande. ncs --reload, it
recharge les valeurs à partir du fichier ncs.conf et met à jour le système en cours d'exécution, puis ferme et rouvre tous les fichiers journaux afin que les modifications de journalisation soient appliquées. Cela n'interrompt pas les services.
/opt/ncs/current/src/ncs/ncs_config/tailf-ncs-config.yang
fichier.logs container
, c'est-à-dire entre
et
dans le fichier ncs.conf. Ce journal est activé par défaut. Pour activer ce journal, ouvrez /etc/ncs/ncs.conf et modifiez le contenu de <ncs-log>.
true
${NCS_LOG_DIR}/ncs.log
true
Après avoir édité ncs.conf, exécutez ncs —reload.
Ce journal est activé par défaut. Pour activer ce journal, ouvrez /etc/ncs/ncs.conf et modifiez le contenu de <audit-log>.
true
${NCS_LOG_DIR}/audit.log
true
Après avoir édité ncs.conf, exécutez ncs —reload.
Ce journal n'est pas activé par défaut. Pour activer ce journal, ouvrez /etc/ncs/ncs.conf et ajoutez le contenu après <audit-log>.
true
${NCS_LOG_DIR}/audit.log
true
true
true
Après avoir édité ncs.conf, exécutez ncs —reload.
Ce journal est activé par défaut à INFO verbosity. Pour activer et modifier le niveau de détail de ce journal, ouvrez /etc/ncs/ncs.conf et modifiez le contenu de <developer-log>.
true
${NCS_LOG_DIR}/devel.log
true
trace
Après avoir édité ncs.conf, exécutez ncs —reload.
Ce journal est activé par défaut à INFO verbosity. Il est possible de définir le niveau de détail des éléments individuels gérés par java-vm. Le niveau de détail est modifié à partir de l'interface de ligne de commande NSO qui est accessible via SSH ou ncs_cli -C -noaaa
Pour augmenter le niveau de détail de tous les éléments java sous com.tailf :
configuration
java-vm java-logging logger com.tailf level-trace
commit no-networking
Pour augmenter le niveau de détail d'un package NED spécifique :
configuration
java-vm java-logging logger com.tailf.packages.end.<NED-name> level-trace
commit no-networking
Pour augmenter le niveau de détail du client SSHJ utilisé dans les paquets java NED :
configuration
java-vm java-logging logger net.schmizz.sshj level-error
commit no-networking
Remarque : Cisco recommande de définir la journalisation du client SSHJ sur level-error. Elle est désactivée par défaut.
Pour rétablir la journalisation d'un élément Java spécifique :
configuration
no java-vm java-logging logger com.tailf
commit no-networking
Pour afficher les paramètres de journalisation actuels de java-vm :
show running-config java-vm java-logging
Ce journal est activé par défaut à INFO verbosity. Le niveau de détail est modifié à partir de l'interface de ligne de commande NSO qui est accessible via SSH ou ncs_cli -C -noaaa.
Pour définir le niveau de détail des journaux de toutes les machines virtuelles Python.
configuration
python-vm logging level-debug
commit no-networking
Pour revenir en arrière :
configuration
no python-vm logging level-debug
commit no-networking
Pour afficher les paramètres de journalisation python-vm actuels :
show running-config python-vm logging
Ce journal est activé par défaut. Pour activer ce journal, ouvrez /etc/ncs/ncs.conf et modifiez le contenu de <upgrade-log>.
true
${NCS_LOG_DIR}/upgrade.log
true
Après avoir édité ncs.conf, exécutez ncs —reload.
Ce journal est activé par défaut à INFO verbosity. Pour activer et définir le niveau de détail de ce journal, ouvrez /etc/ncs/ncs.conf et modifiez le contenu de <raft-log>.
true
${NCS_LOG_DIR}/raft.log
true
trace
Après avoir édité ncs.conf, exécutez ncs —reload.
Ce journal n'est pas activé par défaut. Pour activer ce journal, ouvrez /etc/ncs/ncs.conf et modifiez le contenu de <xpath-trace-log>.
true
${NCS_LOG_DIR}/xpath.trace
Après avoir édité ncs.conf, exécutez ncs —reload.
Ce journal enregistre une quantité limitée d'informations. NSO gère 5 fichiers d'erreur, chacun avec une taille maximale de 1 Mo par défaut. Dans les rares cas où un problème se produit qui crée plus de 5 Mo de données de journal, vous devez augmenter la taille maximale. Ce journal est activé par défaut. Pour modifier la taille maximale de ce journal à 10 Mo par fichier, ouvrez /etc/ncs/ncs.conf et modifiez le contenu de <error-log>.
true
${NCS_LOG_DIR}/ncserr.log
S10M
Après avoir édité ncs.conf, exécutez ncs —reload.
Ce journal n'est pas activé par défaut, mais activé dans ncs.conf lors de la première installation. Pour activer ce journal, ouvrez /etc/ncs/ncs.conf et modifiez le contenu de <transaction-error-log>.
true
${NCS_LOG_DIR}/transerr.log
Après avoir édité ncs.conf, exécutez ncs —reload.
Ce journal n'est pas activé par défaut, mais activé dans ncs.conf lors de la première installation. Pour activer ce journal, ouvrez /etc/ncs/ncs.conf et modifiez le contenu de <progress-trace>.
true
${NCS_LOG_DIR}
Après avoir édité ncs.conf, exécutez ncs —reload.
Ce journal n'est pas activé par défaut. Le journal est activé à partir de l'interface de ligne de commande NSO qui est accessible via SSH ou ncs_cli -C -noaaa. Pour activer ce journal :
configuration
smart-license smart-agent stdout-capture activée
commit no-networking
Pour annuler la modification de journalisation :
configuration
aucune licence smart smart-agent stdout-capture activée
commit no-networking
Ce journal est activé par défaut. Le nom de ce journal varie en fonction du port HTTP. Par défaut, 8080 et 8888. Pour activer ce journal, ouvrez /etc/ncs/ncs.conf et modifiez le contenu de <webui-access-log>.
true
${NCS_LOG_DIR}
Après avoir édité ncs.conf, exécutez ncs —reload.
Ce journal n'est pas activé par défaut. traffic.trace les journaux sont générés dans un répertoire tel que /var/log/ncs/trace_20240628_010010/. Pour activer ce journal, ouvrez /etc/ncs/ncs.conf et modifiez le contenu de <webui-access-log>.
true
${NCS_LOG_DIR}
true
Après avoir édité ncs.conf, exécutez ncs —reload.
Ce journal est activé par défaut. Pour activer ce journal, ouvrez /etc/ncs/ncs.conf et ajoutez le contenu après <netconf-log>.
true
${NCS_LOG_DIR}/netconf.log
true
Après avoir modifié ncs.conf, exécutez ncs —reload
Option supplémentaire : Insérez
après pour que NSO consigne l'état de la réponse rpc « ok » ou « error ».
Ce journal n'est pas activé par défaut. Pour activer ce journal, ouvrez /etc/ncs/ncs.conf et modifiez le contenu de <netconf-trace-log>.
true
${NCS_LOG_DIR}/netconf-trace.log
Après avoir édité ncs.conf, exécutez ncs —reload.
Ce journal n'est pas activé par défaut. Pour activer ce journal, ouvrez /etc/ncs/ncs.conf et ajoutez le contenu après <jsonrpc-log>.
true
${NCS_LOG_DIR}/json-rpc.log
true
Après avoir édité ncs.conf, exécutez ncs —reload.
Ce journal n'est pas activé par défaut. Le journal est activé à partir de l'interface de ligne de commande NSO qui est accessible via SSH ou ncs_cli -C -noaaa.
Pour activer un suivi pour un périphérique :
configuration
périphériques périphérique <nompériphérique> trace raw
périphériques périphérique <nompériphérique> paramètre de fin <id-fin> niveau de l'enregistreur debug
commit no-networking
Pour afficher tous les paramètres de journalisation appliqués à un périphérique, utilisez show devices device <nompériphérique> active-settings.
Pour effacer le contenu d'un fichier de suivi de périphérique, utilisez devices device <nom du périphérique> clear-trace.
Pour désactiver la trace du périphérique :
configuration
no devices device <nompériphérique> trace
commit no-networking
Ce journal n'est pas activé par défaut. Pour activer ce journal, ouvrez /etc/ncs/ncs.conf et ajoutez le contenu après <audit-network-log>.
true
${NCS_LOG_DIR}/audit-network.log
true
Après avoir édité ncs.conf, exécutez ncs —reload.
Révision | Date de publication | Commentaires |
---|---|---|
2.0 |
04-Jun-2025 |
Correction/amélioration de la section de suivi du périphérique |
1.0 |
01-Apr-2025 |
Première publication |