builtins

log

Description

Affiche et modifie les niveaux de journalisation pour les différents composants du serveur CAS. C'est un outil essentiel pour le débogage et la surveillance du serveur, permettant d'ajuster dynamiquement la verbosité des messages enregistrés. Une utilisation incorrecte, comme l'activation de niveaux très détaillés (TRACE) sur des composants majeurs en production, peut impacter les performances.

builtins.log / level="ALL" | "DEBUG" | "ERROR" | "FATAL" | "INFO" | "NULL" | "OFF" | "TRACE" | "WARN" logger="nom-du-journal" <newSessions=TRUE | FALSE> <onMain=TRUE | FALSE>;
Paramètres
ParamètreDescription
levelSpécifie le niveau de journalisation à appliquer. Les niveaux sont hiérarchiques (de TRACE, le plus verbeux, à FATAL, le moins verbeux). OFF désactive complètement le journal.
loggerSpécifie le nom du composant de journalisation (logger) à modifier. Par exemple, 'App' pour les applications générales, 'Admin' pour les tâches administratives, ou 'AccessControl' pour la sécurité.
newSessionsSi la valeur est TRUE, le changement de niveau de journal s'appliquera également à toutes les nouvelles sessions CAS qui seront créées. Nécessite des privilèges d'administrateur.
onMainSi la valeur est TRUE, le changement de niveau de journal est également appliqué au processus du contrôleur principal du serveur CAS, et pas seulement aux processus workers. Nécessite des privilèges d'administrateur.

Exemples

Cette action permet de visualiser le niveau de journalisation actuel d'un logger spécifique sans le modifier. Si aucun niveau n'est spécifié, le niveau est hérité du logger parent.

Code SAS® / CAS Code en attente de validation par la communauté
Copié !
1PROC CAS; BUILTINS.log / logger="App.Table"; RUN;
Résultat :
Une table de résultats est affichée, indiquant le nom du logger, son niveau de journalisation actuel et son niveau effectif (qui peut être hérité d'un logger parent).

Cet exemple change le niveau de journalisation pour le logger 'App' au niveau 'Info'. Ce changement n'affecte que la session CAS actuelle.

Code SAS® / CAS Code en attente de validation par la communauté
Copié !
1 
2PROC CAS;
3BUILTINS.log / logger="App" level="Info";
4 
5RUN;
6 
Résultat :
Le niveau du logger 'App' est changé pour 'INFO'. Les messages de journalisation de niveau 'INFO', 'WARN', 'ERROR', et 'FATAL' seront désormais enregistrés pour ce logger.

Un administrateur peut modifier le niveau de journalisation pour un composant critique comme 'AccessControl' et faire en sorte que ce changement s'applique au contrôleur principal et à toutes les nouvelles sessions. C'est utile pour un débogage à l'échelle du serveur.

Code SAS® / CAS Code en attente de validation par la communauté
Copié !
1 
2PROC CAS;
3ACCESSCONTROL.assumeRole / adminRole="superuser";
4 
5RUN;
6BUILTINS.log / logger="AccessControl" level="Trace" newSessions=TRUE onMain=TRUE;
7 
8RUN;
9 
Résultat :
Le niveau de journalisation pour 'AccessControl' est réglé sur 'TRACE' pour l'ensemble du serveur CAS, y compris le contrôleur et toutes les futures sessions. Cela générera des journaux très détaillés pour les activités de contrôle d'accès.

FAQ

Quel est l'objectif de l'action `log` ?
Quels sont les principaux paramètres de l'action `log` ?
Comment peut-on appliquer un changement de journalisation à toutes les nouvelles sessions ?
Quels sont les niveaux de journalisation (levels) disponibles ?