builtins

log

##set_builtins

Description

Cette action permet d'afficher et de modifier dynamiquement les niveaux de journalisation (logsFichiers chronologiques enregistrant les événements système, erreurs et activités d'exécution dans SAS Viya, essentiels pour le monitoring, le débogage et l'audit des services et des jobs.) de votre serveur CASMoteur analytique "in-memory" de SAS Viya. Il traite les données en parallèle (MPP) sur plusieurs nœuds pour offrir une puissance de calcul massive et une exécution ultra-rapide des actions.. C'est l'outil parfait pour jouer au détective quand votre code fait des siennes ! Vous pouvez cibler un spécifique et même propager vos changements de journalisation aux nouvelles sessions.

Syntaxe Officielle
builtins.log <result=results> <status=rc> /
level="ALL" | "DEBUG" | "ERROR" | "FATAL" | "INFO" | "NULL" | "OFF" | "TRACE" | "WARN",
logger="string",
newSessions=TRUE | FALSE,
onMain=TRUE | FALSE;

Paramètres Clés

Nom du paramètre Description
level Spécifie le niveau de journalisation à appliquer (ALL, DEBUG, ERROR, FATAL, INFO, NULL, OFF, TRACE, WARN). La valeur 'NULL' permet d'hériter du niveau défini par le logger parent.
logger Spécifie le nom exact du module interne ou du composant (logger) dont vous souhaitez modifier le niveau d'information.
newSessions Si défini sur TRUE, les futures sessions CAS hériteront de cette modification de configuration de log (par défaut: FALSE).
onMain Si défini sur TRUE, la modification du niveau de log sera également envoyée au contrôleur principal du serveur (par défaut: FALSE).

Préparation des données

Initialisation de session

Cette action gérant la configuration système de CAS, aucune table de données n'est nécessaire. On se contente d'initialiser la session.

1cas mySession sessopts=(metrics=true); PROC CAS; RUN; QUIT;

Exemples d'utilisation

Augmenter la verbosité des logs

Cet exemple montre comment passer le niveau de journalisation du composant des actions CAS en mode DEBUG. Idéal pour voir avec précision ce qui bouillonne sous le capot.

1PROC CAS; BUILTINS.log / logger="App.cas.actions" level="DEBUG"; RUN; QUIT;
Résultat Attendu :
Le journal (log) du serveur affichera désormais les messages de débogage pour toutes les actions exécutées dans la session courante.
Modification globale et persistante du niveau de log

Ici, on sort l'artillerie lourde : on active le niveau TRACE extrême pour un logger spécifique, et on propage ce réglage directement au contrôleur principal ainsi qu'à toutes les nouvelles sessions qui se connecteront.

1PROC CAS; BUILTINS.log / logger="App.cas.security" level="TRACE" newSessions=TRUE onMain=TRUE; RUN; QUIT;
Résultat Attendu :
Le niveau TRACE est appliqué globalement pour le logger de sécurité. Le nœud principal (contrôleur) et toutes les connexions futures généreront des logs ultra-détaillés pour ce module spécifique.
Sommaire