Manuel d'administration > Utilitaires > LogMix AE > Rassemblement des fichiers de rapport, log et trace

Rassemblement des fichiers de rapport, log et trace

Les composants écrivent des informations sur les activités dans des fichiers de rapport, log et trace. Comme ces fichiers ne sont pas consultables ensemble, il est difficile d'en faire l'analyse. C'est par exemple particulièrement ennuyeux pour les processus serveur qui sont d'habitude répartis sur plusieurs ordinateurs.

L'utilitaire AE Log Mix vous aide à résoudre ce problème en créant un fichier unique à partir de plusieurs fichiers de rapport, log ou trace. Les différentes entrées des fichiers sont reclassées afin de les mettre dans un ordre chronologique.

 Attention : les traces doivent être activités seulement après une demande expresse du support.

Les rapports d'objets ou les entrées de log de processus serveur et d'Agent peuvent être déchargés de la base de données à l'aide de l'utilitaire AE DB Archive. AE Log Mix est capable de traiter ces rapports ainsi que les fichiers log et trace.

Déroulement

Déchargement des rapports en fonction des besoins

AE DB Archive offre des paramètres vous permettant de réduire le choix des rapports. Sélectionnez en fonction du nom des objets, des processus serveur ou des Agents ainsi que de la période de création des rapports. L'utilitaire recherche des rapports compris entièrement ou partiellement dans cet intervalle et décharge l'intégralité du contenu du rapport dans un fichier log.

 Un fichier distinct est créé pour chaque rapport.

Les fichiers créés obtiennent un nom spécial. Vous êtes libre de choisir le préfixe. AE Log Mix transmet les fichiers devant être rassemblés en fonction des préfixes des noms. Le nom contient en outre le nom de l'objet ainsi que la date à laquelle le rapport a été créé.

Exemple :

server_UC4#WP001_20070215_123045.txt

Attention : l'utilitaire interrompt le processus si un fichier du même nom existe déjà dans le répertoire de sortie !

Pour décharger les rapports, il faut exécuter l'utilitaire AE DB Archive via la ligne de commande avec la syntaxe suivante :

UCYBDBAR -B -Xrapport -CClient-Nnom_serveur[-D1date et heure de début] [-D2date et heure de fin ] [-Pchemin et préfixe du fichier ]

 Vous trouverez de plus amples informations sur les Paramètres de démarrage dans le document du même nom.

La progression de la création des fichiers s'affiche en pourcentage dans le fichier log de l'utilitaire.

Vous obtenez comme résultat plusieurs fichiers de rapport dans le répertoire que vous avez indiqué lors de l'exécution de l'utilitaire.

Création d'un fichier commun

AE Log Mix peut rassembler plusieurs fichiers de rapport, log et trace en un seul fichier.

Exécutez l'utilitaire AE Log Mix via la ligne de commande avec la syntaxe suivante :

UCYBLGMX -B [-Lchemin et nom des fichiers ] [-Fchemin et nom du fichier cible]

Lors de la sélection des fichiers, le préfixe de nom défini auparavant est maintenant très utile.

 Vous trouverez de plus amples informations sur les Paramètres de démarrage dans le document du même nom.

Vous obtenez comme résultat un fichier commun contenant les contenus des fichiers sélectionnés triés chronologiquement. Pour qu'il soit possible de savoir de quel fichier ils sont issus malgré le nouvel ordre des éléments, tous les fichiers sont énumérés au début et un numéro leur est attribué. Au début de chaque ligne apparaît le numéro du fichier dont est issu l'élément.

Il peut y avoir des différences d'heure entre les divers ordinateurs sur lesquels les composants s'exécutent. Si une différence d'heure est détectée, une entrée est écrite dans le fichier de rapport, log ou trace. AE Log Mix prend en compte cet écart lors du classement chronologique. La marque horaire de l'élément n'est cependant pas modifiée. Mais un "T" marque ces lignes-là.

Exemple :

Trace 01 : C:\AE\REPORTS\TRACES\WPSRV_TRC_001_##.TXT
Trace 02 : C:\AE\REPORTS\TRACES\WPSRV_TRC_002_##.TXT
Trace 03 : C:\AE\REPORTS\TRACES\WPSRV_TRC_003_##.TXT

02 - 20060620/163723.373 -  U0003450 Le fichier de trace a été ouvert avec le bouton '2400090000000000'.
01 - 20060620/163723.373 -  U0003491 Différence d'heure '0/00:02:11' soit '131' secondes par rapport au serveur primaire
03 T 20060620/163723.373 -  U0009909 TRACE (BINDPAR:  MQSRV_System      )            F074F57D 000008

Le décalage horaire est toujours calculé par rapport au processus de travail primaire (PWP). C'est le premier PWP trouvé lors du traitement des fichiers qui compte. Si le rôle du PWP passe à un autre processus de travail au sein des fichiers, c'est la première différence d'heure reconnue qui est cependant préservée pour l'organisation (pour des raisons de visibilité).

Codes retour

AE DB Archive :

Code retour

Description

1

Il manque le paramètre -C.

2

Il manque le paramètre -N.

3

Une mauvaise date a été indiquée.

4

Impossible de créer le fichier, car le nom est trop long en raison du préfixe sélectionné.

5

Un fichier du même nom existe déjà.

6

Cette période contient plus de 99 enregistrements statistiques.

AE Log Mix :

Code retour

Description

1

Aucun des fichiers ne correspond à la sélection.

2

Plus de 99 fichiers ont été trouvés.

3

Le paramètre -L n'a pas été spécifié et n'a pas non plus été fourni dans le fichier INI.