(Facultatif) Activer la journalisation du plugin Session Manager

Le plugin Session Manager inclut une option permettant d'activer la journalisation pour les sessions que vous exécutez. Par défaut, la journalisation est désactivée.

Si vous activez la journalisation, le plugin Session Manager crée des fichiers journaux relatifs à l'activité de l'application (session-manager-plugin.log) et aux erreurs (errors.log) sur votre ordinateur local.

Activation de la journalisation pour le plug-in Session Manager (Windows)

1. Recherchez le fichier seelog.xml.template du plug-in.

   L'emplacement par défaut est C:\Program Files\Amazon\SessionManagerPlugin\seelog.xml.template.

2. Remplacez le nom du fichier par seelog.xml.

3. Ouvrez le fichier et remplacez minlevel="off" par minlevel="info" ou minlevel="debug".

   Note

   Par défaut, les entrées de journaux sur l'ouverture d'un canal de données et les reconnexions aux sessions sont enregistrées au niveau INFO. Les entrées de flux de données (paquets et accusé de réception) sont enregistrées au niveau DEBUG.

4. Modifiez les autres options de configuration que vous souhaitez modifier. Vous pouvez modifier les options suivantes :

   • Niveau de débogage : vous pouvez remplacer le niveau de débogage de formatid="fmtinfo" par formatid="fmtdebug".

   • Options des fichiers journaux : vous pouvez modifier les options des fichiers journaux, y compris l'emplacement de stockage des journaux, à l'exception des noms des fichiers journaux.

     Important

     Ne modifiez pas les noms de fichier, la journalisation ne fonctionnerait pas correctement.

     <rollingfile type="size" filename="C:\Program Files\Amazon\SessionManagerPlugin\Logs\session-manager-plugin.log" maxsize="30000000" maxrolls="5"/>
     <filter levels="error,critical" formatid="fmterror">
     <rollingfile type="size" filename="C:\Program Files\Amazon\SessionManagerPlugin\Logs\errors.log" maxsize="10000000" maxrolls="5"/>

5. Sauvegardez le fichier.

Activation de la journalisation pour le plug-in Session Manager (Linux et macOS)

1. Recherchez le fichier seelog.xml.template du plug-in.

   L'emplacement par défaut est /usr/local/sessionmanagerplugin/seelog.xml.template.

2. Remplacez le nom du fichier par seelog.xml.

3. Ouvrez le fichier et remplacez minlevel="off" par minlevel="info" ou minlevel="debug".

   Note

   Par défaut, les entrées de journaux sur l'ouverture de canaux de données et les reconnexions aux sessions sont enregistrées au niveau INFO. Les entrées de flux de données (paquets et accusé de réception) sont enregistrées au niveau DEBUG.

4. Modifiez les autres options de configuration que vous souhaitez modifier. Vous pouvez modifier les options suivantes :

   • Niveau de débogage : vous pouvez remplacer le niveau de débogage de formatid="fmtinfo" par outputs formatid="fmtdebug".

   • Options des fichiers journaux : vous pouvez modifier les options des fichiers journaux, y compris l'emplacement de stockage des journaux, à l'exception des noms des fichiers journaux.

     Important

     Ne modifiez pas les noms de fichier, la journalisation ne fonctionnerait pas correctement.

     <rollingfile type="size" filename="/usr/local/sessionmanagerplugin/logs/session-manager-plugin.log" maxsize="30000000" maxrolls="5"/>
     <filter levels="error,critical" formatid="fmterror">
     <rollingfile type="size" filename="/usr/local/sessionmanagerplugin/logs/errors.log" maxsize="10000000" maxrolls="5"/>

     Important

     Si vous utilisez le répertoire par défaut spécifié pour le stockage des journaux, vous devez exécuter des commandes de session à l'aide de la commande sudo ou accorder au répertoire dans lequel le plug-in est installé, des autorisations complètes de lecture et d'écriture. Pour contourner ces restrictions, modifiez l'emplacement de stockage des journaux.

5. Sauvegardez le fichier.