Les fichiers de log

Généralités

Quand MyReport doit écrire dans un fichier de log ("[NomFichier].csv"), et qu'il n'est pas accessible en écriture (par exemple, il est ouvert dans Excel), MyReport utilise le fichier suivant "[NomFichier]_[DateDuJour].csv".

Si ce dernier n'est pas non plus accessible en écriture, MyReport utilise le fichier "[NomFichier]_[DateHeureMinuteDuJour].csv".

Quand MyReport doit écrire dans un fichier, et que le fichier existe déjà, MyReport vérifie que le fichier est cohérent :

  • Si il n'est pas cohérent :

    • MyReport renomme le fichier en : [NomFichier]_backup_[DateDuJour].csv

    • MyReport crée un fichier vierge "[NomFichier].csv" avec la bonne entête

    • MyReport ajoute la ligne voulue dans "[NomFichier].csv"

  • Si il est cohérent :

    • MyReport ajoute la ligne voulue dans "[NomFichier].csv"

Les fichiers des erreurs

Les différentes erreurs se produisant dans les produits sont loguées dans le fichier "LogError.txt"

Il existe deux fichiers "LogError.txt" :

  • Si l'erreur se produit au niveau du serveur MyReport : "C:\ProgramData\MyReport\LogError.txt"
  • Si l'erreur se produit dans un client MyReport (Data, Builder, ...) : "C:\Users\[USER]\AppData\Roaming\MyReport\LogError.txt"

Note

Pour les erreurs se produisant dans MyReport Center, les différents pools d'applications doivent avoir le droit d'écriture sur le dossier "C:\ProgramData\MyReport"

Les fichiers des ETLs

Les informations d’exécutions d'un ETL sont stockées dans deux fichiers à la racine du Projet : LogETL.csv et LogETLError.csv

  • LogETL.csv : Informations sur chaque lancement d'un ETL.
  • LogETLError.csv : Détail des erreurs se produisant lors des ETL.

Tableau 1.8. Contenu de LogETL.csv

Colonne

Explication

Server version

Numéro de version du serveur

Client version

Numéro de version du client

Model

Nom complet du modèle

Type

Type du modèle (Simple, texte, Excel, WebService, Conso)

Insert mode

Mode de chargement de l'ETL

Rows added

Nombre de lignes ajoutées

Rows updated

Nombre de lignes modifiées

Rows deleted

Nombre de lignes supprimées

Rows in error

Nombre de lignes en erreurs (ligne non inserée)

Rows in warning

Nombre de lignes avec avertissement (ligne inserée avec une valeur par défaut)

Columns

nombre de colonnes de la table (nombre de champs visible dans le modèle)

Date

Date de lancement de l'ETL sur le modèle (yyyy-MM-dd)

Start time

Heure de lancement de l'ETL sur le modèle (hh:mm:ss.ms)

End time

Heure de fin de l'ETL sur le modèle (hh:mm:ss.ms)

Duration

Durée de l'ETL sur le modèle (hh:mm:ss.ms)

Machine

Nom de la machine qui a demandé le lancement de l'ETL

Session

Nom de la session qui a demandé le lancement de l'ETL

Project name

Nom du projet possédant le modèle

Product

Nom du produit qui a demandé le lancement de l'ETL

Result

Résultat de l'ETL (OK, Error, Warning)

ETL_StartDateTime

Date de lancement de l'ETL (commun à tous les modèles de l'ETL) (mm/jj/aaaa hh:mm:ss)

Launcher_Id

  • Lancement manuel : Identifiant MyReport de l'utilisateur
  • Lancement automatique : Non renseigné

Launcher_Name

  • Lancement manuel : "Nom Prénom (Login)" de l'utilisateur
  • Lancement automatique : "Serveur (programmation)"

Program_Id

  • Lancement hors programmation : Non renseigné
  • Lancement via une programmation : Identifiant MyReport du programme

Program_Name

  • Lancement hors programmation : "ETL sur ordre"
  • Lancement via une programmation : Nom du programme

Schedules_Id

  • Lancement hors programmation : Non renseigné
  • Lancement via une programmation : Identifiant MyReport de la programmation

Schedules_Name

  • Lancement hors programmation : Non renseigné
  • Lancement via une programmation : Nom de la programmation

Schedules_StartDateTime

  • Lancement hors programmation : Non renseigné
  • Lancement via une programmation : Date de lancement de la programmation (yyyy-MM-dd HH:mm:ss)

Tableau 1.9. Contenu de LogETLError.csv

Colonne

Explication

Server version

Numéro de version du serveur

Client version

Numéro de version du client

Product

Nom du produit qui a demandé le lancement de l'ETL

Project name

Nom du projet possédant le modèle

Model

Nom complet du modèle

Date

Date de l'erreur (yyyy-MM-dd)

Time

Heure de l'erreur (hh:mm:ss.ms)

Row number

Numero de ligne en erreur 0 si l'erreur est autre qu'une insertion/modification/suppression de ligne

Type

Gravité de l'erreur (Erreur, Avertissement)

Message

Message d'erreur explicatif

ETL_StartDateTime

Date de lancement de l'ETL (commun à tous les modèles de l'ETL) (yyyy-MM-dd HH:mm:ss)

Launcher_Id

  • Lancement manuel : Identifiant MyReport de l'utilisateur
  • Lancement automatique : Non renseigné

Launcher_Name

  • Lancement manuel : "Nom Prénom (Login)" de l'utilisateur
  • Lancement automatique : "Serveur (programmation)"

Program_Id

  • Lancement hors programmation : Non renseigné
  • Lancement via une programmation : Identifiant MyReport du programme

Program_Name

  • Lancement hors programmation : "ETL sur ordre"
  • Lancement via une programmation : Nom du programme

Schedules_Id

  • Lancement hors programmation : Non renseigné
  • Lancement via une programmation : Identifiant MyReport de la programmation

Schedules_Name

  • Lancement hors programmation : Non renseigné
  • Lancement via une programmation : Nom de la programmation

Schedules_StartDateTime

  • Lancement hors programmation : Non renseigné
  • Lancement via une programmation : Date de lancement de la programmation (yyyy-MM-dd HH:mm:ss)

Les fichiers des diffusions

Les informations d’exécutions d'une diffusion sont stockées dans deux fichiers à la racine du Projet : LogExpedition.csv et LogExpeditionError.csv

  • LogExpedition.csv : Informations sur chaque lancement d'une diffusion.
  • LogExpeditionError.csv : Détail des erreurs se produisant lors des diffusions.

Tableau 1.10. Contenu de LogExpedition.csv

Colonne

Explication

Server version

Numéro de version du serveur

Client version

Numéro de version du client

Distribution

Nom complet du modèle

Type

Type de la diffusion (Mail, réseau local, FTP,...)

Date

Date de lancement de la diffusion (yyyy-MM-dd)

Start time

Heure de lancement de la diffusion (hh:mm:ss.ms)

End time

Heure de fin de la diffusion (hh:mm:ss.ms)

Duration

Durée de la diffusion (hh:mm:ss.ms)

Machine

Nom de la machine qui a demandé le lancement

Session

Nom de la session qui a demandé le lancement

Project name

Nom du projet possédant la diffusion

Product

Nom du produit qui a demandé le lancement de la diffusion

Result

Résultat de la diffusion (OK, Error, Warning)

Expedition_StartDateTime

Date de lancement des diffusions (lancement de plusieurs diffusions manuellement) (mm/jj/aaaa hh:mm:ss)

Launcher_Id

  • Lancement manuel : Identifiant MyReport de l'utilisateur
  • Lancement automatique : Non renseigné

Launcher_Name

  • Lancement manuel : "Nom Prénom (Login)" de l'utilisateur
  • Lancement automatique : "Serveur (programmation)"

Program_Id

  • Lancement hors programmation : Non renseigné
  • Lancement via une programmation : Identifiant MyReport du programme

Program_Name

  • Lancement hors programmation : "Expédition sur ordre"
  • Lancement via une programmation : Nom du programme

Schedules_Id

  • Lancement hors programmation : Non renseigné
  • Lancement via une programmation : Identifiant MyReport de la programmation

Schedules_Name

  • Lancement hors programmation : Non renseigné
  • Lancement via une programmation : Nom de la programmation

Schedules_StartDateTime

  • Lancement hors programmation : Non renseigné
  • Lancement via une programmation : Date de lancement de la programmation (yyyy-MM-dd HH:mm:ss)

Tableau 1.11. Contenu LogExpeditionError.csv

Colonne

Explication

Server version

Numéro de version du serveur

Client version

Numéro de version du client

Product

Nom du produit qui a demandé le lancement de la diffusion

Project name

Nom du projet possédant la diffusion

Distribution

Nom complet de la diffusion

Date

Date de l'erreur (yyyy-MM-dd)

Time

Heure de l'erreur (hh:mm:ss.ms)

Type

Gravité de l'erreur (Erreur, Avertissement)

RecipientUsers

Liste des utilisateurs devant recevoir la diffusion au moment de l'erreur

Message

Message d'erreur explicatif

Expedition_StartDateTime

Date de lancement des diffusions (lancement de plusieurs diffusions manuellement) (yyyy-MM-dd HH:mm:ss)

Launcher_Id

  • Lancement manuel : Identifiant MyReport de l'utilisateur
  • Lancement automatique : Non renseigné

Launcher_Name

  • Lancement manuel : "Nom Prénom (Login)" de l'utilisateur
  • Lancement automatique : "Serveur (programmation)"

Program_Id

  • Lancement hors programmation : Non renseigné
  • Lancement via une programmation : Identifiant MyReport du programme

Program_Name

  • Lancement hors programmation : "Expédition sur ordre"
  • Lancement via une programmation : Nom du programme

Schedules_Id

  • Lancement hors programmation : Non renseigné
  • Lancement via une programmation : Identifiant MyReport de la programmation

Schedules_Name

  • Lancement hors programmation : Non renseigné
  • Lancement via une programmation : Nom de la programmation

Schedules_StartDateTime

  • Lancement hors programmation : Non renseigné
  • Lancement via une programmation : Date de lancement de la programmation (yyyy-MM-dd HH:mm:ss)

Les fichiers des lignes de commandes

Les informations d’exécutions d'une commande sont stockées dans deux fichiers à la racine du Projet : LogCommand.csv et LogCommandError.csv

  • LogCommand.csv : Informations sur chaque lancement d'une commande.
  • LogCommandError.csv : Détail des erreurs se produisant lors des exécutions des commandes.

Tableau 1.12. Contenu de LogCommand.csv

Colonne

Explication

Server version

Numéro de version du serveur

Client version

Numéro de version du client

Product

Nom du produit qui a demandé le lancement de la commande

Date

Date de lancement de la commande (yyyy-MM-dd)

Start time

Heure de lancement de la commande (hh:mm:ss.ms)

End time

Heure de fin de la commande (hh:mm:ss.ms)

Duration

Durée de la commande (hh:mm:ss.ms)

Machine

Nom de la machine qui a demandé le lancement

Session

Nom de la session qui a demandé le lancement

Project name

Nom du projet possédant la commande

Result

Résultat de la commande (OK, Error)

Command_StartDateTime

Date de lancement de la commande (mm/jj/aaaa hh:mm:ss)

Launcher_Id

  • Lancement manuel : Identifiant MyReport de l'utilisateur
  • Lancement automatique : Non renseigné

Launcher_Name

  • Lancement manuel : "Nom Prénom (Login)" de l'utilisateur
  • Lancement automatique : "Serveur (programmation)"

Program_Id

Identifiant MyReport du programme (élément d'une programmation)

Program_Name

Nom du programme

Schedules_Id

Identifiant MyReport de la programmation

Schedules_Name

Nom de la programmation

Schedules_StartDateTime

Date de lancement de la programmation (mm/jj/aaaa hh:mm:ss)


Tableau 1.13. Contenu de LogCommandError.csv

Colonne

Explication

Server version

Numéro de version du serveur

Client version

Numéro de version du client

Product

Nom du produit qui a demandé le lancement de la commande

Project name

Nom du projet possédant la commande

Command

Ligne de commande exécutée

Date

Date de l'erreur (mm/jj/aaaa)

Time

Heure de l'erreur (hh:mm:ss.ms)

Type

Gravité de l'erreur (Seulement Erreur)

Message

Numéro d'erreur retourné par la ligne de commande

Command_StartDateTime

Date de lancement de la commande (mm/jj/aaaa hh:mm:ss)

Launcher_Id

  • Lancement manuel : Identifiant MyReport de l'utilisateur
  • Lancement automatique : Non renseigné

Launcher_Name

  • Lancement manuel : "Nom Prénom (Login)" de l'utilisateur
  • Lancement automatique : "Serveur (programmation)"

Program_Id

Identifiant MyReport du programme (élément d'une programmation)

Program_Name

Nom du programme

Schedules_Id

Identifiant MyReport de la programmation

Schedules_Name

Nom de la programmation

Schedules_StartDateTime

Date de lancement de la programmation (mm/jj/aaaa hh:mm:ss)


Le fichier d'activités

Les informations plus générales sur l'activité du serveur sont dans le fichier ActivityLog.csv. Ce fichier est optionnel, et son emplacement peut être choisi dans la console d’administration.

Tableau 1.14. Contenu du fichier ActivityLog.csv

Colonne

Explication

Type

Type de l'action enregistrée (voir en dessous pour la liste des valeurs et leurs significations)

Detail

Détail de l'action. Ce champ n'est rempli que pour certaines actions (exemple : Sauvegarde d'un modèle)

Product

Nom du produit dans lequel l'action a été réalisée

Project

Nom du projet dans lequel l'action a été réalisée

User

  • Action manuelle : Nom de l'utilisateur
  • Lancement automatique d'une programmation : "Serveur (programmation)"

Machine

  • Action manuelle : Nom de la machine de l'utilisateur
  • Lancement automatique d'une programmation : Nom de la machine du Serveur MyReport
  • Lancement automatique d'une programmation en Load Balancing : Nom de la machine du Serveur MyReport Principal

Session

  • Action manuelle : Nom de la session de l'utilisateur
  • Lancement automatique d'une programmation : Nom de la session du Serveur MyReport
  • Lancement automatique d'une programmation en Load Balancing : Nom de la session du Serveur MyReport Principal

ServerName

  • Load Balancing : Nom de la machine du Serveur MyReport secondaire qui effectue le travail
  • Hors Load Balancing : Nom de la machine du Serveur MyReport qui effectue le travail

ServerVersion

  • Load Balancing : Numéro de version du serveur MyReport principal
  • Hors Load Balancing : Nom de la machine du Serveur MyReport

ClientVersion

Numéro de version de l'application client

Date

Date de l'action (jj/mm/aaaa)

Time

Heure de l'action (hh:mm:ss:ms)


Liste des Types d'actions et leur signification

  • Services :

    • ServiceStarted : Démarrage du service du Serveur principal
    • ServiceStopped : Arrêt du service du serveur principal
  • Connexion au service de licences :

    • LicenseConnectionOk : Connexion de l'utilisateur au service de licences
    • LicenseDeconnection : Déconnexion de l'utilisateur au service de licences
    • LicenseConnectionError_ZeroLicenseForMail : Erreur de connexion : Aucune licence n'a été trouvée pour le mail utilisé
    • LicenseConnectionError_BadPassword : Erreur de connexion : Mauvais mot de passe
    • LicenseConnectionError_ZeroLicenseKey : Erreur de connexion : Licence non activée
    • LicenseConnectionError_LicenseBlocked : Erreur de connexion : Licence bloquée
    • LicenseConnectionError_LicenseAlreadyUsed : Erreur de connexion : La licence est déjà en cours d'utilisation sur un autre poste
    • LicenseConnectionError_AllSessionsUsed : Erreur de connexion : La licence est déjà enregistrée sur 2 postes
    • LicenseConnectionError_CantAddingSession : Erreur de connexion : Une erreur s'est produite sur la mise à jour du couple machine/ session de la licence
    • LicenseConnectionError_ServerVersion : Erreur de connexion : La version du serveur n'est pas activée
  • Connexion à un Projet :

    • ProjectConnectionOk : Connexion de l'utilisateur à un projet
    • ProjectDeconnection : Déconnexion de l'utilisateur au projet
    • ProjectConnectionError_ProjectAlreadyUsed : Erreur de connexion : Un autre utilisateur est déjà connecté au projet dans l'Administrator
    • ProjectConnectionError_ProductAlreadyConnected : Erreur de connexion : L'utilisateur est déjà connecté avec le même produit sur le même poste
    • ProjectConnectionError_BadVersion : Erreur de connexion : Le serveur et le client sont dans des versions incompatibles
    • ProjectConnectionError_WrongPasswordLogin : Erreur de connexion : Mauvais login ou mot de passe
  • Execution :

    • ExecutionReport : Un report a été exécuté
    • ExpeditionDiffusion : Une diffusion a été lancée
    • ETL : Un ETL a été lancé
  • Divers :

    • SaveModel : Un modèle a été enregistré. La colonne "Detail" contient le nom du modèle
    • SaveConnection : Une connexion a été enregistrée. La colonne "Detail" contient le nom de la connexion
    • SaveFolder : Un dossier a été enregistré. La colonne "Detail" contient le nom du dossier
    • UndoRedo : Une action annulable a été réalisée. La colonne "Detail" contient le libellé de l'action (Exemple : "Renommage du champ "Client" en "Clients")

Les logs d'audits des modèles et des champs

L'utilisation des modèles et des champs est enregistrée dans la base de données "Logs.db3" stockée dans le MySystem.

Note

La durée de rétention des logs est modifiable via l'onglet "Options" dans MyReport Administrator.

Eléments enregistrés

  • Le modèles utilisés
  • Les champs destinations
  • Les champs sources
  • L'utilisation effectuée :

    • Le produit utilisé (Builder, Messenger, Center)
    • La fonction du produit utilisée
    • Le chemin du fichier (classeur Excel ou tableau de bord)
  • La date d'utilisation
  • L'utilisateur

Il existe plusieurs types d'utilisations :

  • Builder - Création : Création d'un report depuis MyReport Builder (valeur 1 dans le champ "ExecutionTypeAudit")
  • Builder - Update : Mise à jour d'un report depuis le ruban Excel (valeur 2 dans le champ "ExecutionTypeAudit")
  • Builder - Zoom : Zoom sur les données depuis le ruban Excel (La mise à jour d'un détail via le zoom est loguée comme une utilisation "Builder - Update") (valeur 3 dans le champ "ExecutionTypeAudit")
  • Messenger : Mise à jour des reports dans les diffusions et les programmations (valeur 4 dans le champ "ExecutionTypeAudit")
  • Center : Affichage d'un tableau de bord dans MyReport Center (valeur 5 dans le champ "ExecutionTypeAudit")

Note

Dans le cas d'une exécution d'un Multi-Report, chacun des sous-reports est audité. Le Report final n'étant pas lié à un modèle il est ignoré.

Les Reports basés sur une source locale sont aussi ignorés.

Lors d'une exécution sans mise à jour ou "à vide" ("Builder - Création" ou "Messenger"), les champs sont ignorés. La diffusion reste quand même enregistrée pour chaque utilisateur

Pour chaque utilisation, il y a un ou plusieurs utilisateurs.

  • Builder: l'utilisateur qui actualise ou génère le report
  • Diffusion

    • L'expéditeur de la diffusion (Données à afficher : Expéditeur)
    • Chacun des destinataires de la diffusion (Données à afficher : Destinataire)
  • Center: l'utilisateur qui affiche le Dashboard

Figure 1.5. Détail des tables de la base

Détail des tables de la base

Important

Une ligne dans la base de log correspond à l'utilisation d'un champ ou d'un modèle pour une exécution et pour un utilisateur :

exemple : La mise à jour d'un Report par Builder (1 utilisateur) utilise 4 champs d'un modèle, il y aura 4 lignes dans le fichier de log

Note

Chaque ligne de log possède un identifiant unique auto-incrémenté

Pour une exécution, un seul "ExecutionGUID" est généré pour toutes les lignes à ajouter

Exemple : La diffusion d'un classeur avec 2 reports qui utilisent le même champ sera logguée comme suit :
* Génération d'un GUID (pour l'exemple : "ABCDE")
    * Mise à jour du premier report :
        * Log dans "DistributionLogs" : Id = 10, ..., ExecutionGUID = "ABCDE", ...
        * Log dans "FieldLogs" : Id = 1856, ..., FieldName = "Champ1", ExecutionGUID = "ABCDE", ...
    * Mise à jour du premier deuxième report :
        * Log dans "DistributionLogs" : Id = 11, ..., ExecutionGUID = "ABCDE", ...
        * Log dans "FieldLogs" : Id = 1857, ..., FieldName = "Champ1", ExecutionGUID = "ABCDE", ...

L'ExecutionGUID permet la liaison entre DistributionLogs (ou DashboardLogs) et FieldLogs

Note

Dans une diffusion "sans mise à jour" ou "à vide", seul "DistributionLogs" aura une ligne d'ajoutée, les champs ne sont pas considérés comme utilisés

Note

Un champ Table n'est audité que s'il est utilisé directement sans passer par un champ destination (Exemple : utilisation d'un filtre sur un champ Table dans MyReport Data)

Logs de diagnostics

Les logs de diagnostics permettent de loguer des informations complémentaires lors de l'utilisation de la solution MyReport BE.

Important

L'activation des logs de diagnostics est à faire sur demande du support client.

ghostghostghostghostghost
loading table of contents...