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 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 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.
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
|
Tableau 1.11. Contenu LogExpeditionError.csv
|
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
|
Tableau 1.13. Contenu de LogCommandError.csv
|
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 |
|
Machine |
|
Session |
|
ServerName |
|
ServerVersion |
|
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")
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
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)