granicus.if.org Git - apache/blob - docs/manual/mod/mod_status.xml.fr

   1 <?xml version="1.0" encoding="UTF-8" ?>
   2 <!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
   3 <?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
   4 <!-- English Revision: 1755973 -->
   5 <!-- French translation : Lucien GENTIS -->
   6 <!-- Reviewed by : Vincent Deffontaines -->
   7
   8 <!--
   9  Licensed to the Apache Software Foundation (ASF) under one or more
  10  contributor license agreements.  See the NOTICE file distributed with
  11  this work for additional information regarding copyright ownership.
  12  The ASF licenses this file to You under the Apache License, Version 2.0
  13  (the "License"); you may not use this file except in compliance with
  14  the License.  You may obtain a copy of the License at
  15
  16      http://www.apache.org/licenses/LICENSE-2.0
  17
  18  Unless required by applicable law or agreed to in writing, software
  19  distributed under the License is distributed on an "AS IS" BASIS,
  20  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  21  See the License for the specific language governing permissions and
  22  limitations under the License.
  23 -->
  24
  25 <modulesynopsis metafile="mod_status.xml.meta">
  26
  27 <name>mod_status</name>
  28 <description>Fournit des informations sur les performances et l'activité
  29 du serveur</description>
  30 <status>Base</status>
  31 <sourcefile>mod_status.c</sourcefile>
  32 <identifier>status_module</identifier>
  33
  34
  35 <summary>
  36     <p>Le module Status permet à un administrateur de déterminer le
  37     niveau de performances de son serveur. Les statistiques instantanées
  38     du serveur sont présentées dans une page HTML sous une forme
  39     aisément lisible. Si nécessaire, cette page peut être configurée
  40     pour être automatiquement actualisée (sous réserve de
  41     compatibilité du navigateur). Une autre page fournit l'état
  42     instantané du serveur sous la forme d'une simple liste lisible par
  43     une machine.</p>
  44
  45     <p>Les détails fournis sont :</p>
  46
  47     <ul>
  48       <li>Le nombre de processus servant les requêtes</li>
  49
  50       <li>Le nombre de processus inactifs</li>
  51
  52       <li>L'état de chaque processus, le nombre de requêtes qu'il a
  53       traitées et le nombre total d'octets qu'il a servis (*)</li>
  54
  55       <li>Le nombre total d'accès effectués et d'octets servis (*)</li>
  56
  57       <li>Le moment où le serveur a été démarré/redémarré et le temps
  58       écoulé depuis</li>
  59
  60       <li>Les valeurs moyennes du nombre de requêtes par seconde, du
  61       nombre d'octets servis par seconde et du nombre d'octets par
  62       requête (*)</li>
  63
  64       <li>Le pourcentage CPU instantané utilisé par chaque processus et
  65       par l'ensemble des processus (*)</li>
  66
  67       <li>Les hôtes et requêtes actuellement en cours de traitement
  68       (*)</li>
  69     </ul>
  70
  71     <p>Les lignes se terminant par "(*)" ne sont disponibles que si la
  72     directive <directive module="core">ExtendedStatus</directive>
  73     est définie à <code>On</code>. Depuis la version
  74     2.3.6, le chargement de mod_status définit automatiquement
  75     <directive module="core">ExtendedStatus</directive> à On.</p>
  76
  77     <note>
  78       <strong>Important : lorsque <module>mod_status</module> est chargé, son
  79       gestionnaire sera disponible dans <em>tous</em> les fichiers de
  80       configuration, y compris ceux concernant un répertoire (comme les fichiers
  81       <code>.htaccess</code>). Ce comportement doit donc être pris en compte pour la
  82       gestion de la sécurité de votre site.</strong>
  83     </note>
  84 </summary>
  85
  86 <section id="enable">
  87     <title>Activation du rapport d'état</title>
  88
  89     <p>Pour n'activer les rapports d'état que pour les navigateurs
  90     appartenant au domaine example.com, ajoutez ces lignes à votre
  91     fichier de configuration <code>httpd.conf</code> :</p>
  92 <highlight language="config">
  93 &lt;Location "/etat-serveur"&gt;
  94     SetHandler server-status
  95     Require host example.com
  96 &lt;/Location&gt;
  97 </highlight>
  98
  99     <p>Il est alors possible d'obtenir les statistiques du serveur en
 100     utilisant un navigateur web et en accédant à la page
 101     <code>http://votre.serveur/etat-serveur</code>.</p>
 102 </section>
 103
 104 <section id="autoupdate">
 105
 106     <title>Actualisation automatique</title>
 107     <p>Vous pouvez faire en sorte que cette page d'état s'actualise
 108     elle-même automatiquement si votre navigateur supporte "refresh".
 109     Pour ce faire, accédez à la page
 110     <code>http://votre.serveur/etat-serveur?refresh=N</code>, pour que
 111     cette dernière soit actualisée toutes les N secondes.</p>
 112
 113 </section>
 114
 115 <section id="machinereadable">
 116
 117     <title>Fichier d'état lisible par une machine</title>
 118     <p>La page <code>http://votre.serveur/etat-serveur?auto</code>
 119     permet d'obtenir une version du fichier d'état lisible par une
 120     machine. Ceci s'avère intéressant dans le cadre d'une exécution
 121     automatique : voir le programme en Perl
 122     <code>log_server_status</code> situé dans le répertoire
 123     <code>/support</code> de votre distribution du serveur HTTP Apache.</p>
 124
 125 </section>
 126
 127 <section id="troubleshoot">
 128     <title>Utilisation de server-status pour la recherche de défauts de
 129     fonctionnement</title>
 130
 131     <p>La page <code>server-status</code> peut servir de point de départ
 132     à la recherche de défauts de fonctionnement lorsque votre serveur
 133     mobilise toutes les ressources disponibles (CPU ou mémoire), pour
 134     identifier quels clients ou requêtes sont la cause du problème.</p>
 135
 136     <p>Tout d'abord, assurez-vous que la directive <directive
 137     module="core">ExtendedStatus</directive> est bien définie à on, de
 138     façon à ce que vous puissiez avoir accès à toutes les informations à
 139     propos de la requête et du client pour chaque processus enfant ou
 140     thread.</p>
 141
 142     <p>Consultez ensuite la liste des processus en cours (à l'aide de
 143     <code>top</code>, ou d'un utilitaire de listage des processus
 144     similaire), afin d'identifier les processus coupables. Triez
 145     l'affichage de <code>top</code> par utilisation CPU ou mémoire, en
 146     fonction du problème rencontré.</p>
 147
 148     <p>Rechargez la page <code>server-status</code> et recherchez
 149     les identifiants des processus trouvés précédemment ; vous pourrez
 150     alors déterminer quelle requête est traitée par ces processus, pour
 151     quel client. Les requêtes peuvent apparaître de manière fugitive, et
 152     il se peut que vous deviez effectuer plusieurs essais avant de
 153     parvenir à les prendre en flagrant délit, pour ainsi dire.</p>
 154
 155     <p>Cette procédure <em>devrait</em> vous permettre de cerner quel
 156     client, ou type de requête, sont à l'origine de vos problèmes de
 157     charge. Il est probable que vous identifiiez une application web au
 158     comportement anormal, ou un client en train d'attaquer votre site.</p>
 159
 160 </section>
 161
 162
 163 </modulesynopsis>
 164