1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
|
<?xml version="1.0"?>
<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
<!-- English Revision : 903777 -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
<!--
Licensed to the Apache Software Foundation (ASF) under one or more
contributor license agreements. See the NOTICE file distributed with
this work for additional information regarding copyright ownership.
The ASF licenses this file to You under the Apache License, Version 2.0
(the "License"); you may not use this file except in compliance with
the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
-->
<modulesynopsis metafile="mod_status.xml.meta">
<name>mod_status</name>
<description>Fournit des informations sur les performances et l'activité
du serveur</description>
<status>Base</status>
<sourcefile>mod_status.c</sourcefile>
<identifier>status_module</identifier>
<summary>
<p>Le module Status permet à un administrateur de déterminer le
niveau de performances de son serveur. Les statistiques instantanées
du serveur sont présentées dans une page HTML sous une forme
aisément lisible. Si nécessaire, cette page peut être configurée
pour être automatiquement actualisée (sous réserve de
compatibilité du navigateur). Une autre page fournit l'état
instantané du serveur sous la forme d'une simple liste lisible par
une machine.</p>
<p>Les détails fournis sont :</p>
<ul>
<li>Le nombre de processus servant les requêtes</li>
<li>Le nombre de processus inactifs</li>
<li>L'état de chaque processus, le nombre de requêtes qu'il a
traitées et le nombre total d'octets qu'il a servis (*)</li>
<li>Le nombre total d'accès effectués et d'octets servis (*)</li>
<li>Le moment où le serveur a été démarré/redémarré et le temps
écoulé depuis</li>
<li>Les valeurs moyennes du nombre de requêtes par seconde, du
nombre d'octets servis par seconde et du nombre d'octets par
requête (*)</li>
<li>Le pourcentage CPU instantané utilisé par chaque processus et
par Apache tout entier (*)</li>
<li>Les hôtes et requêtes actuellement en cours de traitement
(*)</li>
</ul>
<p>Les lignes se terminant par "(*)" ne sont disponibles que si la
directive <directive module="core">ExtendedStatus</directive>
est définie à <code>On</code>. Depuis la version
2.3.6, le chargement de mod_status définit automatiquement
<directive module="core">ExtendedStatus</directive> à On.</p>
</summary>
<section id="enable">
<title>Activation du rapport d'état</title>
<p>Pour n'activer les rapports d'état que pour les navigateurs
appartenent au domaine example.com, ajoutez ces lignes à votre
fichier de configuration <code>httpd.conf</code> :</p>
<example>
<Location /etat-serveur><br />
SetHandler server-status<br />
<br />
Order Deny,Allow<br />
Deny from all<br />
Allow from .example.com<br />
</Location>
</example>
<p>Il est alors possible d'obtenir les statistiques du serveur en
utilisant un navigateur web et en accédant à la page
<code>http://votre.serveur/etat-serveur</code>.</p>
</section>
<section id="autoupdate">
<title>Actualisation automatique</title>
<p>Vous pouvez faire en sorte que cette page d'état s'actualise
elle-même automatiquement si votre navigateur supporte "refresh".
Pour ce faire, accédez à la page
<code>http://votre.serveur/etat-serveur?refresh=N</code>, pour que
cette dernière soit actualisée toutes les N secondes.</p>
</section>
<section id="machinereadable">
<title>Fichier d'état lisible par une machine</title>
<p>La page <code>http://votre.serveur/etat-serveur?auto</code>
permet d'obtenir une version du fichier d'état lisible par une
machine. Ceci s'avère intéressant dans le cadre d'une exécution
automatique : voir le programme en Perl
<code>log_server_status</code>situé dans le répertoire
<code>/support</code> de la distribution d'Apache.</p>
<note>
<strong>Veuillez noter que si <module>mod_status</module> a été
compilé dans le serveur, son gestionnaire sera disponible dans
<em>tous</em> les fichiers de configuration, y compris les
fichiers de configuration de <em>niveau répertoire</em> (par
exemple <code>.htaccess</code>), ce qui peut avoir des
répercutions quant à la sécurité de votre site.</strong>
</note>
</section>
</modulesynopsis>
|
