Les logs de l’application SenSaaS sont gérés par la bibliothèque NLog, une solution flexible et performante pour la gestion des journaux d’événements. Pour activer les logs, il est nécessaire de configurer correctement le fichier dédié. Voici les étapes détaillées pour activer et configurer les logs de votre application.

Amélioration en V1.0.5.7+

La gestion des logs a été simplifiée et est désormais paramétrable depuis l'onglet "Configuration" du connecteur à partir de la version 1.0.5.7.

Le redémarrage du service SenSaaS reste nécessaire afin que le connecteur ai connaissance des changements apportés à sa configuration.

NOTE : Il est fortement recommandé de laisser la case à cocher "Log du serveur Web" décochée et de paramétrer le niveau de logs en "Trace".
La période de rétention, réglée sur 7 jours par défaut, peut être modifiée à votre guise. Ce paramètre permet à la fois de régler le nombre de fichiers de logs "d'archives" mais également leur durée dans le temps.

Ainsi, cela permettra, en cas de demandes de support, de fournir des fichiers de logs épurés tout en contenant suffisamment d'informations exploitables par les membres du support.

Anciennes manipulations pour activer les logs (V1.0.5.6 ou antérieur)

1. Localiser le fichier de configuration
   Par défaut, le fichier de configuration des logs se trouve dans le dossier d’installation de votre application :

   C:\Program Files (x86)\Optima Concept\Serveur Sensaas
   

2. Renommer le fichier de configuration
   Dans ce dossier, vous trouverez un fichier nommé NLog.config.example. Pour activer les logs :

   • Renommez ce fichier en NLog.config.
   • Assurez-vous que l’extension est correctement changée et qu’il ne reste pas .example.

3. Configurer les chemins d’enregistrement des logs
   Ouvrez le fichier NLog.config dans un éditeur de texte (par exemple, Notepad ou un éditeur comme VS Code). Localisez les paramètres suivants :

   • fileName: Spécifie l’emplacement principal où les logs seront enregistrés.
   • archiveFileName: Indique l’emplacement des fichiers archivés.

   Exemple de configuration à modifier :

     fileName="C:/SenSaaS/logs/Log.current.txt"
     ...
     archiveFileName="C:/SenSaaS/logs/archives/Logs.SenSaaS.{#}.txt"
   

4. ⚠️ Important : Les chemins définis dans fileName et archiveFileName doivent pointer vers un répertoire accessible en local et avec des droits d’écriture suffisants.

5. Redémarrer l’application
   Après avoir sauvegardé les modifications dans NLog.config, redémarrez votre application pour que les changements soient pris en compte.

Ressources utiles

Pour en savoir plus sur la configuration avancée de NLog (par exemple, gestion des niveaux de logs, destinations multiples, ou formatage personnalisé), vous pouvez consulter la documentation officielle de NLog :

• Configuration NLog
  
• Documentation officielle de NLog

En suivant ces étapes, les logs de l’application seront correctement activés et enregistrés, vous permettant d’effectuer un suivi efficace des événements et de diagnostiquer d’éventuels problèmes.
L'équipe du Support SenSaaS, ou tout intervenant lié au produit, sera amené à demander ce ou ces fichiers en cas de besoin, souvent accompagné d'une demande de reproduction de l'anomalie si cette dernière n'est pas présente dans ces derniers. Si cela est le cas, merci de fournir les fichiers au complet en tant que pièces jointes aux tickets de supports ou aux mails. Copier le contenu et le coller en tant que corps d'un ticket/mail peut générer des tickets volumineux, et certains éléments présents dans le fichier de logs peuvent ne pas être reportés après la copie, entraînant ainsi des difficultés d'analyse de ce fichier.