2 <!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
3 <?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
4 <!-- English Revision : 1089085 -->
5 <!-- French translation : Lucien GENTIS -->
6 <!-- Reviewed by : Vincent Deffontaines -->
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
16 http://www.apache.org/licenses/LICENSE-2.0
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.
25 <modulesynopsis metafile="mod_status.xml.meta">
27 <name>mod_status</name>
28 <description>Fournit des informations sur les performances et l'activité
29 du serveur</description>
31 <sourcefile>mod_status.c</sourcefile>
32 <identifier>status_module</identifier>
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
45 <p>Les détails fournis sont :</p>
48 <li>Le nombre de processus servant les requêtes</li>
50 <li>Le nombre de processus inactifs</li>
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>
55 <li>Le nombre total d'accès effectués et d'octets servis (*)</li>
57 <li>Le moment où le serveur a été démarré/redémarré et le temps
58 écoulé depuis</li>
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>
64 <li>Le pourcentage CPU instantané utilisé par chaque processus et
65 par l'ensemble des processus (*)</li>
67 <li>Les hôtes et requêtes actuellement en cours de traitement
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>
79 <title>Activation du rapport d'état</title>
81 <p>Pour n'activer les rapports d'état que pour les navigateurs
82 appartenent au domaine example.com, ajoutez ces lignes à votre
83 fichier de configuration <code>httpd.conf</code> :</p>
85 <Location /etat-serveur><br />
87 SetHandler server-status<br />
89 Require host example.com<br />
94 <p>Il est alors possible d'obtenir les statistiques du serveur en
95 utilisant un navigateur web et en accédant à la page
96 <code>http://votre.serveur/etat-serveur</code>.</p>
99 <section id="autoupdate">
101 <title>Actualisation automatique</title>
102 <p>Vous pouvez faire en sorte que cette page d'état s'actualise
103 elle-même automatiquement si votre navigateur supporte "refresh".
104 Pour ce faire, accédez à la page
105 <code>http://votre.serveur/etat-serveur?refresh=N</code>, pour que
106 cette dernière soit actualisée toutes les N secondes.</p>
110 <section id="machinereadable">
112 <title>Fichier d'état lisible par une machine</title>
113 <p>La page <code>http://votre.serveur/etat-serveur?auto</code>
114 permet d'obtenir une version du fichier d'état lisible par une
115 machine. Ceci s'avère intéressant dans le cadre d'une exécution
116 automatique : voir le programme en Perl
117 <code>log_server_status</code> situé dans le répertoire
118 <code>/support</code> de votre distribution du serveur HTTP Apache.</p>
121 <strong>Veuillez noter que si <module>mod_status</module> a été
122 compilé dans le serveur, son gestionnaire sera disponible dans
123 <em>tous</em> les fichiers de configuration, y compris les
124 fichiers de configuration de <em>niveau répertoire</em> (par
125 exemple <code>.htaccess</code>), ce qui peut avoir des
126 répercutions quant à la sécurité de votre site.</strong>
131 <section id="troubleshoot">
132 <title>Utilisation de server-status pour la recherche de défauts de
133 fonctionnement</title>
135 <p>La page <code>server-status</code> peut servir de point de départ
136 à la recherche de défauts de fonctionnement lorsque votre serveur
137 mobilise toutes les ressources disponibles (CPU ou mémoire), pour
138 identifier quels clients ou requêtes sont la cause du problème.</p>
140 <p>Tout d'abord, assurez-vous que la directive <directive
141 module="core">ExtendedStatus</directive> est bien définie à on, de
142 façon à ce que vous puissiez avoir accès à toutes les informations à
143 propos de la requête et du client pour chaque processus enfant ou
146 <p>Consultez ensuite la liste des processus en cours (à l'aide de
147 <code>top</code>, ou d'un utilitaire de listage des processus
148 similaire), afin d'identifier les processus coupables. Triez
149 l'affichage de <code>top</code> par utilisation CPU ou mémoire, en
150 fonction du problème rencontré.</p>
152 <p>Rechargez la page <code>server-status</code> et recherchez
153 les identifiants des processus trouvés précédemment ; vous pourrez
154 alors déterminer quelle requête est traitée par ces processus, pour
155 quel client. Les requêtes peuvent apparaître de manière fugitive, et
156 il se peut que vous deviez effectuer plusieurs essais avant de
157 parvenir à les prendre en flagrant délit, pour ainsi dire.</p>
159 <p>Cette procédure <em>devrait</em> vous permettre de cerner quel
160 client, ou type de requête, sont à l'origine de vos problèmes de
161 charge. Il est probable que vous identifiiez une application web au
162 comportement anormal, ou un client en train d'attaquer votre site.</p>
projects / apache / blob