Workspace Server : Mode trace et débogage SAS/ACCESS Interface to Hadoop

Par défaut, les workspace servers ne sont pas configurés à l'origine pour générer des fichiers journaux. Cependant, vous devrez peut-être capturer les messages du serveur d'espace de travail dans un fichier journal à des fins de dépannage. Dans ces situations, vous pouvez utiliser le fichier de configuration de journalisation alternatif (logconfig.trace.xml) fourni dans le répertoire de configuration de chaque serveur d'espace de travail. La configuration alternative fournit des messages de journalisation de haut niveau (par exemple, les messages DEBUG et TRACE) Les étapes suivantes permettent d'activer les traces du Workspace Server et log4j pour déboguer efficacement des problèmes de connexion ou de performance lors de l'utilisation de SAS/ACCESS Interface to hadoopFramework open-source permettant le stockage distribué (HDFS) et le traitement de données massives sur des clusters de serveurs, souvent utilisé avec SAS Viya pour l'analyse Big Data..

a) Fermer la sessionInstance de connexion active entre un client et le serveur CAS (Cloud Analytic Services), isolant les ressources, les bibliothèques et les traitements d'un utilisateur au sein de SAS Viya. Enterprise Guide de l'utilisateur utilisé pour votre test.

b) Sur le serveur SAS, modifier le paramétrage du Workspace Server pour passer en mode trace.  Cette modification nécessite l'ajout de  l’option LOGCONFIGLOC dans le fichier sasv9_usermods.cfg du seWorkspace Server pour pointer vers le chemin et le nom du fichier du fichier de configuration de journalisation alternatif.

L'ensemble des instructions sont accessibles dans la documentation suivante : https://tinyurl.com/EnableWorkspaceLogSAS9

Attention : N'utilisez ni ne modifiez les fichiers de configuration de journalisation logconfig.trace.xml à moins que le support technique SAS ne vous le demande. En effet, des problèmes de performances peuvent résulter de l'utilisation de ces fichiers.

c) Pour l'activation des traces Java, télécharger le fichier debuglog4j.properties et copier ce fichier sur le serveur. Puis ajouter la ligne suivante dans le fichier sasv9_usermods.cfg :

-jreoptions "-Dlog4j.configuration=file:/opt/sas/install/SASFoundation/9.4/bin/sas.log4j.properties"

d) Après ces deux étapes de configuration, votre fichier doit contenir (à minima) les deux lignes suivantes :

e) Lancer une nouvelle sessionInstance de connexion active entre un client et le serveur CAS (Cloud Analytic Services), isolant les ressources, les bibliothèques et les traitements d'un utilisateur au sein de SAS Viya. Enterprise Guide avec l'utilisateur utilisé pour votre test.

f) Avant de reproduire le problème à tester, dans une nouvelle fenêtre de programme, exécuter le code ci-dessous :

 options sastraceSASTRACE est une option système de diagnostic qui permet de tracer en temps réel les échanges entre SAS et les bases de données externes (via les moteurs SAS/ACCESS). Elle révèle les requêtes SQL exactes générées par SAS et envoyées aux systèmes sources comme Snowflake, Google BigQuery, Oracle ou Azure SQL.

Dans l'écosystème SAS Viya 4, SASTRACE est crucial pour valider l'Implicit Pass-Through : il permet de confirmer si les calculs sont bien exécutés directement dans la base de données (In-Database) ou si les données sont inutilement rapatriées vers le moteur CAS, optimisant ainsi les performances et les coûts cloud.='d,d,,dsa' sastraceloc=saslog nostsuffix sql_ip_trace=(note,source) msglevel=i fullstimer ;

g) Reproduire votre cas de test ( test d'initialisation de connexion, proc sql ....)

h) Sur le serveur, vérifier qu'une log est crée dans le répertoire /opt/sas/config/Lev1/SASApp/WorkspaceServer/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. et dans /tmp ( pour le fichier log4j)