<page xmlns="http://projectmallard.org/1.0/"
      type="topic" id="settings-monitoring" xml:lang="fr">

<info>
  <link type="guide" xref="index#system-settings" />
  <revision docversion="0.1" date="2013-07-06" status="draft"/>
  <credit type="author">
    <name>Frédéric Péters</name>
    <email>fpeters@entrouvert.com</email>
  </credit>
  <desc>Intégration avec un serveur StatsD</desc>
</info>

<title>Surveillance et suivi applicatif</title>

<section id="statsd">
  <title>StatsD</title>

  <p>
    <app>w.c.s.</app> peut communiquer à un serveur <app>StatsD</app> une série
    d'informations concernant le traitement des requêtes HTTP et
    l'authentification des utilisateurs.
  </p>

  <p>
    L'adresse du serveur <app>StatsD</app> est récupérer d'une variable
    d'environnement nommée <var>QOMMON_STATSD_HOSTNAME</var> qui sera
    communément positionnée au niveau du serveur Web; par défaut
    <var>localhost</var> sera utilisé.
  </p>

  <listing>
    <title>Exemple de configuration Apache</title>
    <code>SetEnv QOMMON_STATSD_HOSTNAME statsd.example.net</code>
  </listing>

  <p>
    Les clés positionnées sont de la forme
    <code>wcs.<var>domaine</var>.<var>clé</var></code>, les points présents dans le
    nom de domaine remplacés par des tirets; par exemple
    <code>wcs.teleservices-example-net.login-error</code>.
  </p>

  <p>
    Les informations suivantes sont communiquées :
  </p>

  <table shade="rows">
    <tr>
      <td><p><code>login-submit</code></p></td>
      <td><p>Compteur incrémenté lors de la validation d'une page
      d'authentification</p></td>
    </tr>
    <tr>
      <td><p><code>login-error</code></p></td>
      <td><p>Compteur incrémenté lors d'une tentative d'authentification
      infructueuse.</p></td>
    </tr>
    <tr>
      <td><p><code>login-success</code></p></td>
      <td><p>Compteur incrémenté lors d'une tentative d'authentification
      réussie</p></td>
    </tr>
    <tr>
      <td><p><code>successful-request</code></p></td>
      <td><p>Compteur incrémenté à la fin d'une requête HTTP réussie</p></td>
    </tr>
    <tr>
      <td><p><code>failed-request</code></p></td>
      <td><p>Compteur incrémenté à la fin d'une requête HTTP avortée par
             une erreur interne (erreur HTTP 500)</p></td>
    </tr>
  </table>
</section>

</page>
