We apologize for untranslated text, you can use the Google Translation button to get an automatic translation of the web page in the language of your choice.

Module d'envoi de logs par email

Description

Le module d’envoi de récapitulatifs de log permet aux administrateurs techniques de paramétrer la réception de récapitulatifs de log par e-mail à des groupes de membres identifiés.


Installation

Ce module a été réalisé par WISEN, expert sur les solutions Jalios.

Pour télécharger ce module, rendez-vous sur cette page.

Ajouter ce module avec le gestionnaire de modules depuis l’administration technique et redémarrer l'application.

Expertise Web sur-mesure

Présentation

Le module d’envoi de récapitulatifs de log permet aux administrateurs techniques de paramétrer la réception de récapitulatifs de log par e-mail à des groupes de membres identifiés.

Ces logs seront envoyés dans le corps du mail, dans un fichier en pièce-jointe ou seront accessible par un lien de téléchargement (en fonction des propriétés réglées en BackOffice et d’un poids maximum de pièce-jointe).

Il permet de choisir les niveaux de log désirés (du plus au moins fin dans l’analyse) :

  • TRACE : utilisé par exemple pour journaliser l'entrée ou la sortie d'une méthode
  • DEBUG : utilisé pour générer des messages pouvant être utiles au débogage
  • INFO : utilisé pour journaliser des messages à caractère informatif (nom des fichiers, etc.)
  • WARN : utilisé pour journaliser un avertissement, il peut s'agir par exemple d'une incohérence dans la configuration, l'application peut continuer à fonctionner mais pas forcément de la façon attendue
  • ERROR : utilisé pour journaliser une erreur qui n'empêche cependant pas l'application de fonctionner
  • FATAL : utilisé pour journaliser une erreur grave pouvant mener à l'arrêt prématuré de l'application

 

Ainsi que la fréquence de réception des emails récapitulatifs afin de suivre l’activité du site en continu :

  • Toutes les heures
  • Tous les jours
  • Toutes les semaines
  • Tous les mois

Un email est envoyé par niveau paramétré.

 

Exemple d’e-mail récapitulatif sur le niveau « FATAL » :

 

fatal

 

Exemple d’e-mail récapitulatif sur le niveau « ERROR » :

 error

 

Exemple d’e-mail sur le niveau « WARN » lorsque les logs sont trop volumineux :

 warn

 

Exemple d’e-mail sur le niveau « INFO » lorsque le fichier de logs est trop volumineux :

 Info

 

Exemple d’e-mail sur le niveau « TRACE » lorsqu’il n’y a aucun log trouvé :

 Trace

 

Pour rappel, en standard dans JPlateform, il est possible de récupérer les logs de la journée à tout moment depuis l’administration technique > Supervision > Journal des évènements (http://.../admin/logsDownload.jsp?zip=true) :

 journal des évènements

 

Informations techniques

Compatibilité JSync

Ce module est compatible jSync, il fonctionnera sans problème sur un environnement à plusieurs réplicas.

En revanche, il est important de noter que la configuration du module ne sera pas répliquée et sera à faire sur chaque nœud.

 

Compatibilité JDK

Ce module est compatible avec la version 1.7 de JDK (Java Development Kit). Si vous êtes sur la version 1.6 de JDK, contactez-nous.

 

Prérequis

Pour une meilleure compréhension et utilisation de ce module, il est conseillé d’avoir suivi les formations JPlateform suivantes :

  • Formation d’administrateur technique
  • Formation d’administrateur fonctionnel

 

Ce module ne dépend d’aucun autre module.

  

Paramétrage

Liste des propriétés

Editez le module pour paramétrer ou modifier ses propriétés :

 

Propriété

Nom technique Description

Niveau TRACE :

Date d’envoi du prochain email

jcmsplugin.logmailerplugin.1.email.trace.level

Indiquez dans cette propriété la date à laquelle vous souhaitez recevoir le premier e-mail récapitulatif pour le niveau de log "TRACE".

Si vide ou inférieur à la date et heure actuelle, le niveau TRACE sera ignoré.

Fréquence d'envoi des emails

jcmsplugin.logmailerplugin.1.periodicity.trace.level

Choisissez dans le menu déroulant la valeur appropriée, selon que vous souhaitez recevoir le récapitulatif pour le niveau de log "TRACE" (toutes les heures, tous les jours, toutes les semaines ou tous les mois).

Si vide, le niveau TRACE sera ignoré.

Groupe destinataire

jcmsplugin.logmailerplugin.1.recipient.grp.id

Choisissez le groupe destinataire de l’email envoyé contenant les logs de ce niveau.

Si vide, le mail ne sera pas envoyé.

Recevoir les emails uniquement s'il y a des nouveaux logs

jcmsplugin.logmailerplugin.1.sending.only.with.log

Mettez à « Non » si vous ne souhaitez pas recevoir d’email s’il n’y a aucun log remonté à ce niveau pour la fréquence sélectionnée.

Format de réception

jcmsplugin.logmailerplugin.1.sending.type

Choisissez l'option appropriée selon que vous souhaitez recevoir le récapitulatif de log dans le corps de l'e-mail, dans un fichier en pièce jointe ou en fichier zip téléchargeable via un lien présent dans le l’email.

Si vide, le récapitulatif sera dans le corps de l'email*.

Niveau DEBUG :

Date d’envoi du prochain email

jcmsplugin.logmailerplugin.2.email.trace.level

Indiquez dans cette propriété la date à laquelle vous souhaitez recevoir le premier e-mail récapitulatif pour le niveau de log "DEBUG".

Si vide ou inférieur à la date et heure actuelle, le niveau DEBUG sera ignoré.

Fréquence d'envoi des emails

jcmsplugin.logmailerplugin.2.periodicity.trace.level

Choisissez dans le menu déroulant la valeur appropriée, selon que vous souhaitez recevoir le récapitulatif pour le niveau de log "DEBUG" toutes les heures, tous les jours, toutes les semaines ou tous les mois.

Si vide, le niveau DEBUG sera ignoré.

Groupe destinataire

jcmsplugin.logmailerplugin.2.recipient.grp.id

Choisissez le groupe destinataire de l’email envoyé contenant les logs de ce niveau.

Si vide, le mail ne sera pas envoyé.

Recevoir les emails uniquement s'il y a des nouveaux logs

jcmsplugin.logmailerplugin.2.sending.only.with.log

Mettez à « Non » si vous ne souhaitez pas recevoir d’email s’il n’y a aucun log remonté à ce niveau pour la fréquence sélectionnée.

Format de réception

jcmsplugin.logmailerplugin.2.sending.type

Choisissez l'option appropriée selon que vous souhaitez recevoir le récapitulatif de log dans le corps de l'e-mail, dans un fichier en pièce jointe ou en fichier zip téléchargeable via un lien présent dans le l’email.

Si vide, le récapitulatif sera dans le corps de l'email*.

Niveau INFO :

Date d’envoi du prochain email

jcmsplugin.logmailerplugin.3.email.trace.level

Indiquez dans cette propriété la date à laquelle vous souhaitez recevoir le premier e-mail récapitulatif pour le niveau de log "INFO".

Si vide ou inférieur à la date et heure actuelle, le niveau INFO sera ignoré.

Fréquence d'envoi des emails

jcmsplugin.logmailerplugin.3.periodicity.trace.level

Choisissez dans le menu déroulant la valeur appropriée, selon que vous souhaitez recevoir le récapitulatif pour le niveau de log "INFO" toutes les heures, tous les jours, toutes les semaines ou tous les mois.

Si vide, le niveau INFO sera ignoré.

Groupe destinataire

jcmsplugin.logmailerplugin.3.recipient.grp.id

Choisissez le groupe destinataire de l’email envoyé contenant les logs de ce niveau.

Si vide, le mail ne sera pas envoyé.

Recevoir les emails uniquement s'il y a des nouveaux logs

jcmsplugin.logmailerplugin.3.sending.only.with.log

Mettez à « Non » si vous ne souhaitez pas recevoir d’email s’il n’y a aucun log remonté à ce niveau pour la fréquence sélectionnée.

Format de réception

jcmsplugin.logmailerplugin.3.sending.type

Choisissez l'option appropriée selon que vous souhaitez recevoir le récapitulatif de log dans le corps de l'e-mail, dans un fichier en pièce jointe ou en fichier zip téléchargeable via un lien présent dans le l’email.

Si vide, le récapitulatif sera dans le corps de l'email*.

Niveau WARN :

Date d’envoi du prochain email

jcmsplugin.logmailerplugin.4.email.trace.level

Indiquez dans cette propriété la date à laquelle vous souhaitez recevoir le premier e-mail récapitulatif pour le niveau de log "WARN".
Si vide ou inférieur à la date et heure actuelle, le niveau WARN sera ignoré.

Fréquence d'envoi des emails

jcmsplugin.logmailerplugin.4.periodicity.trace.level

Choisissez dans le menu déroulant la valeur appropriée, selon que vous souhaitez recevoir le récapitulatif pour le niveau de log "WARN" toutes les heures, tous les jours, toutes les semaines ou tous les mois.

Si vide, le niveau WARN sera ignoré.

Groupe destinataire

jcmsplugin.logmailerplugin.4.recipient.grp.id

Choisissez le groupe destinataire de l’email envoyé contenant les logs de ce niveau.

Si vide, le mail ne sera pas envoyé.

Recevoir les emails uniquement s'il y a des nouveaux logs

jcmsplugin.logmailerplugin.4.sending.only.with.log

Mettez à « Non » si vous ne souhaitez pas recevoir d’email s’il n’y a aucun log remonté à ce niveau pour la fréquence sélectionnée.

Format de réception

jcmsplugin.logmailerplugin.4.sending.type

Choisissez l'option appropriée selon que vous souhaitez recevoir le récapitulatif de log dans le corps de l'e-mail, dans un fichier en pièce jointe ou en fichier zip téléchargeable via un lien présent dans le l’email.

Si vide, le récapitulatif sera dans le corps de l'email*.

Niveau ERROR :

Date d’envoi du prochain email

jcmsplugin.logmailerplugin.5.email.trace.level

Indiquez dans cette propriété la date à laquelle vous souhaitez recevoir le premier e-mail récapitulatif pour le niveau de log "ERROR".

Si vide ou inférieur à la date et heure actuelle, le niveau ERROR sera ignoré

Fréquence d'envoi des emails

jcmsplugin.logmailerplugin.5.periodicity.trace.level

Choisissez dans le menu déroulant la valeur appropriée, selon que vous souhaitez recevoir le récapitulatif pour le niveau de log "ERROR" toutes les heures, tous les jours, toutes les semaines ou tous les mois.

Si vide, le niveau ERROR sera ignoré.

Groupe destinataire

jcmsplugin.logmailerplugin.5.recipient.grp.id

Choisissez le groupe destinataire de l’email envoyé contenant les logs de ce niveau.

Si vide, le mail ne sera pas envoyé.

Recevoir les emails uniquement s'il y a des nouveaux logs

jcmsplugin.logmailerplugin.5.sending.only.with.log

Mettez à « Non » si vous ne souhaitez pas recevoir d’email s’il n’y a aucun log remonté à ce niveau pour la fréquence sélectionnée.

Format de réception

jcmsplugin.logmailerplugin.5.sending.type

Choisissez l'option appropriée selon que vous souhaitez recevoir le récapitulatif de log dans le corps de l'e-mail, dans un fichier en pièce jointe ou en fichier zip téléchargeable via un lien présent dans le l’email.

Si vide, le récapitulatif sera dans le corps de l'email*.

Niveau FATAL :

Date d’envoi du prochain email

jcmsplugin.logmailerplugin.6.email.trace.level

Indiquez dans cette propriété la date à laquelle vous souhaitez recevoir le premier e-mail récapitulatif pour le niveau de log "FATAL".

Si vide ou inférieur à la date et heure actuelle, le niveau FATAL sera ignoré.

Fréquence d'envoi des emails

jcmsplugin.logmailerplugin.6.periodicity.trace.level

Choisissez dans le menu déroulant la valeur appropriée, selon que vous souhaitez recevoir le récapitulatif pour le niveau de log "FATAL" toutes les heures, tous les jours, toutes les semaines ou tous les mois.

Si vide, le niveau FATAL sera ignoré.

Groupe destinataire

jcmsplugin.logmailerplugin.6.recipient.grp.id

Choisissez le groupe destinataire de l’email envoyé contenant les logs de ce niveau.

Si vide, le mail ne sera pas envoyé.

Recevoir les emails uniquement s'il y a des nouveaux logs

jcmsplugin.logmailerplugin.6.sending.only.with.log

Mettez à « Non » si vous ne souhaitez pas recevoir d’email s’il n’y a aucun log remonté à ce niveau pour la fréquence sélectionnée.

Format de réception

jcmsplugin.logmailerplugin.6.sending.type

Choisissez l'option appropriée selon que vous souhaitez recevoir le récapitulatif de log dans le corps de l'e-mail, dans un fichier en pièce jointe ou en fichier zip téléchargeable via un lien présent dans le l’email.

Si vide, le récapitulatif sera dans le corps de l'email*.

Autres propriétés :

Volume des données avant la création d'un fichier

jcmsplugin.logmailerplugin.7.other.create.file.size

Si le récapitulatif est paramétré pour être dans le corps de l'e-mail et que le volume des données dépasse la valeur de cette propriété, alors les logs seront en pièces jointes.

Valeur par défaut : 90Ko

Taille du fichier avant compression de celui-ci

jcmsplugin.logmailerplugin.8.other.create.zip.size

Si le récapitulatif est paramétré pour être dans le corps de l'e-mail ou dans un fichier et que le volume des données dépasse la valeur de cette propriété, alors un lien de téléchargement sera présent dans l'e-mail.

Valeur par défaut : 10Mo

*sauf si la taille limite avant la création d’un fichier ou compression a été atteinte

 

Enregistrement des nouvelles propriétés

Les changements de valeur des propriétés sont pris en compte directement lors de l'enregistrement sans avoir besoin de redémarrer l'application.


FAQ

1. Comment arrêter de recevoir des récapitulatifs pour un niveau de log ?

Il suffit de laisser les propriétés relatives à ce niveau de log à vide.

2. Où sont stockés les fichiers compressés et pour combien de temps ?

Les fichiers de logs compressés sont automatiquement stockés dans un répertoire du serveur : « […]/WEB-INF/data/zippedsummarylog ». Les fichiers compressés sont automatiquement supprimés le premier jour du sixième mois suivant sa création, à 4h du matin.

3. Les e-mails réceptionnés sont trop nombreux et trop lourds, comment épargner nos boîtes mails ?

Plusieurs solutions sont possibles à travers ce module.

  • Pour diminuer le poids des fichiers envoyés en pièce jointe par e-mails, plusieurs solutions :
  • Diminuer la valeur du champ Taille du fichier avant compression de celui-ci pour limiter la taille maximum du fichier de log envoyé par email
  • Définir le format de réception en « Lien de téléchargement » pour chaque niveau pour que les fichiers de logs soient systématiquement compressés et envoyés sous la forme d’un lien de téléchargement cliquable depuis l’e-mail récapitulatif.
  • Pour diminuer le nombre d’emails envoyés :
  • S’assurer que la valeur « Recevoir les emails uniquement s'il y a des nouveaux logs » est bien à « Oui »
  • Diminuer la fréquence d'envoi des emails
  • Paramétrer différents groupes destinataires pour répartir l’envoi des emails si vous êtes plusieurs et que les différents niveaux ne concernent pas les mêmes personnes dans votre organisation
  • Laisser les valeurs vides pour les niveaux pour lesquels vous ne souhaitez pas recevoir de logs

Information

Version
  • 1.1
Stability
  • Stable
Compatibility
  • JCMS 9
Certified by Jalios
  • No
Price
  • Module gratuit
Support
  • Non supporté
Author
  • WISEN
License
  • Propriétaire
Size
  • 1 KB
Updated
  • 3/14/17
Download
  • 22
Domains