Documentation du Dr FRAPPE

Ce wiki regroupe les résultats de mes expériences en informatique accumulés au cours de mes recherches sur le net.

Dans la mesure du possible, j'ai cité mes sources ; il en manque certainement… :-)

Différences

Ci-dessous, les différences entre deux révisions de la page.

Lien vers cette vue comparative

Les deux révisions précédentesRévision précédente
Prochaine révision
Révision précédente
logiciel:internet:awstats:start [2020/10/22 22:54] adminlogiciel:internet:awstats:start [2022/08/13 21:57] (Version actuelle) – modification externe 127.0.0.1
Ligne 3: Ligne 3:
 ====== Awstats : Surveillance d'un serveur HTTP ====== ====== Awstats : Surveillance d'un serveur HTTP ======
  
-====== Introduction ======+===== Introduction =====
  
 **AWStats** analyse sur vos serveurs (Apache ou autre) les logs des sites Web qui s'y trouvent. **AWStats** analyse sur vos serveurs (Apache ou autre) les logs des sites Web qui s'y trouvent.
Ligne 11: Ligne 11:
 </WRAP> </WRAP>
  
-====== Pré-requis ======+===== Pré-requis =====
  
   - un **serveur HTTP** (//apache//, //lighty// ou autre) :   - un **serveur HTTP** (//apache//, //lighty// ou autre) :
     * installé sur une machine     * installé sur une machine
-    * accessible par le domaine **monsite.tld** (ou **framboise.local** pour un RPI sur le réseau),+    * accessible par le domaine **monsite.tld** (ou **framboise.local** pour un Raspberry Pi sur le réseau),
     * sa racine étant en **/var/www/html/**.<WRAP center round info 60%>     * sa racine étant en **/var/www/html/**.<WRAP center round info 60%>
 que nous noterons **$ROOT** = /var/www/html/ que nous noterons **$ROOT** = /var/www/html/
Ligne 24: Ligne 24:
 $ sudo apachectl restart</cli> $ sudo apachectl restart</cli>
  
-====== Installation ======+===== Installation =====
  
 Nous allons __placer **awstats** sur le serveur__, sans installer le paquet. Cette méthode a l'avantage de ne rien modifier sur la machine hôte. Nous allons __placer **awstats** sur le serveur__, sans installer le paquet. Cette méthode a l'avantage de ne rien modifier sur la machine hôte.
Ligne 76: Ligne 76:
   * en pdf sur [[http://monsite.tld/awstats/docs/awstats.pdf]]   * en pdf sur [[http://monsite.tld/awstats/docs/awstats.pdf]]
  
-====== Configuration ======+===== Configuration =====
  
-===== Configuration d'Awstats =====+==== Configuration d'Awstats ====
  
 Les fichiers de configuration se trouvent en : ** $ROOT/awstats/wwwroot/cgi-bin/** Les fichiers de configuration se trouvent en : ** $ROOT/awstats/wwwroot/cgi-bin/**
Ligne 95: Ligne 95:
 $ cd $ROOT/awstats/wwwroot/cgi-bin/</cli> $ cd $ROOT/awstats/wwwroot/cgi-bin/</cli>
  
-==== Configuration pour la totalité du site ====+=== Configuration pour la totalité du site ===
  
 Nous supposons que les stats seront publiées à l'adresse [[http://stats.monsite.tld]] Nous supposons que les stats seront publiées à l'adresse [[http://stats.monsite.tld]]
Ligne 109: Ligne 109:
  
 <WRAP center round tip 60%> <WRAP center round tip 60%>
-  LogType+  LogType
   : <code>LogType=W</code>Le fichier de log à analyser concerne un site web   : <code>LogType=W</code>Le fichier de log à analyser concerne un site web
-  LogFile+  LogFile
   : <code>LogFile="/var/www/html/awstats/tools/logresolvemerge.pl /var/log/apache2/access.* |"</code>Fichiers journaux du serveur (apache, lighty ...) à analyser   : <code>LogFile="/var/www/html/awstats/tools/logresolvemerge.pl /var/log/apache2/access.* |"</code>Fichiers journaux du serveur (apache, lighty ...) à analyser
-    logresolvemerge.pl+    logresolvemerge.pl
     : Syntaxe :<code>logresolvemerge.pl [options] file_1 ... file_n</code>crée un fichier journal de sortie unique, trié par date, à partir de plusieurs sources. Deux options utiles :     : Syntaxe :<code>logresolvemerge.pl [options] file_1 ... file_n</code>crée un fichier journal de sortie unique, trié par date, à partir de plusieurs sources. Deux options utiles :
-      dnslookup+      dnslookup
       : Faire une recherche DNS inversée sur les adresses IP       : Faire une recherche DNS inversée sur les adresses IP
-      addfilename+      addfilename
       : avec plusieurs fichiers, le nom de fichier peut être ajouté dans le premier champ du fichier de sortie.       : avec plusieurs fichiers, le nom de fichier peut être ajouté dans le premier champ du fichier de sortie.
     : Explorez /var/log pour savoir l'emplacement exact des fichiers (pour apache , c'est souvent /var/log/apache2, chercher aussi /var/log/httpd ...     : Explorez /var/log pour savoir l'emplacement exact des fichiers (pour apache , c'est souvent /var/log/apache2, chercher aussi /var/log/httpd ...
-  LogFormat+  LogFormat
   : <code>LogFormat=1</code>Format du fichier journal (1, 2, 3 ou 4) ; 1 est le plus courant pour Apache. Voir la doc pour les détails.   : <code>LogFormat=1</code>Format du fichier journal (1, 2, 3 ou 4) ; 1 est le plus courant pour Apache. Voir la doc pour les détails.
-  SiteDomain+  SiteDomain
   : <code>SiteDomain="monsite.tld"</code>Site de base   : <code>SiteDomain="monsite.tld"</code>Site de base
-  HostAliases+  HostAliases
   : <code>HostAliases="localhost 127.0.0.1 REGEX[monsite\.tld$]"</code>(renseignez votre nom de domaine (//"monsite"//) et son extension (//"tld"//) dans l'expression REGEX pour que tous les domaines correspondent)   : <code>HostAliases="localhost 127.0.0.1 REGEX[monsite\.tld$]"</code>(renseignez votre nom de domaine (//"monsite"//) et son extension (//"tld"//) dans l'expression REGEX pour que tous les domaines correspondent)
-  DNSLookup+  DNSLookup
   : <code>DNSLookup=1</code>DNS complètement activé   : <code>DNSLookup=1</code>DNS complètement activé
-  AllowToUpdateStatsFromBrowser+  AllowToUpdateStatsFromBrowser
   : <code>AllowToUpdateStatsFromBrowser=1</code>Mettre un lien de mise à jour des stats sur la page de résultats   : <code>AllowToUpdateStatsFromBrowser=1</code>Mettre un lien de mise à jour des stats sur la page de résultats
-  AllowFullYearView+  AllowFullYearView
   : <code>AllowFullYearView=3</code>affichage de l'année entière. Options possibles :\\ 0 - désactivé\\ 1 - Activé pour le mode CLI uniquement et la valeur n'est pas visible dans la liste\\ 2 - Idem que 1 mais la valeur est visible et non activable\\ 3 - autorisé en modes CLI et CGI   : <code>AllowFullYearView=3</code>affichage de l'année entière. Options possibles :\\ 0 - désactivé\\ 1 - Activé pour le mode CLI uniquement et la valeur n'est pas visible dans la liste\\ 2 - Idem que 1 mais la valeur est visible et non activable\\ 3 - autorisé en modes CLI et CGI
-  SkipFiles+  SkipFiles
   : <code>SkipFiles="/cgi-bin/awstats.pl"</code>pour éviter le logging l'activité propre à awstats   : <code>SkipFiles="/cgi-bin/awstats.pl"</code>pour éviter le logging l'activité propre à awstats
   : fichiers à ignorer lors du calcul des statistiques.\\ Séparez les entrées par un espace.\\ Vous ouvez utiliser une expression régulière, par exemple pour ignorer le dossier travail : %%REGEX[^\/travail]%%   : fichiers à ignorer lors du calcul des statistiques.\\ Séparez les entrées par un espace.\\ Vous ouvez utiliser une expression régulière, par exemple pour ignorer le dossier travail : %%REGEX[^\/travail]%%
Ligne 170: Ligne 170:
 C'est tout pour la configuration générale. C'est tout pour la configuration générale.
  
-==== Configuration pour un domaine particulier ====+=== Configuration pour un domaine particulier ===
  
 Même principe que pour la configuration générale. Même principe que pour la configuration générale.
Ligne 189: Ligne 189:
  
 <WRAP center round box 60%> <WRAP center round box 60%>
-  **SiteDomain**+  **SiteDomain**
   : Domaine en cause   : Domaine en cause
-  **HostAliases**+  **HostAliases**
   : renseignez le domaine et l'extension dans l'expression REGEX   : renseignez le domaine et l'extension dans l'expression REGEX
-  **SkipHosts**+  **SkipHosts**
   : permet d'éviter le logging de l'activité en provenance du réseau local   : permet d'éviter le logging de l'activité en provenance du réseau local
  
Ligne 200: Ligne 200:
 Ajoutez tous les réglages voulus cf [[#Configuration pour la totalité du site]]. Ajoutez tous les réglages voulus cf [[#Configuration pour la totalité du site]].
  
-==== Configuration pour un sous-domaine ====+=== Configuration pour un sous-domaine ===
  
 Configurons maintenant chaque sous-domaine. Configurons maintenant chaque sous-domaine.
Ligne 222: Ligne 222:
 La configuration d'Awstats est maintenant terminée. La configuration d'Awstats est maintenant terminée.
  
-===== Configuration du serveur =====+==== Configuration du serveur ====
  
 Il faut maintenant que le serveur web connaisse **awstats**. Il faut maintenant que le serveur web connaisse **awstats**.
Ligne 232: Ligne 232:
 </WRAP> </WRAP>
  
-==== Cas d'un serveur Apache ====+=== Cas d'un serveur Apache ===
  
 Basé sur la documentation fournie dans [[http://monsite.tld/awstats/docs]] Basé sur la documentation fournie dans [[http://monsite.tld/awstats/docs]]
Ligne 279: Ligne 279:
 <WRAP center round info 60%> <WRAP center round info 60%>
 Apache 2.4 a quelques changements : Apache 2.4 a quelques changements :
-  AllowOverride+  AllowOverride
   : est désormais par défaut à //None//   : est désormais par défaut à //None//
-  Require all granted+  Require all granted
   : remplace le couple Order/Allow   : remplace le couple Order/Allow
-  Require all denied+  Require all denied
   : remplace le couple Order/Deny   : remplace le couple Order/Deny
-  Define+  Define
   : possibilité de définir une variable :<code>Define variable valeur</code>à utiliser comme suit :<code>${variable}</code>même entre des doubles quotes.   : possibilité de définir une variable :<code>Define variable valeur</code>à utiliser comme suit :<code>${variable}</code>même entre des doubles quotes.
  
Ligne 334: Ligne 334:
 <code>62.161.78.75 - - [dd/mmm/yyyy:hh:mm:ss +0000] "GET / HTTP/1.1" 200 1234 "http://www.from.com/from.html" "Mozilla/4.0 (compatible; MSIE 5.01; Windows NT 5.0)"</code> <code>62.161.78.75 - - [dd/mmm/yyyy:hh:mm:ss +0000] "GET / HTTP/1.1" 200 1234 "http://www.from.com/from.html" "Mozilla/4.0 (compatible; MSIE 5.01; Windows NT 5.0)"</code>
  
-==== Cas d'un serveur lighty ====+=== Cas d'un serveur lighty ===
  
   * Ouvrez avec les droits d'administration le fichier **/etc/lighttpd/lighttpd.conf** pour vérifier les modules activés (dé-commentés au début du fichier). C'est en principe le cas du module **mod_alias** qui est activé par défaut.   * Ouvrez avec les droits d'administration le fichier **/etc/lighttpd/lighttpd.conf** pour vérifier les modules activés (dé-commentés au début du fichier). C'est en principe le cas du module **mod_alias** qui est activé par défaut.
Ligne 359: Ligne 359:
 sudo chmod -R 6770 *</code> sudo chmod -R 6770 *</code>
  
- +==== Mise à jour toutes les 10 minutes (multi-domaines) ====
-===== Mise à jour toutes les 10 minutes (multi-domaines) =====+
  
 Si vous êtes en multi domaines, donc avec plusieurs fichiers de configuration dans **[RACINE]/awstats/**, le plus simple est de faire appel à **awstats_updateall** ( (c) Laurent Destailleur) Si vous êtes en multi domaines, donc avec plusieurs fichiers de configuration dans **[RACINE]/awstats/**, le plus simple est de faire appel à **awstats_updateall** ( (c) Laurent Destailleur)
Ligne 371: Ligne 370:
 </code> </code>
  
-====== Utilisation ======+===== Utilisation =====
  
   * Pour afficher les les statistiques pour le domaine **domaine.tld**, visitez la page [[http://domaine.tld/stat]].   * Pour afficher les les statistiques pour le domaine **domaine.tld**, visitez la page [[http://domaine.tld/stat]].
Ligne 380: Ligne 379:
 </WRAP> </WRAP>
  
-===== Désinstallation ======+==== Désinstallation =====
  
 Pour supprimer complètement cette application, il suffit de : Pour supprimer complètement cette application, il suffit de :
Ligne 388: Ligne 387:
   * effacer le répertoire **/var/www/awstats**   * effacer le répertoire **/var/www/awstats**
  
-====== Voir aussi ======+===== Voir aussi =====
  
   * **(en)** [[http://www.awstats.org/]] (site officiel du logiciel)   * **(en)** [[http://www.awstats.org/]] (site officiel du logiciel)