M-Detect

Analyseur de log pour IBMI

De MappingDoc
Révision datée du 19 mars 2021 à 09:55 par Jdieu (discussion | contributions) (Exemple)

Introduction

Cette documentation décrit le cas d'usage d'un de nos clients de M-Detect permettant de détecter certaines erreurs dans leurs logs IBMI. (QPJOBLOG)

De manière générale, l'analyseur de log M-Detect permet de :

  • Anticiper les incidents
  • Identifier les erreurs dans la masse d’information
  • Réduire le temps consacré à l’analyse
  • Prévenir le bon interlocuteur suivant les règles définies


Le but principal étant d'Assurer la qualité de service en anticipant les incidents.

Principe de fonctionnement

Le fichier spool de log QPJOBLOG est envoyé à un serveur ONYX. Un fichier de paramétrage est utilisé pour déterminer quelles lignes du fichier QPJOBLOG doivoient être incluse et/ou excluse du rapport généré et envoyé par email par M-Detect.

MDE 1.jpg


MDE 2.jpg

Fichier de paramétrage

Le fichier de paramétrage permet de paramétrer les remontés de logs.

Exemple

<param>
   <spool>
     <attributes>                                      //Si le spool reçu depuis IMBI respecte les critères suivants
             <USER cmp="not-contains">MER</USER>                  //Le nom de l'utilisateur du spool ne contient pas la valeur "MER"                  
             <SPLF>QPJOBLOG</SPLF>                                //Le nom du spool est QPJOBLOG                  
             <SPLF>QPJOBLOG1</SPLF>                               //OU Le nom du spool est QPJOBLOG1                                
             <SPLNUM cmp="-le">1<SPLNUM>                          //Le numéro de spool est inférieur ou égal à 1  
             <JOB cmp="begin">FACPRD</JOB>                        //Le nom du job commence par FACPRD
             <HOSTNAME>ASP2</HOSTNAME>                            //Le nom du host vaut FACPRD
             <NBPAGES cmp="-le">500</NBPAGES>                     //Le nombre de pages est inférieur ou égal à 500
             <OUTQ cmp="-ne">PRT9</OUTQ>                          //L'OUTQ d'origine IBMI est différent de PRT9
             <USRDTA>MY CUSTOM DATA</USRDTA>                      //L'attribut du spool Référence utilisateur est égale à MY CUSTOM DATA
     </attributes>
     <variables>                                       //On initialise des variables avec le contenu du spool
             <variable name="VARENV" page="1" line="4" col="42" len="3"/>   //On crée et initialise la variable VARENV avec le contenu du spool en page 1, ligne 4, colonne 42 sur une longueur de 3
             <variable name="test" page="2" line="9" col="60" len="6"/>     //On crée et initialise la variable test avec le contenu du spool en page 2, ligne 9, colonne 60 sur une longueur de 6
     </variables>
     <email>                                          //paramétrage de l'envoi d'email
             <from>citmapping@mappingsuite.com</from>
             <to>nsmet@mappingsuite.com</to>
             <to>test@gmail.com</to>
             <cc>jdieu@mappingsuite.com</cc>
             <mll-file>ACH600_CDCHS.mll</mll-file>
             <mll-file>Mailing_list_2.txt</mll-file>
             <object>test VARENV- ASP1 ANO - Journalière - JOB de USERJOBNUM - DATESPL --> QPJOBLOG</object>
             <message>Ceci est le corps de message de mon mail pour USER</message>
     </email>
     <lines>
             <include col="58" cmp="-eq">ERR</include>
             <include col="40" len="50">err</include>
             <include>non restauré(s) dans</include>
             <include>; code fin 40 .</include>
             <include>; code fin 30 .</include>
             <include>; code fin 50 .</include>
             <include>; code fin 20 .</include>
             <include>; code fin 60 .</include>
             <include>LOT DEJA TRAITE LE</include>
             <include>lot refuse</include>
             <exclude>: la facture de la précédente</exclude>
             <exclude>Message....: ERR : données GOP incomplètes</exclude>
             <exclude>ERR : impossible de traiter Org</exclude>
             <exclude>ERR : Paramètrage non trouvé.</exclude>
             <nextline col="1" len="39" cmp="empty"></nextline>
             <reject-splf>Spool_demo</reject-splf>
     </lines>
   </spool>
</param>