Configuration des logs

Il est possible de configurer les logs de cadastrapp, pour cela il faut créer un fichier cadastrapp/log4j/log4j2.properties dans le datadir georchestra.

Un exemple de ce fichier peut être trouvé ici.

Avec la configuration par défaut, seuls les logs de niveau WARNING sont affichés dans le fichier /tmp/cadastrapp.log (configuration de production). Si vous souhaitez afficher plus de logs, vous pouvez configurer les differents loggers avec level = info ou level = debug.

Des logs sur la génération de documents dans cadastrapp sont également produits, la section ci-dessous documente leur utilisation.

Logs sur la génération de documents

Par défaut, les logs sur la génération de documents sont faits dans le fichier /tmp/cadastrapp_audit.log.

Chaque ligne comporte les mêmes infos que les logs classiques Cadastrapp, à savoir ce layout :

%d %-5p [%c] %X{uri} - $${ctx:sec-username:-nouser} - $${ctx:sec-roles:-norole} - $${ctx:sec-org:-noorg} - %m%n

Ci-dessous la composition du message est détaillée (%m) :

Bordereau parcellaires :

Exemple :

Bordereau Parcellaire - {Methode} - {Demande} - {Parcelle} - {WithProps} - {Copro}

• Methode => Moyen par lequel le document a été généré
• Demande (ID) => Identifiant de la demande si existe, sinon null
• Parcelle (ID) => Identifiant de la parcelle représentée
• WithProps (0/1) => 1 si avec propriétaires, 0 sinon
• Copro (true/false) => Demande de type Copro

Methodes pour les BP :

• GenerationDirecte
• DemandeParcelleId
• DemandeCCId
• DemandeInfoParcelle
• DemandeInfoProp
• DemandeLot

Relevés de propriété :

Exemple :

Releve de propriete - {Methode} - {Demande} - {CompteCommunal} - {Parcelle} - {Minimal} - {Format}

• Methode => Moyen par lequel le document a été généré
• Demande (ID) => Identifiant de la demande si existe, sinon null
• CompteCommunal (ID) => Identifiant du compte communal
• Parcelle (ID) => Identifiant de la parcelle exporté si renseignée, sinon null
• Minimal (true/false) => false si export complet, true si minimal
• Format (PDF/CSV) => Format d'export

Methodes pour les RP :

• GenerationDirecte
• DemandeCCId
• DemandeParcelleId
• DemandeCoProCCParcelleId
• DemandeInfoParcelle
• DemandeInfoProp
• DemandeLot

Demandes

Exemple :

Demande - {Demande} - {UserType}

• Demande (ID) => Identifiant de la demande
• UserType => Type de demandeur

UserType pour les Demandes :

• A => Administration
• P1 => Particulier détendeur des droits
• P2 => Particulier agissant en qualité de mandataire
• P3 => Particuliers tier

Exports CSV

Exemple :

Export CSV - {Type} - {Params}

• Type =>Type d'export demandé
• Params => Parametres fournis pour l'export

Type d'exports :

• Parcelles
• Propriétaires
• CoPropriétaires
• Lots
• ComptesCommunaux

Logs sur génération de documents dans BDD

Cette fonctionnalité n'est pas activée par defaut, mais est commentée dans le fichier de configuration log4j2.

Pour l'activer :

• renseigner les propriétés en haut de fichier (dbUser,dbPassword,dbConnectionString) et les décommenter
• décommenter les configuration des appenders sous ## Configuring JDBC appenders (dbBP, dbRP, dbDEM, dbEXP)
• décommenter l'ajout de ces mêmes appenders au logger documents en fin de fichier

Voici les script pour les tables à créer en BDD, à adapter à votre convenance :

   CREATE TABLE IF NOT EXISTS public.cadastrapp_bp
   (
       username text,
       log_date timestamp with time zone NOT NULL,
       uri text,
       organisation text,
       roles text,
       message text,
       methode text GENERATED ALWAYS AS ( split_part(message,' - ',2) ) STORED,
       demande text GENERATED ALWAYS AS ( split_part(message,' - ',3) ) STORED,
       parcelle text GENERATED ALWAYS AS ( split_part(message,' - ',4) ) STORED,
       proprietaires text GENERATED ALWAYS AS ( split_part(message,' - ',5) ) STORED,
       copro text GENERATED ALWAYS AS ( split_part(message,' - ',6) ) STORED
   );
   ALTER TABLE public.cadastrapp_bp OWNER TO cadastrapp;

   CREATE TABLE IF NOT EXISTS public.cadastrapp_rp
   (
       username text,
       log_date timestamp with time zone NOT NULL,
       uri text,
       organisation text,
       roles text,
       message text,
       methode text GENERATED ALWAYS AS ( split_part(message,' - ',2) ) STORED,
       demande text GENERATED ALWAYS AS ( split_part(message,' - ',3) ) STORED,
       ccomunal text GENERATED ALWAYS AS ( split_part(message,' - ',4) ) STORED,
       parcelle text GENERATED ALWAYS AS ( split_part(message,' - ',5) ) STORED,
       minimal text GENERATED ALWAYS AS ( split_part(message,' - ',6) ) STORED,
       format text GENERATED ALWAYS AS ( split_part(message,' - ',7) ) STORED
   );
   ALTER TABLE public.cadastrapp_rp OWNER TO cadastrapp;

   CREATE TABLE IF NOT EXISTS public.cadastrapp_demande
   (
       username text,
       log_date timestamp with time zone NOT NULL,
       uri text,
       organisation text,
       roles text,
       message text,
       demande text GENERATED ALWAYS AS ( split_part(message,' - ',2) ) STORED,
       usertype text GENERATED ALWAYS AS ( split_part(message,' - ',3) ) STORED
   );
   ALTER TABLE public.cadastrapp_demande OWNER TO cadastrapp;

   CREATE TABLE IF NOT EXISTS public.cadastrapp_export
   (
       username text,
       log_date timestamp with time zone NOT NULL,
       uri text,
       organisation text,
       roles text,
       message text,
       type text GENERATED ALWAYS AS ( split_part(message,' - ',2) ) STORED,
       params text GENERATED ALWAYS AS ( split_part(message,' - ',3) ) STORED
   );
   ALTER TABLE public.cadastrapp_export OWNER TO cadastrapp;

note: Si vous souhaitez optimiser la gestion des logs en BDD pour de gros volumes, il est possible d'utiliser l'extension timescaledb de PostgreSQL.