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
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
|
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head><!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Fichiers journaux - Serveur Apache HTTP Version 2.4</title>
<link href="./style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
<link href="./style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
<link href="./style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" /><link rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
<script src="./style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossaire</a> | <a href="./sitemap.html">Plan du site</a></p>
<p class="apache">Serveur Apache HTTP Version 2.4</p>
<img alt="" src="./images/feather.gif" /></div>
<div class="up"><a href="./"><img title="<-" alt="<-" src="./images/left.gif" /></a></div>
<div id="path">
<a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="./">Version 2.4</a></div><div id="page-content"><div id="preamble"><h1>Fichiers journaux</h1>
<div class="toplang">
<p><span>Langues Disponibles: </span><a href="./en/logs.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/logs.html" title="Franais"> fr </a> |
<a href="./ja/logs.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/logs.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/logs.html" hreflang="tr" rel="alternate" title="Trke"> tr </a></p>
</div>
<p>Pour vritablement grer un serveur web,
il est ncessaire de disposer d'un
retour d'informations propos de l'activit et des performances du
serveur, ainsi que de tout problme qui pourrait survenir. Le serveur HTTP
Apache propose des fonctionnalits de journalisation souples et trs
compltes. Ce document dcrit comment configurer ces fonctionnalits de
journalisation et interprter le contenu des journaux.</p>
</div>
<div id="quickview"><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#overview">Vue d'ensemble</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#security">Avertissement propos de la scurit</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#errorlog">Journal des erreurs</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#permodule">Journalisation par module</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#accesslog">Journal des accs</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#rotation">Rotation des journaux</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#piped">Journaux redirigs</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#virtualhost">Htes virtuels</a></li>
<li><img alt="" src="./images/down.gif" /> <a href="#other">Autres fichiers journaux</a></li>
</ul><ul class="seealso"><li><a href="#comments_section">Commentaires</a></li></ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="overview" id="overview">Vue d'ensemble</a></h2>
<table class="related"><tr><th>Modules Apparents</th><th>Directives Apparentes</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_log_config.html">mod_log_config</a></code></li><li><code class="module"><a href="./mod/mod_log_forensic.html">mod_log_forensic</a></code></li><li><code class="module"><a href="./mod/mod_logio.html">mod_logio</a></code></li><li><code class="module"><a href="./mod/mod_cgi.html">mod_cgi</a></code></li></ul></td><td /></tr></table>
<p>
Le serveur HTTP Apache fournit toute une varit de mcanismes
diffrents pour la journalisation de tout ce qui peut se passer au
sein de votre serveur, depuis la requte initiale, en passant par le
processus de mise en correspondance des URLs, et jusqu' la fermeture
de la connexion, y compris toute erreur pouvant survenir au cours du
traitement. De plus, certains modules tiers fournissent des
fonctionnalits de journalisation ou insrent des entres dans les
fichiers journaux existants, et les applications comme les programmes
CGI, les scripts PHP ou autres gestionnaires peuvent envoyer des
messages vers le journal des erreurs du serveur.
</p>
<p>
Ce document dcrit le fonctionnement des modules de journalisation
fournis en standard avec le serveur httpd.
</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="security" id="security">Avertissement propos de la scurit</a></h2>
<p>Tout utilisateur qui a les droits en criture sur le rpertoire dans
lequel Apache httpd crit ses journaux pourra quasi
certainement avoir accs l'uid sous lequel le serveur est dmarr, en
l'occurrence habituellement root. N'accordez <em>PAS</em> aux utilisateurs
l'accs en criture au rpertoire dans lequel les journaux sont stocks
sans savoir exactement quelles en seraient les consquences ; voir le
document <a href="misc/security_tips.html">conseils sur la scurit</a>
pour plus de dtails.</p>
<p>En outre, les journaux peuvent contenir des informations fournies
directement par un client, sans caractres d'chappement. Des clients mal
intentionns peuvent donc insrer des caractres de contrle dans les
journaux, et il convient par consquent d'tre trs prudent lors de la
manipulation des journaux bruts.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="errorlog" id="errorlog">Journal des erreurs</a></h2>
<table class="related"><tr><th>Modules Apparents</th><th>Directives Apparentes</th></tr><tr><td><ul><li><code class="module"><a href="./mod/core.html">core</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/core.html#errorlog">ErrorLog</a></code></li><li><code class="directive"><a href="./mod/core.html#loglevel">LogLevel</a></code></li></ul></td></tr></table>
<p>Le journal des erreurs du serveur, dont le nom et la localisation sont
dfinis par la directive <code class="directive"><a href="./mod/core.html#errorlog">ErrorLog</a></code>,
est le journal le plus important. C'est dans celui-ci
que le dmon Apache httpd va envoyer les informations de diagnostic et
enregistrer toutes les erreurs qui surviennent lors du traitement des
requtes. Lorsqu'un problme survient au dmarrage du serveur ou pendant
son fonctionnement, la premire chose faire est de regarder dans ce
journal, car il vous renseignera souvent sur le problme rencontr et
la manire d'y remdier.</p>
<p>Le journal des erreurs est habituellement enregistr dans un fichier
(en gnral <code>error_log</code> sur les systmes de type Unix et
<code>error.log</code> sur Windows et OS/2). Sur les systmes de type Unix,
le serveur peut aussi enregistrer ses erreurs dans
<code>syslog</code> ou les
<a href="#piped">rediriger vers un programme</a> par l'intermdiaire d'un
tube de communication (pipe).</p>
<p>Le format par dfaut du journal des erreurs est descriptif et de forme
relativement libre. Certaines informations apparaissent cependant dans la
plupart des entres du journal. Voici un message typique
titre d'exemple : </p>
<div class="example"><p><code>
[Wed Oct 11 14:32:52 2000] [error] [client 127.0.0.1]
client denied by server configuration:
/export/home/live/ap/htdocs/test
</code></p></div>
<p>Le premier champ de l'entre du journal est la date et l'heure du
message. Le second champ indique la svrit de l'erreur rapporte. La
directive <code class="directive"><a href="./mod/core.html#loglevel">LogLevel</a></code> permet de
restreindre le type des erreurs qui doivent tre enregistres
dans le journal des erreurs en dfinissant leur niveau de svrit. Le
troisime champ contient l'adresse IP du client qui a gnr l'erreur.
Vient ensuite le message proprement dit, qui indique dans ce cas que le
serveur a t configur pour interdire l'accs au client. Le serveur
indique le chemin systme du document requis (et non
son chemin web).</p>
<p>Une grande varit de messages diffrents peuvent apparatre dans le
journal des erreurs. La plupart d'entre eux sont similaires l'exemple
ci-dessus. Le journal des erreurs peut aussi contenir des informations de
dbogage en provenance de scripts CGI. Toute information qu'un script CGI
crit sur la sortie d'erreurs standard <code>stderr</code> sera recopie
telle quelle dans le journal des erreurs.</p>
<p>La directive <code class="directive"><a href="./mod/core.html#errorlogformat">ErrorLogFormat</a></code>
vous permet de personnaliser le format du journal des erreurs, et de
dfinir les informations journaliser. Si
<code class="module"><a href="./mod/mod_unique_id.html">mod_unique_id</a></code> est prsent, vous pouvez utiliser le
drapeau <code>%L</code> la fois dans le journal des erreurs et
dans le
journal des accs, ce qui aura pour effet de gnrer un identifiant
d'entre qui vous permettra de corrler les entres du journal des
erreurs avec celles du journal des accs.</p>
<p>Pendant la phase de test, il est souvent utile de visualiser en continu
le journal des erreurs afin de dtecter tout problme ventuel. Sur les
systmes de type Unix, ceci s'effectue l'aide de la commande :</p>
<div class="example"><p><code>
tail -f error_log
</code></p></div>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="permodule" id="permodule">Journalisation par module</a></h2>
<p>La directive <code class="directive"><a href="./mod/core.html#loglevel">LogLevel</a></code> permet
de spcifier un niveau de svrit de journalisation pour chaque
module. Vous pouvez ainsi rsoudre un problme propre un module particulier
en augmentant son volume de journalisation sans augmenter ce volume
pour les autres modules. Ceci est particulirement utile lorsque
vous voulez obtenir des dtails sur le fonctionnement de modules
comme <code class="module"><a href="./mod/mod_proxy.html">mod_proxy</a></code> ou <code class="module"><a href="./mod/mod_rewrite.html">mod_rewrite</a></code>.</p>
<p>Pour ce faire, vous devez spcifier le nom du module dans votre
directive <code class="directive">LogLevel</code> :</p>
<pre class="prettyprint lang-config">LogLevel info rewrite:trace5</pre>
<p>Dans cet exemple, le niveau de journalisation gnral est dfini
info, et <code>trace5</code> pour <code class="module"><a href="./mod/mod_rewrite.html">mod_rewrite</a></code>.</p>
<div class="note">Cette directive remplace les directives de journalisation par
module des versions prcdentes du serveur, comme
<code>RewriteLog</code>.</div>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="accesslog" id="accesslog">Journal des accs</a></h2>
<table class="related"><tr><th>Modules Apparents</th><th>Directives Apparentes</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_log_config.html">mod_log_config</a></code></li><li><code class="module"><a href="./mod/mod_setenvif.html">mod_setenvif</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/mod_log_config.html#customlog">CustomLog</a></code></li><li><code class="directive"><a href="./mod/mod_log_config.html#logformat">LogFormat</a></code></li><li><code class="directive"><a href="./mod/mod_setenvif.html#setenvif">SetEnvIf</a></code></li></ul></td></tr></table>
<p>Le journal des accs au serveur
enregistre toutes les requtes que traite
ce dernier. La localisation et le contenu du journal des accs sont dfinis
par la directive <code class="directive"><a href="./mod/mod_log_config.html#customlog">CustomLog</a></code>.
La directive <code class="directive"><a href="./mod/mod_log_config.html#logformat">LogFormat</a></code>
permet de simplifier la slection du contenu du journal. Cette section
dcrit comment configurer le serveur pour l'enregistrement des informations
dans le journal des accs.</p>
<p>Bien videmment, le stockage d'informations dans le journal des accs
n'est que le point de dpart de la gestion de la journalisation. L'tape
suivante consiste analyser ces informations de faon pouvoir en
extraire des statistiques utiles. L'analyse de journaux en gnral est en
dehors du sujet de ce document et ne fait pas vraiment partie intgrante
du travail du serveur web lui-mme. Pour plus d'informations propos de ce
sujet et des applications ddies l'analyse de journaux, vous pouvez vous
rfrer <a href="http://dmoz.org/Computers/Software/Internet/ Site_Management/Log_analysis/">Open Directory</a> ou
<a href="http://dir.yahoo.com/Computers_and_Internet/Software/ Internet/World_Wide_Web/Servers/Log_Analysis_Tools/">Yahoo</a>.</p>
<p>Diffrentes versions du dmon Apache httpd utilisaient d'autres modules
et directives pour contrler la journalisation des accs, l'instar de
mod_log_referer, mod_log_agent, et de la directive
<code>TransferLog</code>. La directive
<code class="directive"><a href="./mod/mod_log_config.html#customlog">CustomLog</a></code> rassemble
dsormais les fonctionnalits de toutes les anciennes directives.</p>
<p>Le format du journal des accs est hautement configurable. Il est
dfini l'aide d'une chane de format qui ressemble sensiblement la
chane de format de style langage C de printf(1). Vous trouverez quelques
exemples dans les sections suivantes. Pour une liste exhaustive de ce que
peut contenir une chane de format, vous pouvez vous rfrer au chapitre
<a href="mod/mod_log_config.html#formats">chanes de format</a> de la
documentation du module <code class="module"><a href="./mod/mod_log_config.html">mod_log_config</a></code>.</p>
<h3><a name="common" id="common">Format habituel du journal</a></h3>
<p>Voici une configuration typique pour le journal des accs :</p>
<pre class="prettyprint lang-config">LogFormat "%h %l %u %t \"%r\" %>s %b" common
CustomLog logs/access_log common</pre>
<p>Ici est dfinie l'<em>identit</em> <code>common</code> qui est
ensuite associe une chane de format de journalisation particulire.
La chane de format est constitue de directives dbutant par le
caractre %, chacune d'entre elles indiquant au serveur d'enregistrer
un lment particulier d'information. Des caractres littraux peuvent
aussi tre insrs dans la chane de format ; il seront copis tels
quels dans le flux de sortie destin la journalisation.
Les guillemets (<code>"</code>) doivent tre chappes en les faisant
prcder d'un anti-slash (<code>\</code>) afin qu'elles ne soient pas
interprtes comme la fin de la chane de format. La chane de format
peut aussi contenir les caractres de contrle spciaux
"<code>\n</code>" et "<code>\t</code>" pour insrer respectivement
un passage la ligne et une tabulation.</p>
<p>La directive <code class="directive"><a href="./mod/mod_log_config.html#customlog">CustomLog</a></code>
dfinit un nouveau fichier journal en l'associant l'identit
prcdemment dfinie. Le chemin du nom de fichier associ au journal
des accs est relatif au chemin dfini par la directive
<code class="directive"><a href="./mod/core.html#serverroot">ServerRoot</a></code>, sauf s'il
dbute par un slash.</p>
<p>La configuration ci-dessus va enregistrer les entres de
journalisation selon un format connu sous le nom de
Common Log Format (CLF) pour "Format de journalisation standard".
Ce format standard peut tre produit par de nombreux serveurs web
diffrents et lu par de nombreux programmes d'analyse de journaux.
Les entres de fichier journal gnres selon le format CLF
ressemblent ceci :</p>
<div class="example"><p><code>
127.0.0.1 - frank [10/Oct/2000:13:55:36 -0700] "GET
/apache_pb.gif HTTP/1.0" 200 2326
</code></p></div>
<p>Chaque partie de cette entre de journal est dcrite
dans ce qui suit.</p>
<dl>
<dt><code>127.0.0.1</code> (<code>%h</code>)</dt>
<dd>Il s'agit de l'adresse IP du client (l'hte distant) qui a envoy
la requte au serveur. Si la directive
<code class="directive"><a href="./mod/core.html#hostnamelookups">HostnameLookups</a></code> est positionne
<code>On</code>, le serveur va essayer de dterminer le nom de l'hte
et de l'enregistrer la place de l'adresse IP. Cette configuration
n'est cependant pas recommande car elle peut ralentir le serveur de
manire significative. Il est par consquent prfrable d'utiliser un
processeur d'analyse de journaux a posteriori
tel que <code class="program"><a href="./programs/logresolve.html">logresolve</a></code>
pour dterminer les noms d'hte. L'adresse IP indique ici n'est pas
ncessairement l'adresse IP de la machine devant laquelle se trouve
l'utilisateur. Si un serveur mandataire s'intercale entre le serveur
et l'utilisateur, l'adresse indique sera celle du mandataire et non
celle de la machine l'origine de la requte.</dd>
<dt><code>-</code> (<code>%l</code>)</dt>
<dd>Le "trait d'union" indique que la portion d'information
correspondante n'est pas disponible. Dans le cas prsent, l'information
non disponible est l'identit (RFC 1413) du client telle que dtermine
par <code>identd</code> sur la machine cliente. Cette information est
trs peu fiable et ne devrait jamais tre utilise, sauf dans le cas
de rseaux internes troitement contrls. Le dmon httpd ne cherchera
d'ailleurs obtenir cette information que si la directive
<code class="directive"><a href="./mod/mod_ident.html#identitycheck">IdentityCheck</a></code> est positionne
<code>On</code>.</dd>
<dt><code>frank</code> (<code>%u</code>)</dt>
<dd>Il s'agit de l'identifiant utilisateur de la personne qui a
demand le document, issu d'une authentification HTTP.
Ce mme identifiant est en gnral fourni aux scripts CGI par
l'intermdiaire de la valeur de la variable d'environnement
<code>REMOTE_USER</code>. Si le statut de la requte (voir plus loin)
est 401, cette identifiant n'est pas fiable car l'utilisateur n'est
pas encore authentifi. Si le document n'est pas protg par
mot de passe, cette partie d'information sera reprsente par
"<code>-</code>", comme la partie prcdente.</dd>
<dt><code>[10/Oct/2000:13:55:36 -0700]</code>
(<code>%t</code>)</dt>
<dd>
L'heure laquelle la requte a t reue.
Le format est le suivant :
<p class="indent">
<code>[jour/mois/anne:heure:minutes:secondes zone]<br />
jour = 2*chiffre<br />
mois = 3*lettre<br />
anne = 4*chiffre<br />
heure = 2*chiffre<br />
minutes = 2*chiffre<br />
secondes = 2*chiffre<br />
zone = (`+' | `-') 4*chiffre</code>
</p>Il est possible de modifier le format d'affichage de l'heure
en spcifiant <code>%{format}t</code> dans la chane de format du
journal, o <code>format</code> est une chane de format
de la forme de celle de la fonction <code>strftime(3)</code>
de la bibliothque C standard, ou choisie parmi les
formats spciaux supports. Pour plus de dtails,
reportez-vous aux. <a href="mod/mod_log_config.html#formats">chanes de format</a>
de <code class="module"><a href="./mod/mod_log_config.html">mod_log_config</a></code>.
</dd>
<dt><code>"GET /apache_pb.gif HTTP/1.0"</code>
(<code>\"%r\"</code>)</dt>
<dd>La ligne de la requte du client est place entre guillemets.
Elle contient de nombreuses informations utiles. Tout d'abord, la
mthode utilise par le client est <code>GET</code>. Ensuite, le
client a demand la ressource <code>/apache_pb.gif</code>, et enfin,
le client a utilis le protocole <code>HTTP/1.0</code>. Il est aussi
possible d'enregistrer sparment une ou plusieurs parties de la
requte. Par exemple, la chane de format "<code>%m %U %q %H</code>"
va enregistrer la mthode, le chemin, la chane de la requte et le
protocole, ce qui donnera le mme rsultat que
"<code>%r</code>".</dd>
<dt><code>200</code> (<code>%>s</code>)</dt>
<dd>C'est le code de statut que le serveur retourne au client. Cette
information est trs importante car elle indique si la requte a fait
l'objet d'une rponse positive (codes commenant par 2), une
redirection (codes commenant par 3), une erreur due au client (codes
commenant par 4), ou une erreur due au serveur (codes commenant
par 5). Vous trouverez la liste complte des codes de statut possibles
dans la <a href="http://www.w3.org/Protocols/rfc2616/ rfc2616.txt">specification HTTP</a> (RFC2616 section 10).</dd>
<dt><code>2326</code> (<code>%b</code>)</dt>
<dd>La dernire partie indique la taille de l'objet retourn au client,
en-ttes non compris. Si aucun contenu n'a t retourn au client, cette
partie contiendra "<code>-</code>". Pour indiquer l'absence de contenu
par "<code>0</code>", utilisez <code>%B</code> au lieu de
<code>%b</code>.</dd>
</dl>
<h3><a name="combined" id="combined">Combined Log Format (Format de journalisation combin)</a></h3>
<p>Une autre chane de format couramment utilise est le
"Combined Log Format" (Format de journalisation combin). Il s'utilise
comme suit :</p>
<pre class="prettyprint lang-config">LogFormat "%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-agent}i\"" combined
CustomLog log/access_log combined</pre>
<p>Ce format est identique au Common Log Format, avec deux champs
supplmentaires. Chacun de ces deux champs utilise la directive
commenant par le caractre "%" <code>%{<em>header</em>}i</code>,
o <em>header</em> peut tre n'importe quel en-tte de requte HTTP.
Avec ce format, le journal des accs se prsentera comme suit :</p>
<div class="example"><p><code>
127.0.0.1 - frank [10/Oct/2000:13:55:36 -0700] "GET
/apache_pb.gif HTTP/1.0" 200 2326
"http://www.example.com/start.html" "Mozilla/4.08 [en]
(Win98; I ;Nav)"
</code></p></div>
<p>Les champs supplmentaires sont :</p>
<dl>
<dt><code>"http://www.example.com/start.html"</code>
(<code>\"%{Referer}i\"</code>)</dt>
<dd>L'en-tte "Referer" (sic) de la requte HTTP. Il indique le site
depuis lequel le client prtend avoir lanc sa requte. (Ce doit tre
la page qui contient un lien vers <code>/apache_pb.gif</code> ou
inclut ce dernier fichier).</dd>
<dt><code>"Mozilla/4.08 [en] (Win98; I ;Nav)"</code>
(<code>\"%{User-agent}i\"</code>)</dt>
<dd>L'en-tte User-Agent de la requte HTTP. C'est une information
d'identification que le navigateur du client envoie propos
de lui-mme.</dd>
</dl>
<h3><a name="multiple" id="multiple">Journaux d'accs multiples</a></h3>
<p>Plusieurs journaux d'accs peuvent tre crs en spcifiant tout
simplement plusieurs directives
<code class="directive"><a href="./mod/mod_log_config.html#customlog">CustomLog</a></code> dans le
fichier de configuration. Par exemple, les directives suivantes vont
crer trois journaux d'accs. Le premier contiendra les informations
de base CLF, le second les informations du Referer, et le troisime
les informations sur le navigateur. Les deux dernires directives
<code class="directive"><a href="./mod/mod_log_config.html#customlog">CustomLog</a></code> montrent
comment simuler les effets des directives <code>ReferLog</code> et
<code>AgentLog</code>.</p>
<pre class="prettyprint lang-config">LogFormat "%h %l %u %t \"%r\" %>s %b" common
CustomLog logs/access_log common
CustomLog logs/referer_log "%{Referer}i -> %U"
CustomLog logs/agent_log "%{User-agent}i"</pre>
<p>Cet exemple montre aussi qu'il n'est pas obligatoire d'associer
une chane de format un alias au moyen de la directive
<code class="directive"><a href="./mod/mod_log_config.html#logformat">LogFormat</a></code>. Elle peut
tre dfinie directement dans la ligne de la directive
<code class="directive"><a href="./mod/mod_log_config.html#customlog">CustomLog</a></code>.</p>
<h3><a name="conditional" id="conditional">Journalisation conditionnelle</a></h3>
<p>Il est parfois souhaitable d'exclure certaines entres des journaux
d'accs en fonction des caractristiques de la requte du client. On
peut aisment accomplir ceci l'aide des
<a href="env.html">variables d'environnement</a>. Tout d'abord, une
variable d'environnement doit tre dfinie pour indiquer que la
requte remplit certaines conditions. Pour ceci, on utilise en gnral
la directive <code class="directive"><a href="./mod/mod_setenvif.html#setenvif">SetEnvIf</a></code>,
puis la clause <code>env=</code> de la directive
<code class="directive"><a href="./mod/mod_log_config.html#customlog">CustomLog</a></code> pour inclure
ou exclure les requtes pour lesquelles
la variable d'environnement est dfinie.
Quelques exemples :</p>
<pre class="prettyprint lang-config"># Marque les requtes en provenance de l'interface loop-back
SetEnvIf Remote_Addr "127\.0\.0\.1" dontlog
# Marque les requtes pour le fichier robots.txt
SetEnvIf Request_URI "^/robots\.txt$" dontlog
# Journalise toutes les autres requtes
CustomLog logs/access_log common env=!dontlog</pre>
<p>Autre exemple, imaginons l'enregistrement des requtes en provenance
d'utilisateurs de langue anglaise dans un journal, et celles des autres
utilisateurs dans un autre journal.</p>
<pre class="prettyprint lang-config"> SetEnvIf Accept-Language "en" english<br />
CustomLog logs/english_log common env=english<br />
CustomLog logs/non_english_log common env=!english</pre>
<p>Dans le contexte d'une mise en cache, il peut tre
intressant de connatre l'efficacit du cache. Pour y parvenir,
on pourrait utiliser cette mthode simple :</p>
<pre class="prettyprint lang-config">SetEnv CACHE_MISS 1
LogFormat "%h %l %u %t "%r " %>s %b %{CACHE_MISS}e" common-cache
CustomLog logs/access_log common-cache</pre>
<p><code class="module"><a href="./mod/mod_cache.html">mod_cache</a></code> va s'excuter avant
<code class="module"><a href="./mod/mod_env.html">mod_env</a></code>, et si son action est couronne de
succs, il dlivrera le contenu sans faire appel ce dernier. Si
l'URL se trouve dans le cache, la valeur journalise sera alors
<code>-</code>, tandis que dans le cas contraire elle sera
<code>1</code>.</p>
<p>En plus de la syntaxe <code>env=</code>, la directive <code class="directive"><a href="./mod/mod_log_config.html#logformat">LogFormat</a></code> supporte les
valeurs de journalisation conditionnelles bases sur le code de la
rponse HTTP :</p>
<pre class="prettyprint lang-config">LogFormat "%400,501{User-agent}i" browserlog
LogFormat "%!200,304,302{Referer}i" refererlog</pre>
<p>Dans le premier exemple, le <code>User-agent</code> sera
enregistr si le code d'tat HTTP est 400 ou 501. Dans le cas
contraire, c'est un caractre "-" qui sera enregistr la place.
Dans le second exemple, le <code>Referer</code> sera enregistr si
le code d'tat HTTP n'est <strong>pas</strong> 200, 204, ou 302
(remarquez le caractre "!" avant les codes d'tat).</p>
<p>Bien que nous venions de montrer que la journalisation conditionnelle
est souple et trs puissante, cette mthode de contrle du contenu des
journaux n'est pas la seule. Les fichiers journaux sont plus utiles
quand ils contiennent un enregistrement complet de l'activit du serveur,
et il est souvent plus ais de simplement traiter posteriori les fichiers
journaux pour supprimer les requtes que vous ne voulez pas y voir
apparatre.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="rotation" id="rotation">Rotation des journaux</a></h2>
<p>Mme dans le cas d'un serveur modrment sollicit, la quantit
d'informations stockes dans les fichiers journaux est trs importante.
Le fichier journal des accs grossit en gnral d'1 Mo ou plus toutes
les 10000 requtes. Il est par consquent ncessaire d'effectuer
priodiquement la rotation des journaux en dplaant ou supprimant les
fichiers correspondants. On ne peut pas le faire pendant que le serveur
est en cours d'excution, car Apache httpd va continuer crire dans l'ancien
fichier journal aussi longtemps qu'il le maintiendra ouvert.
C'est pourquoi le serveur doit tre
<a href="stopping.html">redmarr</a> aprs le dplacement ou la
suppression des fichiers journaux de faon ce qu'il en ouvre
de nouveaux.</p>
<p>Avec un redmarrage <em>graceful</em>, on peut faire en sorte que le
serveur ouvre de nouveaux fichiers journaux sans perdre de connexions
existantes ou en cours avec les clients. Cependant, pour que ceci soit
possible, le serveur doit continuer crire dans les anciens fichiers
journaux pendant qu'il termine le traitement des requtes en cours.
Il est donc ncessaire d'attendre un certain temps aprs le rdmarrage
avant d'effectuer tout traitement sur les fichiers journaux. Voici un
scnario typique dans lequel on effectue une simple rotation des
journaux en compressant les anciens fichiers correspondants afin
de gagner de l'espace disque :</p>
<div class="example"><p><code>
mv access_log access_log.old<br />
mv error_log error_log.old<br />
apachectl graceful<br />
sleep 600<br />
gzip access_log.old error_log.old
</code></p></div>
<p>La section suivante prsente une autre mthode de rotation des journaux
qui consiste utiliser les
<a href="#piped">journaux redirigs</a>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="piped" id="piped">Journaux redirigs</a></h2>
<p>Nous avons vu que le dmon httpd crivait les informations de
journalisation des erreurs et des accs dans un fichier journal ;
il peut aussi
rediriger ces informations vers un autre processus par l'intermdiaire d'un
tube de communication (pipe). Cette fonctionnalit amliore
considrablement la souplesse de la journalisation, sans ajouter de code
au serveur principal. Pour rediriger les informations de journalisation
vers un tube de communication, remplacez simplement le nom de fichier
journal par
le caractre pipe "<code>|</code>", suivi du nom de l'excutable qui va
recueillir les entres de journal sur son entre
standard. Le serveur va
lancer le processus de redirection des journaux au moment du dmarrage du
serveur, et le relancera s'il cesse de fonctionner
pendant l'excution du serveur.
(Nous dnommons cette technique "journalisation
redirige fiable" grce cette dernire fonctionnalit.)</p>
<p>Les processus de journalisation redirige sont lancs par le processus
httpd parent, et hritent de l'UID de ce dernier. Cela signifie que les
programmes de journalisation dirige s'excutent gnralement en tant que
root. Il est donc trs important que ces programmes soient simples et
scuriss.</p>
<p>Un des grands avantages de la journalisation redirige est la possibilit
d'effectuer la rotation des journaux sans avoir redmarrer le serveur. Pour
accomplir cette tche, le serveur HTTP Apache fournit un programme simple
appel <code class="program"><a href="./programs/rotatelogs.html">rotatelogs</a></code>. Par exemple, pour une rotation des
journaux toutes les 24 heures, ajoutez ces lignes :</p>
<pre class="prettyprint lang-config">CustomLog "|/usr/local/apache/bin/rotatelogs /var/log/access_log 86400" common</pre>
<p>Notez que l'ensemble de la commande qui sera appele par le tube de
communication a t place entre guillemets. Bien que cet exemple
concerne le journal des accs, la mme technique peut tre utilise
pour le journal des erreurs.</p>
<p>Il existe un autre programme de rotation des journaux similaire mais
beaucoup plus souple : il s'agit de "cronolog", non fourni par Apache,
mais disponible <a href="http://www.cronolog.org/">ici</a>.</p>
<p>Comme la journalisation conditionnelle, la journalisation redirige est
un outil trs puissant, mais si elle existe, il est prfrable d'utiliser
une solution plus simple comme le traitement posteriori hors ligne.</p>
<p>Par dfaut, le processus de redirection du journal est lanc sans
invoquer un shell. Pour invoquer un shell, utilisez "<code>|$</code>"
au lieu de "<code>|</code>" (en gnral avec <code>/bin/sh -c</code>)
:</p>
<pre class="prettyprint lang-config"># Invocation de "rotatelogs" en utilisant un shell
CustomLog "|$/usr/local/apache/bin/rotatelogs /var/log/access_log 86400" common</pre>
<p>Il s'agissait du comportement par dfaut sous Apache 2.2. Selon
les spcificits du shell, ceci peut gnrer un processus shell
supplmentaire pour toute la dure du programme de redirection du
journal, et induire des problmes de gestion de signaux au cours du
redmarrage. La notation "<code>||</code>" est aussi supporte pour
des raisons de compatibilit avec Apache 2.2 et est quivalente
"<code>|</code>".</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="virtualhost" id="virtualhost">Htes virtuels</a></h2>
<p>Lorsqu'un serveur possde plusieurs <a href="vhosts/">htes virtuels</a>, il existe de nombreuses solutions pour grer
les fichiers journaux. Par exemple, on peut utiliser les journaux comme
s'il s'agissait d'un serveur avec un seul hte. Il suffit pour cela de
placer les directives de journalisation en dehors des sections
<code class="directive"><a href="./mod/core.html#virtualhost"><VirtualHost></a></code> au niveau
du serveur principal, ce qui a pour effet de journaliser toutes les
requtes dans le mme journal des accs et des erreurs. Cette technique
est cependant inapproprie pour recueillir des statistiques sur chaque
hte virtuel individuellement.</p>
<p>Si des directives <code class="directive"><a href="./mod/mod_log_config.html#customlog">CustomLog</a></code> ou
<code class="directive"><a href="./mod/core.html#errorlog">ErrorLog</a></code> sont places dans une section
<code class="directive"><a href="./mod/core.html#virtualhost"><VirtualHost></a></code>, toutes les
requtes ou erreurs pour cet hte virtuel ne seront enregistres que dans
le fichier spcifi. Tout hte virtuel qui ne possde pas de directives de
journalisation verra ses requtes enregistres dans le journal du serveur
principal. Cette technique est approprie pour un petit nombre d'htes
virtuels, mais si ce nombre est important, elle peut devenir complique
grer. En outre, des problmes de <a href="vhosts/fd-limits.html">nombre de descripteurs
de fichiers insuffisant</a> peuvent rapidement apparatre.</p>
<p>Il existe un trs bon compromis pour le journal des accs. En intgrant
les informations propos de l'hte virtuel la chane de format du
journal, il est possible de journaliser tous les htes dans le mme
journal, puis de sparer ultrieurement le journal en plusieurs journaux
individuels. Considrons par exemple les directives suivantes :</p>
<pre class="prettyprint lang-config">LogFormat "%v %l %u %t \"%r\" %>s %b" comonvhost
CustomLog logs/access_log comonvhost</pre>
<p>Le champ <code>%v</code> sert enregistrer le nom de l'hte virtuel qui
traite la requte. Un programme tel que <a href="programs/split-logfile.html">split-logfile</a> peut ensuite tre utilis
pour gnrer " froid" autant de journaux que d'htes virtuels.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
<div class="section">
<h2><a name="other" id="other">Autres fichiers journaux</a></h2>
<table class="related"><tr><th>Modules Apparents</th><th>Directives Apparentes</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_logio.html">mod_logio</a></code></li><li><code class="module"><a href="./mod/mod_log_config.html">mod_log_config</a></code></li><li><code class="module"><a href="./mod/mod_log_forensic.html">mod_log_forensic</a></code></li><li><code class="module"><a href="./mod/mod_cgi.html">mod_cgi</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/mod_log_config.html#logformat">LogFormat</a></code></li><li><code class="directive"><a href="./mod/mod_log_config.html#bufferedlogs">BufferedLogs</a></code></li><li><code class="directive"><a href="./mod/mod_log_forensic.html#forensiclog">ForensicLog</a></code></li><li><code class="directive"><a href="./mod/mpm_common.html#pidfile">PidFile</a></code></li><li><code class="directive"><a href="./mod/mod_cgi.html#scriptlog">ScriptLog</a></code></li><li><code class="directive"><a href="./mod/mod_cgi.html#scriptlogbuffer">ScriptLogBuffer</a></code></li><li><code class="directive"><a href="./mod/mod_cgi.html#scriptloglength">ScriptLogLength</a></code></li></ul></td></tr></table>
<h3>Enregistrement du nombre rel d'octets envoys et reus</h3>
<p>Le module <code class="module"><a href="./mod/mod_logio.html">mod_logio</a></code> fournit deux champs
<code class="directive"><a href="./mod/mod_log_config.html#logformat">LogFormat</a></code> supplmentaires
(%I et %O) qui permettent d'enregistrer le nombre rel d'octets reus et
envoys sur le rseau.</p>
<h3>Journalisation de style investigation judiciaire (forensic logging)</h3>
<p>Le module <code class="module"><a href="./mod/mod_log_forensic.html">mod_log_forensic</a></code> permet la journalisation
des fins d'investigation judiciaire des requtes des clients. La
journalisation est effectue avant et aprs le traitement de la requte,
qui fait donc l'objet de deux entres dans le journal. Le gnrateur de
journaux d'investigation est trs strict et ne permet aucune
personnalisation. C'est un inestimable outil de dbogage et de scurit.</p>
<h3><a name="pidfile" id="pidfile">Fichier PID</a></h3>
<p>Au dmarrage, le dmon httpd Apache enregistre l'identifiant du
processus httpd parent dans le fichier <code>logs/httpd.pid</code>.
Le nom de ce fichier peut tre modifi l'aide de la directive
<code class="directive"><a href="./mod/mpm_common.html#pidfile">PidFile</a></code>. Cet identifiant
permet l'administrateur de redmarrer et arrter le dmon en
envoyant des signaux au processus parent ; sous Windows, vous devez
utiliser l'option de ligne de commande -k. Pour plus de dtails,
consulter la page <a href="stopping.html">Arrt et redmarrage</a>.</p>
<h3><a name="scriptlog" id="scriptlog">Journal des scripts</a></h3>
<p>Afin de faciliter le dbogage, la directive
<code class="directive"><a href="./mod/mod_cgi.html#scriptlog">ScriptLog</a></code> vous permet
d'enregistrer les entres et sorties des scripts CGI. Elle ne doit tre
utilise que pendant la phase de test, et en aucun cas sur un
serveur en production. Vous trouverez plus d'informations dans la
documentation du module <a href="mod/mod_cgi.html">mod_cgi</a>.</p>
</div></div>
<div class="bottomlang">
<p><span>Langues Disponibles: </span><a href="./en/logs.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="./fr/logs.html" title="Franais"> fr </a> |
<a href="./ja/logs.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="./ko/logs.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="./tr/logs.html" hreflang="tr" rel="alternate" title="Trke"> tr </a></p>
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/logs.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2014 The Apache Software Foundation.<br />Autoris sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossaire</a> | <a href="./sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html>
|
