Activation du rapport d'état

mod_status Fournit des informations sur les performances et l'activité du serveur Base mod_status.c status_module

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.

Les détails fournis sont :

Le nombre de processus servant les requêtes
Le nombre de processus inactifs
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 (*)
Le nombre total d'accès effectués et d'octets servis (*)
Le moment où le serveur a été démarré/redémarré et le temps écoulé depuis
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 (*)
Le pourcentage CPU instantané utilisé par chaque processus et par Apache tout entier (*)
Les hôtes et requêtes actuellement en cours de traitement (*)

Les lignes se terminant par "(*)" ne sont disponibles que si la directive ExtendedStatus est définie à On.

Activation du rapport d'état

Pour n'activer les rapports d'état que pour les navigateurs appartenent au domaine exemple.com, ajoutez ces lignes à votre fichier de configuration httpd.conf :

<Location /etat-serveur>
SetHandler server-status

Order Deny,Allow
Deny from all
Allow from .exemple.com
</Location>

Il est alors possible d'obtenir les statistiques du serveur en utilisant un navigateur web et en accédant à la page http://votre.serveur/etat-serveur.

Actualisation automatique

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 http://votre.serveur/etat-serveur?refresh=N, pour que cette dernière soit actualisée toutes les N secondes.

Fichier d'état lisible par une machine

La page http://votre.serveur/etat-serveur?auto 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 log_server_statussitué dans le répertoire /support de la distribution d'Apache.

Veuillez noter que si mod_status a été compilé dans le serveur, son gestionnaire sera disponible dans tous les fichiers de configuration, y compris les fichiers de configuration de niveau répertoire (par exemple .htaccess), ce qui peut avoir des répercutions quant à la sécurité de votre site.

ExtendedStatus Extrait des informations d'état étendues pour chaque requête ExtendedStatus On|Off ExtendedStatus Off server config

Cette directive s'applique au serveur dans son ensemble, et ne peut pas être activée/désactivée pour un serveur virtuel particulier. Notez que l'extraction des informations d'état étendues peut ralentir le serveur.

SeeRequestTail Détermine si mod_status affiche les 63 premiers caractères d'une requête ou les 63 derniers, en supposant que la requête elle-même possède plus de 63 caractères. SeeRequestTail On|Off SeeRequestTail Off server config Disponible depuis la version 2.2.7 d'Apache.

Avec ExtendedStatus On, mod_status affiche la véritable requête en cours de traitement. Pour des raisons historiques, seuls 63 caractères de la requête sont réellement stockés à des fins d'affichage. Cette directive permet de déterminer si ce sont les 63 premiers caractères qui seront stockés (c'est le comportement par défaut et celui des versions antérieures à 2.2.7), ou si ce sont les 63 derniers. Ceci ne s'applique bien entendu que si la taille de la requête est de 64 caractères ou plus.

Si Apache traite la requête GET /disque1/stockage/apache/htdocs/images/rep-images1/nourriture/pommes.jpg HTTP/1.1 , l'affichage de la requête par mod_status se présentera comme suit :

Off (défaut)	GET /disque1/stockage/apache/htdocs/images/rep-images1/nourritu
On	apache/htdocs/images/rep-images1/nourriture/pommes.jpg HTTP/1.1