-<?xml version="1.0"?>
+<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
-<!-- English Revision: 1673945:1755973 (outdated) -->
+<!-- English Revision: 1755973 -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
<modulesynopsis metafile="mod_status.xml.meta">
<name>mod_status</name>
-<description>Fournit des informations sur les performances et l'activité
+<description>Fournit des informations sur les performances et l'activité
du serveur</description>
<status>Base</status>
<sourcefile>mod_status.c</sourcefile>
<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
+ <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>
+ <p>Les détails fournis sont :</p>
<ul>
- <li>Le nombre de processus servant les requêtes</li>
+ <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>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 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>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
+ <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>
+ requête (*)</li>
- <li>Le pourcentage CPU instantané utilisé par chaque processus et
+ <li>Le pourcentage CPU instantané utilisé par chaque processus et
par l'ensemble des processus (*)</li>
- <li>Les hôtes et requêtes actuellement en cours de traitement
+ <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>
+ 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>
+
+ <note>
+ <strong>Important : lorsque <module>mod_status</module> est chargé, son
+ gestionnaire sera disponible dans <em>tous</em> les fichiers de
+ configuration, y compris ceux concernant un répertoire (comme les fichiers
+ <code>.htaccess</code>). Ce comportement doit donc être pris en compte pour la
+ gestion de la sécurité de votre site.</strong>
+ </note>
</summary>
<section id="enable">
- <title>Activation du rapport d'état</title>
+ <title>Activation du rapport d'état</title>
- <p>Pour n'activer les rapports d'état que pour les navigateurs
- appartenant au domaine example.com, ajoutez ces lignes à votre
+ <p>Pour n'activer les rapports d'état que pour les navigateurs
+ appartenant au domaine example.com, ajoutez ces lignes à votre
fichier de configuration <code>httpd.conf</code> :</p>
<highlight language="config">
<Location "/etat-serveur">
</highlight>
<p>Il est alors possible d'obtenir les statistiques du serveur en
- utilisant un navigateur web et en accédant à la page
+ 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
+ <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>
+ cette dernière soit actualisée toutes les N secondes.</p>
</section>
<section id="machinereadable">
- <title>Fichier d'état lisible par une machine</title>
+ <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
+ 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>log_server_status</code> situé dans le répertoire
<code>/support</code> de votre distribution du serveur HTTP Apache.</p>
- <note>
- <strong>Veuillez noter que si <module>mod_status</module> a été
- chargé 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>
<section id="troubleshoot">
- <title>Utilisation de server-status pour la recherche de défauts de
+ <title>Utilisation de server-status pour la recherche de défauts de
fonctionnement</title>
- <p>La page <code>server-status</code> peut servir de point de départ
- à la recherche de défauts de fonctionnement lorsque votre serveur
- mobilise toutes les ressources disponibles (CPU ou mémoire), pour
- identifier quels clients ou requêtes sont la cause du problème.</p>
+ <p>La page <code>server-status</code> peut servir de point de départ
+ à la recherche de défauts de fonctionnement lorsque votre serveur
+ mobilise toutes les ressources disponibles (CPU ou mémoire), pour
+ identifier quels clients ou requêtes sont la cause du problème.</p>
<p>Tout d'abord, assurez-vous que la directive <directive
- module="core">ExtendedStatus</directive> est bien définie à on, de
- façon à ce que vous puissiez avoir accès à toutes les informations à
- propos de la requête et du client pour chaque processus enfant ou
+ module="core">ExtendedStatus</directive> est bien définie à on, de
+ façon à ce que vous puissiez avoir accès à toutes les informations à
+ propos de la requête et du client pour chaque processus enfant ou
thread.</p>
- <p>Consultez ensuite la liste des processus en cours (à l'aide de
+ <p>Consultez ensuite la liste des processus en cours (à l'aide de
<code>top</code>, ou d'un utilitaire de listage des processus
similaire), afin d'identifier les processus coupables. Triez
- l'affichage de <code>top</code> par utilisation CPU ou mémoire, en
- fonction du problème rencontré.</p>
+ l'affichage de <code>top</code> par utilisation CPU ou mémoire, en
+ fonction du problème rencontré.</p>
<p>Rechargez la page <code>server-status</code> et recherchez
- les identifiants des processus trouvés précédemment ; vous pourrez
- alors déterminer quelle requête est traitée par ces processus, pour
- quel client. Les requêtes peuvent apparaître de manière fugitive, et
+ les identifiants des processus trouvés précédemment ; vous pourrez
+ alors déterminer quelle requête est traitée par ces processus, pour
+ quel client. Les requêtes peuvent apparaître de manière fugitive, et
il se peut que vous deviez effectuer plusieurs essais avant de
- parvenir à les prendre en flagrant délit, pour ainsi dire.</p>
+ parvenir à les prendre en flagrant délit, pour ainsi dire.</p>
- <p>Cette procédure <em>devrait</em> vous permettre de cerner quel
- client, ou type de requête, sont à l'origine de vos problèmes de
+ <p>Cette procédure <em>devrait</em> vous permettre de cerner quel
+ client, ou type de requête, sont à l'origine de vos problèmes de
charge. Il est probable que vous identifiiez une application web au
comportement anormal, ou un client en train d'attaquer votre site.</p>