<chapter id="debuglevels"><title>Le fichier journal et la collecte des données d'erreur de EVMS</title>

<para>Ce chapitre traite du journal des informations et erreurs d'EVMS et des divers niveaux de consignation. On y explique également comment changer le niveau de consignation.</para>


<sect1><title>À propos du journal d'EVMS</title>
<para>À chaque fois que le moteur EVMS est ouvert, il crée un journal qui s'appelle <filename>/var/log/evmsEngine.log</filename>. Le moteur enregistre également jusqu'à neuf copies de ses précédentes sessions, dans les fichiers <filename>/var/log/evmsEngine.n.log</filename>, où <filename>n</filename> est le numéro de la session, entre en 1 et 9.</para>

</sect1>

<sect1 id="loglevels"><title>Niveaux de consignation du journal</title>
<para>Vous pouvez choisir différents niveaux de consignation possibles qui seront relevés dans <filename>/var/log/evmsEngine.log</filename>. Le niveau de consignation "le plus bas", <filename>critical</filename> (critique), ne relève que les messages concernant les problèmes systèmes graves, alors que le &quot;plus haut&quot; niveau, <filename>everything</filename> (tout), relève tous les messages liés à la consignation. Quand vous spécifiez un niveau particulier de consignation, le moteur relève des messages pour ce niveau et tous les niveaux plus bas que celui-ci.</para>

<para>Le tableau suivant donne la liste des niveaux de consignation autorisables et les informations qu'ils fournissent :</para>  
<para><table><title>Niveaux de consignation EVMS</title><tgroup cols="2"><colspec colnum="1" colname="C1"/><colspec colnum="2" colname="C2"/>
<thead><row><entry>Niveau</entry>
<entry>Description</entry> </row></thead>
<tbody>
<row><entry>Critical (critique)</entry><entry>La santé du système ou du moteur est en danger ; par exemple, une opération a échoué car il n'y a pas assez de mémoire.</entry></row>
<row><entry>Serious (sérieux)</entry><entry>Une opération n'a pas réussi.</entry></row>
<row><entry>Error (erreur)</entry><entry>L'utilisateur a provoqué une erreur. Les messages d'erreur sont fournis pour aider l'utilisateur à corriger le problème.</entry></row>
<row><entry>Warning (avertissement)</entry><entry>Une erreur est survenue et le système pourrait ne pas continuer normalement.</entry></row>
<row><entry>Default (par défaut)</entry><entry>Une erreur est survenue et le système a continué normalement.</entry></row>
<row><entry>Details (détails)</entry><entry>Informations détaillées sur le système.</entry></row>
<row><entry>Entry_Exit (entrée - sortie)</entry><entry>Suit les entrées et sorties des fonctions.</entry></row>
<row><entry>Debug (déboguage)</entry><entry>Informations aidant l'utilisateur à déboguer un problème.</entry></row>
<row><entry>Extra (supplément)</entry><entry>Plus d'informations que dans le niveau &quot;Debug&quot; pour aider l'utilisateur à déboguer un problème.</entry></row>
<row><entry>Everything (tout)</entry><entry>Sortie verbeuse.</entry></row>
</tbody></tgroup></table></para>

    
</sect1>
<sect1 id="specifylevels"><title>Spécification des niveaux de consignation</title>
<para>Par défaut, lorsque n'importe laquelle des interfaces EVMS est ouverte, le moteur consigne le niveau <filename>Par défaut</filename> des messages dans le fichier <filename>/var/log/evmsEngine.log</filename>. Cependant, si votre système rencontre des difficultés et que vous souhaitez en savoir plus sur ce qui se passe, vous pouvez élever le niveau de consignation ; si vous souhaitez moins d'informations, vous pouvez baisser le niveau de consignation. Pour modifier le niveau de consignation, spécifiez le paramètre <command>-d</command> et le niveau de consignation lors de l'appel d'ouverture de l'interface. Les exemples suivant montrent comment ouvrir les différentes interfaces avec le plus haut niveau de consignation (<filename>everything</filename>) :</para>

<programlisting>GUI:    evmsgui -d everything</programlisting>
<programlisting>Ncurses:  evmsn -d everything</programlisting>
<programlisting>CLI:    evms -d everything</programlisting>

<note><title>NOTE</title>
<para>Si vous utilisez la liste de diffusion EVMS pour avoir de l'aide concernant un problème, il sera plus facile pour nous de vous aider si vous nous fournissez le journal créé lorsque vous ouvrez une des interfaces (comme on l'a indiqué dans les commandes précédentes).
</para>
</note>

<para>L'interface d'EVMS vous permet de modifier le niveau de consignation pendant une session du moteur. Pour ce faire, suivez ces étapes :

<orderedlist>
<listitem><para>Sélectionnez <menuchoice><guimenu>Settings (paramètres)</guimenu>
  <guimenuitem>Log Level (niveau de consignation)</guimenuitem>
  <guimenuitem>Engine (moteur)</guimenuitem></menuchoice>.
  </para></listitem>

  <listitem><para>Cliquez sur le niveau [<guibutton>Level</guibutton>] que vous souhaitez.
  </para></listitem>
</orderedlist></para>

<para>La commande CLI <command>probe</command> ouvre et ferme le moteur, ce qui provoque le démarrage d'un nouveau journal. Le journal qui existait avant l'utilisation de la commande <command>probe</command> est renommé <filename>/var/log/evmsEngine.1.log</filename>, et le nouveau journal est nommé <filename>/var/log/evmsEngine.log</filename>.
</para>

<para>Si vous comptez utiliser fréquemment un niveau de consignation qui n'est pas celui par défaut, vous pouvez spécifier le niveau de consignation par défaut dans <filename>/etc/evms.conf</filename> plutôt que d'avoir à utiliser l'option <command>-d</command> lorsque vous démarrez l'interface utilisateur. L'option "debug_level" dans la section "engine" règle le niveau de consignation par défaut lors de l'ouverture du moteur. Le paramètre dans <filename>/etc/evms.conf</filename> est ignoré si l'option <command>-d</command> est utilisée lors de l'appel de commande.
</para>

</sect1>

</chapter>
