Gestion des évènements (server)
(→Messages d'audit) |
(→Propriétés) |
||
(23 révisions intermédiaires par un utilisateur sont masquées) | |||
Ligne 71 : | Ligne 71 : | ||
|confevent | |confevent | ||
|Messages de configuration | |Messages de configuration | ||
+ | |- | ||
+ | |audit | ||
+ | |Messages d'audit | ||
+ | |- | ||
+ | |uxevent | ||
+ | |Messages d'évènement d'interface utilisateur | ||
|} | |} | ||
===Propriétés=== | ===Propriétés=== | ||
Les messages transmis aux gestionnaires externes sont paramétrés par des variables, lors de l'envoie d'un message les paramètres du message sont substitués. | Les messages transmis aux gestionnaires externes sont paramétrés par des variables, lors de l'envoie d'un message les paramètres du message sont substitués. | ||
+ | |||
+ | '''Propriétés statiques''' | ||
{|class="wikitable" | {|class="wikitable" | ||
Ligne 118 : | Ligne 126 : | ||
|- | |- | ||
|NodeID | |NodeID | ||
− | |identifiant unique de noeud | + | |identifiant unique de noeud (host.port.service) |
|- | |- | ||
|NodeGUID | |NodeGUID | ||
− | |GUID identifiant le noeud | + | |GUID identifiant le noeud ([[Service_1000_(server)|switch NODEGUID]] ou GUID unique de machine) |
− | + | ||
− | + | ||
− | |GUID | + | |
|- | |- | ||
|systemOSName | |systemOSName | ||
Ligne 155 : | Ligne 160 : | ||
|serialNumber | |serialNumber | ||
|Numéro de série du produit | |Numéro de série du produit | ||
+ | |- | ||
+ | |memoryVirtualSetSize | ||
+ | |Taille de mémoire virtuelle du processus | ||
+ | |- | ||
+ | |memoryWorkingSetSize | ||
+ | |Taille de jeu de travail du processus | ||
+ | |- | ||
+ | |memoryPageFault | ||
+ | |Nombre de page fault du processus | ||
|- | |- | ||
|productName | |productName | ||
Ligne 170 : | Ligne 184 : | ||
|* | |* | ||
|toutes les informations disponibles liées à l'événement | |toutes les informations disponibles liées à l'événement | ||
+ | |} | ||
+ | |||
+ | '''Propriétés liées au contexte utilisateur''' | ||
+ | |||
+ | {|class="wikitable" | ||
+ | |- | ||
+ | !Nom | ||
+ | !Contenu | ||
+ | |- | ||
+ | |SessionID | ||
+ | |Identifiant de session | ||
+ | |- | ||
+ | |UserName | ||
+ | |Nom de l'utilisateur | ||
+ | |- | ||
+ | |UserID | ||
+ | |Identifiant de l'utilisateur | ||
+ | |- | ||
+ | |CustomerID | ||
+ | |Numéro de série du produit | ||
+ | |- | ||
+ | |SocName | ||
+ | |Nom du dossier | ||
+ | |- | ||
+ | |RemoteIP | ||
+ | |Adresse distante de l'utilisateur | ||
+ | |- | ||
+ | |AppName | ||
+ | |Nom de l'application | ||
+ | |- | ||
+ | |AppVersion | ||
+ | |Version de l'application | ||
+ | |- | ||
+ | |authDirectory | ||
+ | |Nom de l'annuaire utilisé | ||
+ | |- | ||
+ | |authGroup | ||
+ | |Nom du groupe ayant identifié | ||
+ | |- | ||
+ | |UserArgent | ||
+ | |UserAgent de connexion | ||
+ | |- | ||
+ | |Referer | ||
+ | |Referer de connexion | ||
+ | |- | ||
+ | |tenantID | ||
+ | |Identifiant de tenant (multitenant) | ||
+ | |- | ||
+ | |OrganizationName | ||
+ | |Nom de l'organisation (multitenant) | ||
+ | |- | ||
+ | |ShareSocietyName | ||
+ | |Société de partage | ||
+ | |- | ||
+ | |ShareRestitution | ||
+ | |Mode de partage | ||
+ | |- | ||
+ | |LoginInfo | ||
+ | |Informations de connexion | ||
|} | |} | ||
Ligne 186 : | Ligne 259 : | ||
|exceptionClass | |exceptionClass | ||
|Classe de l'exception | |Classe de l'exception | ||
+ | |- | ||
+ | |exceptionCode | ||
+ | |Code de l'exception | ||
|- | |- | ||
|exceptionDatetime | |exceptionDatetime | ||
Ligne 200 : | Ligne 276 : | ||
|} | |} | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | ===Propriétés définies | + | ===Propriétés définies pour les actions=== |
+ | Les actions sont des évènements liés à l'activité de l'utilisater, ils sont notamment utilisés pour la collecte des statistiques analytiques. | ||
{|class="wikitable" | {|class="wikitable" | ||
Ligne 254 : | Ligne 286 : | ||
|- | |- | ||
|ActionType | |ActionType | ||
− | | | + | |Type d'action |
|- | |- | ||
|ActionName | |ActionName | ||
− | | | + | |Nom de l'action |
|- | |- | ||
|ActionCategory | |ActionCategory | ||
− | | | + | |Catégrorie de l'action |
|- | |- | ||
|ActionTitle | |ActionTitle | ||
− | | | + | |Libellé de l'action |
|- | |- | ||
|ActionLabel | |ActionLabel | ||
Ligne 269 : | Ligne 301 : | ||
|- | |- | ||
|ActionParams | |ActionParams | ||
− | | | + | |Paramètre de l'action |
+ | |- | ||
+ | |ActionOrigin | ||
+ | |Origin de l'action | ||
|- | |- | ||
|ActionReferrer | |ActionReferrer | ||
− | | | + | |Référant de l'action |
|- | |- | ||
|ActionGroup1 | |ActionGroup1 | ||
− | | | + | |Regroupement 1 |
|- | |- | ||
|ActionGroup2 | |ActionGroup2 | ||
− | | | + | |Regroupement 2 |
|- | |- | ||
|ActionGroup3 | |ActionGroup3 | ||
− | | | + | |Regroupement 3 |
|- | |- | ||
|ActionTiming | |ActionTiming | ||
− | | | + | |Durée de l'action |
|- | |- | ||
|ActionValue | |ActionValue | ||
− | | | + | |Valeur associée à l'action |
|- | |- | ||
|ActionValue1 | |ActionValue1 | ||
− | | | + | |Valeur associée à l'action |
|- | |- | ||
|ActionValue2 | |ActionValue2 | ||
− | | | + | |Valeur associée à l'action |
|} | |} | ||
+ | |||
+ | Les catégories associés aux actions : | ||
+ | |||
+ | {|class="wikitable" | ||
+ | |- | ||
+ | !Catégorie | ||
+ | !Usage | ||
+ | !Déclenchés par | ||
+ | |- | ||
+ | |hit | ||
+ | |Ouverture d'écran | ||
+ | |form | ||
+ | |- | ||
+ | |processevent | ||
+ | |Exécution de traitement | ||
+ | |Défini dans le code métier | ||
+ | |- | ||
+ | |timing | ||
+ | |Durée d'utilisation | ||
+ | |form | ||
+ | |- | ||
+ | |uxevent | ||
+ | |Evènements d'interface | ||
+ | |dataset, lookup, menu | ||
+ | |} | ||
+ | |||
+ | '''Exemple, collecter les actions utilisateurs :''' | ||
+ | |||
+ | <pre> | ||
+ | [\SOFTWARE\Sage\Ligne 1000\Administration\LOGManager\ACTIONS] | ||
+ | type=file | ||
+ | FileName=logs\actions-[NodeID]-[processId].csv | ||
+ | categories=sysevent,confevent,taskevent,processevent,uxevent,event,hit,timing | ||
+ | content=[Timestamp];[UserName];[SessionID];[MemoryVirtualSetSize];[ShareSocietyName];[actionCategory];[actionName];[actionTitle];[actionParams];[actionValue];[actionValue1];[actionReferrer];[actionOrigin];[ActionModule];[actionTiming] | ||
+ | </pre> | ||
===Messages d'audit=== | ===Messages d'audit=== | ||
Ligne 305 : | Ligne 375 : | ||
{|class="wikitable" | {|class="wikitable" | ||
|- | |- | ||
− | + | !Nom | |
− | + | !Contenu | |
|- | |- | ||
|auditAction | |auditAction | ||
Ligne 314 : | Ligne 384 : | ||
|Libellé associé à l'action | |Libellé associé à l'action | ||
|} | |} | ||
+ | |||
+ | '''Liste des actions auditées''' | ||
{|class="wikitable" | {|class="wikitable" | ||
Ligne 322 : | Ligne 394 : | ||
!informations | !informations | ||
|- | |- | ||
− | | | + | |authenticate.login |
|session | |session | ||
|success | |success | ||
|utilisateur | |utilisateur | ||
|- | |- | ||
− | | | + | |authenticate.login |
|session | |session | ||
|failure | |failure | ||
|utilisateur | |utilisateur | ||
+ | |- | ||
+ | |authenticate.logout | ||
+ | |session | ||
+ | |success | ||
+ | |utilisateur | ||
+ | |- | ||
+ | |form.open | ||
+ | |form | ||
+ | |success | ||
+ | |Interface concernée | ||
+ | |- | ||
+ | |form.close | ||
+ | |form | ||
+ | |success | ||
+ | |Interface concernée | ||
+ | |- | ||
+ | |task.start | ||
+ | |Automate | ||
+ | |success | ||
+ | |tâche démarrée | ||
+ | |- | ||
+ | |task.success | ||
+ | |Automate | ||
+ | |success | ||
+ | |tâche exécutée | ||
+ | |- | ||
+ | |task.failure | ||
+ | |Automate | ||
+ | |failure | ||
+ | |tâche exécutée | ||
|} | |} | ||
Ligne 360 : | Ligne 462 : | ||
* [[Paramètres (logger)|Paramètres des Logger]] | * [[Paramètres (logger)|Paramètres des Logger]] | ||
+ | * [[LogEvent_(rtl)|Emettre un évènement dans le code métier]] | ||
* [[httpLogger (logger)|Logger http]] | * [[httpLogger (logger)|Logger http]] | ||
* [[mailLogger (logger)|Logger mail]] | * [[mailLogger (logger)|Logger mail]] |
Version actuelle en date du 10 août 2018 à 13:27
Sommaire |
La gestion des logs et des évènements permet de centraliser les logs dans un gestionnaire externe.
Types d'évènement
Les évènements sont typés
Type | Usage |
---|---|
success | not used |
information | Message d'activité |
error |
|
warning |
|
audit_success | Message d'audit succès (700p) |
audit_failure | Message d'audit en erreur (700p) |
monitor | Evènements générés par l'horloge interne (700p) |
Catégories d'évènement
Les différents évènements sont catégorisés, un gestionnaire peut gérer une ou plusieurs catégories.
Nom | Usage |
---|---|
service | Message issus du service (trace et debug) |
automate | Messages issus de l'automate |
bp | Messages issus des Processus Métiers |
authenticate | Messages d'authentification |
hit | Messages d'exécution d'interface (form et report) |
timing | Messages de durée d'exécution (form,report,processus...) |
processevent | Messages d'exécution de processus |
taskevent | Messages d'exécution de tâche |
confevent | Messages de configuration |
audit | Messages d'audit |
uxevent | Messages d'évènement d'interface utilisateur |
Propriétés
Les messages transmis aux gestionnaires externes sont paramétrés par des variables, lors de l'envoie d'un message les paramètres du message sont substitués.
Propriétés statiques
Nom | Contenu |
---|---|
id | GUID au format XXXXXXXXXXXXXXXXXXXXXXXXXXXX |
guid | GUID au format {XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXX} |
RowId | GUID au format XXXXXXXXXXXXXXXXXXXXXXXXXXXX |
ParitionKey | NodeID |
gaUA | Google Analytics Tracking ID |
TimeStamp | Date et heure UTC au format 1999-05-31T13:20:00.000-05:00 |
MonthStamp | Date UTC au format YYYY.MM |
DayStamp | Date UTC au format YYYY.MM.DD |
Service | Nom du service |
HostName | Nom du serveur |
HostPort | Port du serveur |
HostURL | Url de base du serveur |
NodeID | identifiant unique de noeud (host.port.service) |
NodeGUID | GUID identifiant le noeud (switch NODEGUID ou GUID unique de machine) |
systemOSName | Nom du système d'exploitation |
systemOSInfo | Chaîne d'information courte du système d'exploitation |
systemOSVersion | Version du système d'exploitation |
systemOSInfoEx | Chaîne d'information longue du système d'exploitation |
systemOSLanguage | Langage par défaut du système d'exploitation |
databaseInfo | Chaîne d'identification du serveur de base de données (de la base master) |
applicationInfo | Chaîne d'information de l'application 1000 |
hardwareInfo | Chaîne d'information sur le processeur et les coeurs |
systemInfo | Chaîne d'information affichée au démarrage |
serialNumber | Numéro de série du produit |
memoryVirtualSetSize | Taille de mémoire virtuelle du processus |
memoryWorkingSetSize | Taille de jeu de travail du processus |
memoryPageFault | Nombre de page fault du processus |
productName | Nom du produit (issu de la clé) |
productOVP | OVP du produit |
productInfo | Nom du produit (issu de l'exécutable) |
productVersion | Version du produit (issu de l'exécutable) |
* | toutes les informations disponibles liées à l'événement |
Propriétés liées au contexte utilisateur
Nom | Contenu |
---|---|
SessionID | Identifiant de session |
UserName | Nom de l'utilisateur |
UserID | Identifiant de l'utilisateur |
CustomerID | Numéro de série du produit |
SocName | Nom du dossier |
RemoteIP | Adresse distante de l'utilisateur |
AppName | Nom de l'application |
AppVersion | Version de l'application |
authDirectory | Nom de l'annuaire utilisé |
authGroup | Nom du groupe ayant identifié |
UserArgent | UserAgent de connexion |
Referer | Referer de connexion |
tenantID | Identifiant de tenant (multitenant) |
OrganizationName | Nom de l'organisation (multitenant) |
ShareSocietyName | Société de partage |
ShareRestitution | Mode de partage |
LoginInfo | Informations de connexion |
Propriétés liées à un événement de type exception
Nom | Contenu |
---|---|
exceptionEMessage | Message court de l'exception |
exceptionMessage | Message détaillé de l'exception |
exceptionClass | Classe de l'exception |
exceptionCode | Code de l'exception |
exceptionDatetime | Message court de l'exception |
exceptionThreadId | Thread qui a provoqué l'exception |
exceptionStack | Pile d'appel de l'exception |
* | toutes les informations disponibles liées à l'événement |
Propriétés définies pour les actions
Les actions sont des évènements liés à l'activité de l'utilisater, ils sont notamment utilisés pour la collecte des statistiques analytiques.
Nom | Contenu |
---|---|
ActionType | Type d'action |
ActionName | Nom de l'action |
ActionCategory | Catégrorie de l'action |
ActionTitle | Libellé de l'action |
ActionLabel | Identique à ActionTitle |
ActionParams | Paramètre de l'action |
ActionOrigin | Origin de l'action |
ActionReferrer | Référant de l'action |
ActionGroup1 | Regroupement 1 |
ActionGroup2 | Regroupement 2 |
ActionGroup3 | Regroupement 3 |
ActionTiming | Durée de l'action |
ActionValue | Valeur associée à l'action |
ActionValue1 | Valeur associée à l'action |
ActionValue2 | Valeur associée à l'action |
Les catégories associés aux actions :
Catégorie | Usage | Déclenchés par |
---|---|---|
hit | Ouverture d'écran | form |
processevent | Exécution de traitement | Défini dans le code métier |
timing | Durée d'utilisation | form |
uxevent | Evènements d'interface | dataset, lookup, menu |
Exemple, collecter les actions utilisateurs :
[\SOFTWARE\Sage\Ligne 1000\Administration\LOGManager\ACTIONS] type=file FileName=logs\actions-[NodeID]-[processId].csv categories=sysevent,confevent,taskevent,processevent,uxevent,event,hit,timing content=[Timestamp];[UserName];[SessionID];[MemoryVirtualSetSize];[ShareSocietyName];[actionCategory];[actionName];[actionTitle];[actionParams];[actionValue];[actionValue1];[actionReferrer];[actionOrigin];[ActionModule];[actionTiming]
Messages d'audit
(A partir de 700p)
Ces messages sont émis sous les types AUDIT_SUCCESS et AUDIT_FAILURE
Propriétés des messages d'audit
Nom | Contenu |
---|---|
auditAction | Action |
message | Libellé associé à l'action |
Liste des actions auditées
Action | Source | Type | informations |
---|---|---|---|
authenticate.login | session | success | utilisateur |
authenticate.login | session | failure | utilisateur |
authenticate.logout | session | success | utilisateur |
form.open | form | success | Interface concernée |
form.close | form | success | Interface concernée |
task.start | Automate | success | tâche démarrée |
task.success | Automate | success | tâche exécutée |
task.failure | Automate | failure | tâche exécutée |
Gestionnaires de log
Les gestionnaires de log sont des objets techniques réalisant l'interface avec le gestionnaire externe.
Leur rôle est de transmettre les messages aux gestionnaires externes.
- Un gestionnaire de log peut filtrer les évènements sur leur type (700p) et leur catégorie
- Un même évènement peut être géré par plusieurs gestionnaires de log
Les gestionnaires de log sont référencés dans le fichier de configuration du service par le paramètre "Log Manager" :
\SOFTWARE\Sage\Ligne 1000\Administration\Servers\suiteazure] ..... LOG Manager=AZURE,HHTP1 [\SOFTWARE\Sage\Ligne 1000\Administration\LOGManager\AZURE] type = azure .... [\SOFTWARE\Sage\Ligne 1000\Administration\LOGManager\HTTP1] type = http ....
Voir aussi :