<HTML> <HEAD> <TITLE>Ulmgraph Version 1.0: Uniform Logger Messages (ULM)</TITLE> </HEAD> <BODY> <A HREF="ulm-1.html">Previous page</A> <A HREF="ulm-3.html">Next page</A> <A HREF="ulm.html#toc2">Table of contents</A> <HR> <H2><A NAME="s2">2. Uniform Logger Messages (ULM)</A>  </H2>  <P>Le format ULM est un format qui permet de fixer le sens de chaque information prsente dans une ligne de journalisation. Le format est en cours de normalisation. Sa version la plus  jour au 1er fvrier 1997 (&lt;<CODE>draft-abela-ulm-01.txt</CODE>&gt;) est donne en annexe.</P>  <H2><A NAME="ss2.1">2.1 Grammaire</A>    </H2>  <P>Le pricipe du format ULM est simple: toute information est prcde d'un mot-cl qui prcise son type. Un nombre tout seul n'a pas de sens, mais <CODE>PS=3652</CODE> indique quel processus est concern. De mme, le nom <CODE>gandalf</CODE> peut correspondre  n'importe quoi, alors que <CODE>SRC.USR=gandalf</CODE> dsigne un utilisateur, <CODE>PRG=gandalf</CODE> un programme, et <CODE>DOC=gandalf</CODE> un nom de fichier.</P> <P>Chaque ligne d'ULM est une suite de couples <CODE>nom=valeur</CODE>, o <CODE>nom</CODE> est un mot-cl court et normalis qui dcrit le type de <CODE>valeur</CODE>. Par exemple, <CODE>PRG=ftpd LVL=Usage PS=10359 CMD=RETR DOC=x11.tar.gz</CODE> dcrit une utilisation du serveur ftp, processus 10359, pour tlcharger le fichier x11.tar.gz.</P> <P>Si une <CODE>valeur</CODE> contient des espaces, elle doit tre mise entre guillemets ("").</P>   <H2><A NAME="ss2.2">2.2 Noms de champs</A>    </H2>  <P>Une trentaine de champs sont prdfinis, dont 4 obligatoires. Voici une description succinte de quelques champs trs utiliss: <UL> <LI><CODE>LVL</CODE> (obligatoire). Indique le niveau (LeVeL) d'importance de la ligne. Les diffrents niveaux possibles sont: <UL> <LI><CODE>Emergency</CODE>. Cas de panique,  afficher sur les crans de tous les utilisateurs.</LI> <LI><CODE>Alert</CODE>. Problme  corriger immdiatement.</LI> <LI><CODE>Error</CODE>. Problme non urgent qui a surgit dans le droulement d'un programme systme.</LI> <LI><CODE>Warning</CODE>. Problme qui a surgit dans le fonctionnement interne d'un programme.</LI> <LI><CODE>Auth</CODE>. Une authentification a eu lieu. Si le champ STAT (statut) ne donne pas plus d'informations, c'est que cette authentification a chou.</LI> <LI><CODE>Security</CODE>. Le systme a utilis une rgle de protection de base, dont le rsultat est donn dans STAT.</LI> <LI><CODE>Usage</CODE>. Un programme a t utilis, de faon normale. Ce message dcrit une utilisation complte, en prcisant la dure si l'utilisation n'est pas instantane. Un messages qui n'indique que le dbut ou la fin d'une utilisation est plutt du niveau <CODE>Debug</CODE>.</LI> <LI><CODE>System</CODE>. Un programme a t utilis, mais pas le systme. Aucun utilisateur (sauf, indirectement, l'administrateur), n'est  l'origine de cette utilisation.</LI> <LI><CODE>Important</CODE>. Un vnement,  priori sans consquence immdiate, a eu lieu. Cet vnement pourrait s'avrer tre important dans le futur, comme le changement de configuration d'un routeur, par exemple.</LI> <LI><CODE>Debug</CODE>. Message sans importance dans le droulement normal des choses.</LI> </UL>  </LI> <LI><CODE>HOST</CODE> (obligatoire). Indique le nom du matriel  l'origine du message. </LI> <LI><CODE>DATE</CODE> (obligatoire). Moment instantann de l'vnement. Si l'vnement dure dans le temps, plusieurs ULM doivent tre gnrs  diffrentes dates, ou le champ DUR doit tre utilis. </LI> <LI><CODE>PRG</CODE> (obligatoire). Indique le nom du logiciel  l'origine du message. S'il s'agit d'un lment particulier d'une suite logicielle, le nom doit tre indiqu de faon hirarchique: suite.logiciel.sous-logiciel. </LI> <LI><CODE>DUR</CODE>. Dure (en secondes) de l'vnement qui s'est termin  DATE. Ce champ est obligatoire si l'ULM annonce la fin d'un vnement commenc plus tt. </LI> <LI><CODE>PS</CODE>. Numro du processus  l'origine de l'ULM. Sur certains systme, ce numro n'est pas unique, mais si DUR est prcis, PS est unique sur cette dure. </LI> <LI><CODE>CNT</CODE>. Nombre d'occurence. 1 par dfaut. </LI> <LI><CODE>VOL</CODE>. Volume en octets. </LI> <LI><CODE>CMD</CODE>. Commande lance. </LI> <LI><CODE>PROT</CODE>. Protocole utilis. </LI> <LI><CODE>DOC</CODE>. Document utilisateur concern (nom de fichier, URL, Message-ID). </LI> <LI><CODE>MSG</CODE>. Ce champ peut contenir toute information qui n'a pas sa place ailleurs. </LI> </UL> </P>   <HR> <A HREF="ulm-1.html">Previous page</A> <A HREF="ulm-3.html">Next page</A> <A HREF="ulm.html#toc2">Table of contents</A> </BODY> </HTML> 
