Comparaison des versions

Légende

  • Ces lignes ont été ajoutées. Ce mot a été ajouté.
  • Ces lignes ont été supprimées. Ce mot a été supprimé.
  • La mise en forme a été modifiée.
Commentaire: Published by Scroll Versions from space DA and version BM-3.5
Les traces générées par Java dans
Sv translation
languagefr

Présentation

BlueMind conserve des journaux pour chaque type d'application et d'utilisation.

On distingue 3 types de fichiers journaux :

  • les journaux systèmes, gérés par le mécanisme de gestion des journaux systèmes (rsyslog + logrotate)
  • Avertissement

    Il est important de fournir l'espace disque suffisant afin de pouvoir stocker les journaux et leurs archives.

    La saturation de cet espace bloque l'enregistrement des nouvelles informations dans les fichiers journaux et peut provoquer un ralentissement, voire un blocage des services.

    les journaux des services Java de BlueMind, gérés par LogBack

    Volet

    Sur cette page :

    Sommaire
    maxLevel2

    En rapport :

    Applications et Composants
    Logs - Fichiers journaux

    Configuration des logs

    On distingue 3 types de fichiers journaux :

    • les journaux systèmes, gérés par le mécanisme de gestion des journaux systèmes (rsyslog + logrotate)
    • les journaux des services Java de BlueMind, gérés par LogBack

      Remarque
      titleHeures des traces

      Les traces générées par Java dans

    Remarque
    titleHeures

    ces fichiers sont à l'heure GMT.

    Ainsi, en France, sur le fuseau horaire Europe/Paris, les heures sont décalées d'1h en hiver et 2h en été. Pour rechercher des événements qui se sont produits à 15h il faudra rechercher :

    • à 14h de fin Octobre à fin Mars
    • à 13h de fin Mars à fin Octobre
  • les journaux internes à un service, gérés via la configuration de ce service
  • La durée de conservation dépend du paramétrage de ces mécanismes de gestion des journaux. Il est possible de modifier leur configuration pour obtenir la durée de rétention souhaitée.

    Avertissement

    Il est important de fournir l'espace disque suffisant afin de pouvoir stocker les journaux et leurs archives.

    La saturation de cet espace bloque l'enregistrement des nouvelles informations dans les fichiers journaux et peut provoquer un ralentissement, voire un bloquage des services.

    Les fichiers de logs

    Les fichiers de logs

    Les fichiers journaux se Les fichiers journaux se trouvent dans le dossier /var/log et ses sous-dossiers

    ComposantNom du paquetFichier de logTypeDescription
    BlueMind Corebm-core

    ./bm/ :

    • core.log
    LogBack
    • mail-index.log
    • slow-call.log

    ./bm/audit/ :

    • audit-calendar*.log
    LogBack

    Service principal de BlueMind :

    Service principal de BlueMind :

    • gestion du contenu de la base de données, implémentation des règles métier
    • ...
    • indexation des mails lors de l’exécution des tâches de réindexation
    • requêtes ayant pris plus de 200 ms à s’exécuter

    Audit :

    • Trace les actions réalisées dans le calendrier indiqué dans le nom du fichier : audit-calendar:<nom du calendrier>:<uid de l'utilisateur>.log
    Postfixpostfix

    RedHat : ./maillog

    Debian

    Postfixpostfix

    RedHat: ./maillog

    Debian/Ubuntu :

    • ./mail.err
    • ./mail.info
    • ./mail.log
    • ./mail.warn
    Système

    Service de transfert des courriels Postfix qui permet l'acheminement des emails vers la boîte ou le serveur des destinataires.

    Cyrusbm-cyrus-imapd

    RedHat : ./maillog

    Debian/Ubuntu :

    • ./mail.err
    • ./mail.info
    • ./mail.log
    • ./mail.warn
    Système

    Service de gestion des boîtes aux lettres Cyrus IMAP. Permet de:

    • remettre un email dans la boîte correspondante et d'y accéder en IMAP et/ou POP.
    • filtrer les emails lors de leur réception
    • gérer le message d'absence
    • gérer les redirections
    Webmailbm-webmail./bm-webmail :
    • errors
    • sendmail
      mailSent.log
    LogBack


     

    • erreurs du service de webmail (RoundCube)
    • tracent les emails envoyés ainsi que les règles analysées sur ces messages (alias, redirection, etc.)
    Proxy IMAPbm-ips./bm-ips/ips.logLogBackTrace les opérations au niveau IMAP (déplacement, suppression, etc.), y compris lorsqu'elles sont effectuées depuis le webmail BlueMind
    Synchronisation EASbm-eas./bm-eas/eas.logLogBackTrace les opérations effectuées depuis et vers les appareils mobiles connectés en EAS.
    À noter que les logs pour chaque file de synchronisation sont stockés dans des fichiers séparés, afin de faciliter l'analyse de bugs ou d'un comportement inadéquat.
    Transfert de courrierbm-lmtpd./bm-lmtpd/lmtpd.logLogBack

    Service chargé de délivrer un email dans la boîte correspondante.

    Certaines opérations liées à BlueMind sont réalisées à ce niveau - l'analyse des invitations ICS par exemple.

    Localisationbm-locator

    ./bm-locator/locator.log

    LogBackLocalise les services associés à un utilisateur (serveur de boîte aux lettres, etc.)
    Identificationbm-node./bm-node/node.logLogBack

    Service permettant au serveur BM-Core d'exécuter des opérations systèmes sur les nœuds de l'architecture BlueMind.
    Le fichier log trace les commandes exécutées.

    BlueMind web serverbm-webserver./bm-webserver :
    • webserver.log
    • dav.log
    • js-errors.log
    • setup.log
    • webserver.log
    LogBack

    Répertoire contenant les fichiers de logs générés par le service webserver.

    Les
    • synchronisations des calendriers et agendas
    y sont notamment tracées
    • .
    • synchronisation via caldav/carddav
    • erreurs JS sur les applications web
    • mises à jour de BlueMind
    AuthentificationAuthentificationbm-hps./bm-hps/hps.logLogBackTrace les problèmes et réussites d'authentification et ouverture de session
    Tikabm-tika./bm-tika/tika.logLogBack

    Extraction des méta-données et données des documents permettant de renseigner l'index ES.
    Trace les erreurs d'extraction des informations à indexer.

    PHP FPMbm-php-fpm

    ./bm-php-fpm :

    • bm-php-fpm.log
    • slow.log
    LogBack

    Interpréteurs PHP.

    Le fichier slow.log contient les requêtes PHP ayant duré plus de 15s.

    ElasticSearchbm-elasticsearch./bm-elasticsearchInterne

    Logs du service ElasticSearch.

    Les fichiers *_slowlog.log contiennent les requêtes lentes.

    Les éventuelles modifications de configuration des logs de ce services pourront-être perdues suite à une mise à jour de BlueMind.

    Milterbm-milter./bm-milter/milter.logLogBackAnalyse et modification des emails au niveau SMTP
    XMPPbm-xmpp./bm-xmpp/xmpp.logLogBackLogs de la messagerie instantanée
    YSNPbm-ysnp./bm-ysnp/ysnp.logLogBack

    Service permettant à Postfix ou Cyrus d'obtenir ou valider certaines données auprès de BlueMind :

    • authentification SMTP et IMAP
    • résolution des ACLs IMAP
    • blocage du flux mail dans les cas où BlueMind est en maintenance ou mise à jour
    PostgreSQLbm-postgresql./postgresqlInterne+logrotate

    Logs de la base de données PostgreSQL

    Il est possible de modifier sa configuration via l'utilisation du fichier /etc/postgresql/9.6/main/postgresql.conf.local

    NGinxbm-nginx

    ./nginx :

    • access.log
    • error.log
    • webmail.log
    Interne+logrotate

    Le service NGinx permet l'accès en HTTP et HTTPs à BlueMind.

    • access.log contient l'ensemble des requête HTTP et HTTPs faites à BlueMind
    • error.log contient l'ensemble des requêtes HTTP et HTTPs en erreur ou dont le code retour indique une erreur (4xx, 5xx)
    • webmail.log contient l'ensemble des requêtes HTTP et HTTPs faites via le webmail en erreur ou dont le code retour indique une erreur (4xx, 5xx)

    Configuration LogBack

    Les fichiers de configuration par défaut se trouvent dans le répertoire /usr/share/bm-conf/logs/ :

    • bm-core-audit.log.xml
    • bm-core.log.xml
    • bm-eas.log.xml
    • bm-hps.log.xml
    • bm-ips.log.xml
    • bm-lmtpd.log.xml
    • bm-locator.log.xml
    • bm-milter.log.xml
    • bm-node.log.xml
    • bm-pimp.log.xml
    • bm-tika.log.xml
    • bm-webserver.log.xml
    • bm-xmpp.log.xml
    • bm-ysnp.log.xml

    Pour effectuer des modifications, copier le fichier souhaité dans /etc/bm/local et modifier la copie.

    Exemple de configuration :

    Bloc de code
    <appender name="R" class="ch.qos.logback.core.rolling.RollingFileAppender">
      <!--See also http://logback.qos.ch/manual/appenders.html#RollingFileAppender -->
      <File>/var/log/bm/core.log</File>
      <encoder>
        <pattern>%d [%thread] %c{1} %p - %m\n</pattern>
      </encoder>
      <rollingPolicy class="ch.qos.logback.core.rolling.FixedWindowRollingPolicy">
        <maxIndex>20</maxIndex>
        <FileNamePattern>/var/log/bm/core.log.%i.gz</FileNamePattern>
      </rollingPolicy>
      <triggeringPolicy class="ch.qos.logback.core.rolling.SizeBasedTriggeringPolicy">
        <MaxFileSize>60000KB</MaxFileSize>
      </triggeringPolicy>
    </appender

    L'exemple ci-dessus, concernant le fichier de log principal core.log permet de conserver 20 fichiers de logs de 60Mo maximum chacun.

    Pour plus d'information sur la configuration, vous pouvez consulter le site Log4j ou encore cette documentation : https://logback.qos.ch/manual/appenders.html#RollingFileAppender