Sv translation

language	fr

Présentation

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

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.

Volet

Sur cette page :

Sommaire

maxLevel	2

En rapport :

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

title	Heures des traces

Les traces générées par Java dans 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.

Les fichiers de logs

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

Composant	Nom du paquet	Fichier de log	Type	Description
BlueMind Core	bm-core	./bm/ : core.log mail-index.log slow-call.log ./bm/audit/ : audit-calendar*.log	LogBack	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
Postfix	postfix	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.
Cyrus	bm-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
Webmail	bm-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 IMAP	bm-ips	./bm-ips/ips.log	LogBack	Trace les opérations au niveau IMAP (déplacement, suppression, etc.), y compris lorsqu'elles sont effectuées depuis le webmail BlueMind
Synchronisation EAS	bm-eas	./bm-eas/eas.log	LogBack	Trace 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 courrier	bm-lmtpd	./bm-lmtpd/lmtpd.log	LogBack	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.
Localisation	bm-locator	./bm-locator/locator.log	LogBack	Localise les services associés à un utilisateur (serveur de boîte aux lettres, etc.)
Identification	bm-node	./bm-node/node.log	LogBack	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 server	bm-webserver	./bm-webserver : webserver.log dav.log js-errors.log setup.log	LogBack	Répertoire contenant les fichiers de logs générés par le service webserver. synchronisations des calendriers et agendas. synchronisation via caldav/carddav erreurs JS sur les applications web mises à jour de BlueMind
Authentification	bm-hps	./bm-hps/hps.log	LogBack	Trace les problèmes et réussites d'authentification et ouverture de session
Tika	bm-tika	./bm-tika/tika.log	LogBack	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 FPM	bm-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.
ElasticSearch	bm-elasticsearch	./bm-elasticsearch	Interne	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.
Milter	bm-milter	./bm-milter/milter.log	LogBack	Analyse et modification des emails au niveau SMTP
XMPP	bm-xmpp	./bm-xmpp/xmpp.log	LogBack	Logs de la messagerie instantanée
YSNP	bm-ysnp	./bm-ysnp/ysnp.log	LogBack	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
PostgreSQL	bm-postgresql	./postgresql	Interne+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
NGinx	bm-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)

Sv translation

language	en

Introduction

BlueMind keeps log files for each application and usage type.

Avertissement

It is important to provide for enough disk space to store log and archive files.

Space overload stops new information from being saved into log files and can lead to sluggish, and possibly blocked, services.

Volet

On this page:

Sommaire

maxLevel	2

Related:

Applications et Composants

There are 3 types of log files:

system logs, which rely on log administration mechanisms (rsyslog + logrotate)

BlueMind's Java services log, which rely on LogBack

Remarque

title	Track times

Java-generated tracks in these files are set to GMT.

As a result, in France, which is in the Europe/Paris time zone, times are +1h in the winter and +2h in the summer. To find items that took place at 15:00, you need to look for:

14:00 from late October to late March
13:00 from late March to late October

internal service logs, managed by each service's configuration.

Storage time depends on each log administration mechanism's settings. These settings can be changed to the desired storage time.

Log files

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

Component	Package Name	Log File	Type	Description
BlueMind Core	bm-core	./bm/core.log	LogBack	Main BlueMind service: manages database contents implements job rules ...
Postfix	postfix	RedHat: ./maillog Debian/Ubuntu: ./mail.err ./mail.info ./mail.log ./mail.warn	System	Postfix forwarding service which sends emails to recipients' mailbox or server.
Cyrus	bm-cyrus-imapd	RedHat: ./maillog Debian/Ubuntu: ./mail.err ./mail.info ./mail.log ./mail.warn	System	Cyrus IMAP mail service. Permet de: place an email in the corresponding mailbox and access it through IMAP and/or POP. filter emails on reception manage away message manage redirects
Webmail	bm-webmail	./bm-webmail/ : errors sendmail mailSent.log	LogBack	errors from the webmail service (Round Cube). keeps track of all sent messages as well as rules applied to these messages (alias, redirection, etc.).
Proxy IMAP	bm-ips	./bm-ips/ips.log	LogBack	Tracks IMAP operations (moved files, deletions, etc.), including when they are carried out from BlueMind webmail
Synchronisation EAS	bm-eas	./bm-eas/eas.log	LogBack	Tracks operations carried out to and from mobile devices connected through EAS. In addition, logs for each synchronization file are stored in separate files, which makes the analysis of bugs or erroneous behavior easier.
Mail forwarding	bm-lmtpd	./bm-lmtpd/lmtpd.log	LogBack	Service that delivers emails to the corresponding mailbox. Some BlueMind-related operations are carried out here - ICS invitation analysis, for example.
Localization	bm-locator	./bm-locator/locator.log	LogBack	Locate user-specific services (mailbox server, etc.)
Identification	bm-node	./bm-node/node.log	LogBack	Service that allows the BM-Core server to run system operations on the BlueMind architecture nodes. The log file tracks commands.
BlueMind web server	bm-webserver	./bm-webserver/ : dav.log js-errors.log setup.log webserver.log	LogBack	Directory containing log files generated by the webserver service. Includes calendar synchronization tracking.
Authentication	bm-hps	./bm-hps/hps.log	LogBack	Tracks successful authentications, authentication issues and sessions started
Tika	bm-tika	./bm-tika/tika.log	LogBack	Extracts metadata and document data for the ES index. Tracks information indexing extraction errors.
PHP FPM	bm-php-fpm	./bm-php-fpm: bm-php-fpm.log slow.log	LogBack	PHP interpreters. The `slow.log` file contains PHP requests longer than 15s.
ElasticSearch	bm-elasticsearch	./bm-elasticsearch	Interne	ElasticSearch service logs. `*_slowlog.log` files contain slow requests. Possible log configuration modifications to this service may be lost after a BlueMind update.
Milter	bm-milter	./bm-milter/milter.log	LogBack	SMTP analysis and modification of emails.
XMPP	bm-xmpp	./bm-xmpp/xmpp.log	LogBack	Instant messaging logs.
YSNP	bm-ysnp	./bm-ysnp/ysnp.log	LogBack	Service that allows Postfix or Cyrus to obtain or verify data with BlueMind: SMTP and IMAP authentication ACLs IMAP ACLs resolution blocks mail flows when BlueMind is under maintenance or being updated
PostgreSQL	bm-postgresql	./postgresql	Interne+logrotate	PostgreSQL database logs. This component's configuration can be edited using the file /etc/postgresql/9.6/main/postgresql.conf.local
NGinx	bm-nginx	./nginx: access.log error.log webmail.log	Interne+logrotate	The NGinx services allows HTTP and HTTPs access to BlueMind. `access.log` contains all HTTP and HTTPs requests made to BlueMind `error.log` contains all HTTP and HTTPs error requests or request whose return code shows an error (4xx, 5xx) `webmail.log` contains all HTTP and HTTPs requests made through webmail or error requests or requests whose return code shows an error (4xx, 5xx)

LogBack configuration

By default, configuration files are located in the directory /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

To edit them, copy the file you want to edit into /etc/bm/local and edit the copy.

Configuration example:

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

In the example above, the main log file core.log can keep 20 log files of 60Mb each at the most.

For more information about configuration, please refer to the site Log4j or the following documentation: https://logback.qos.ch/manual/appenders.html#RollingFileAppender

Enregistrer

Arborescence des pages

Comparaison des versions

Ancienne version 21

Nouvelle version 22

Légende

Présentation

Les fichiers de logs

Introduction

Log files

LogBack configuration

Arborescence des pages

Historique de la page

Comparaison des versions

Ancienne version 21

Nouvelle version 22

Légende

Présentation

Les fichiers de logs

Introduction

Log files

LogBack configuration