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
|
<?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>mod_log_config - 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>
<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> > <a href="./">Modules</a></div>
<div id="page-content">
<div id="preamble"><h1>Module Apache mod_log_config</h1>
<div class="toplang">
<p><span>Langues Disponibles: </span><a href="../en/mod/mod_log_config.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/mod/mod_log_config.html" title="Franais"> fr </a> |
<a href="../ja/mod/mod_log_config.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="../ko/mod/mod_log_config.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/mod/mod_log_config.html" hreflang="tr" rel="alternate" title="Trke"> tr </a></p>
</div>
<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Journalisation des requtes envoyes au
serveur</td></tr>
<tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="module-dict.html#ModuleIdentifier">IdentificateurdeModule:</a></th><td>log_config_module</td></tr>
<tr><th><a href="module-dict.html#SourceFile">FichierSource:</a></th><td>mod_log_config.c</td></tr></table>
<h3>Sommaire</h3>
<p>Ce module apporte une grande souplesse dans la journalisation des
requtes des clients. Les journaux sont crits sous un format
personnalisable, et peuvent tre enregistrs directement dans un
fichier, ou redirigs vers un programme externe. La journalisation
conditionnelle est supporte, si bien que des requtes individuelles
peuvent tre incluses ou exclues des journaux en fonction de leur
caractristiques.</p>
<p>Ce module fournit trois directives : <code class="directive"><a href="#transferlog">TransferLog</a></code> cre un fichier
journal, <code class="directive"><a href="#logformat">LogFormat</a></code>
dfinit un format personnalis, et <code class="directive"><a href="#customlog">CustomLog</a></code> dfinit un fichier journal et un format en
une seule tape. Pour journaliser les requtes dans plusieurs
fichiers, vous pouvez utiliser plusieurs fois les directives
<code class="directive">TransferLog</code> et
<code class="directive">CustomLog</code> dans chaque serveur.</p>
</div>
<div id="quickview"><h3 class="directives">Directives</h3>
<ul id="toc">
<li><img alt="" src="../images/down.gif" /> <a href="#bufferedlogs">BufferedLogs</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#customlog">CustomLog</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#logformat">LogFormat</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#transferlog">TransferLog</a></li>
</ul>
<h3>Sujets</h3>
<ul id="topics">
<li><img alt="" src="../images/down.gif" /> <a href="#formats">Formats de journaux personnaliss</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#security">Considrations concernant la
scurit</a></li>
</ul><h3>Voir aussi</h3>
<ul class="seealso">
<li><a href="../logs.html">Les fichiers journaux
d'Apache</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="formats" id="formats">Formats de journaux personnaliss</a></h2>
<p>L'argument format des directives <code class="directive"><a href="#logformat">LogFormat</a></code> et <code class="directive"><a href="#customlog">CustomLog</a></code> est une chane de
caractres. Cette chane dfinit le format de la journalisation des
requtes dans le fichier journal. Elle peut contenir des caractres
littraux qui seront reproduits dans le fichier journal, et les
caractres de contrle de style C "\n" et "\t" reprsentant
respectivement une nouvelle ligne et une tabulation. Les guillemets
et les anti-slashes littraux doivent tre chapps l'aide
d'anti-slashes.</p>
<p>Les caractristiques de la requte en elle-mme sont journalises
en insrant des directives "<code>%</code>" dans la chane de
format, celles-ci tant remplaces dans le fichier journal par
certaines valeurs comme suit :</p>
<table class="bordered"><tr class="header"><th>Chane de format</th>
<th>Description</th></tr>
<tr><td><code>%%</code></td>
<td>Le signe "pourcentage"</td></tr>
<tr class="odd"><td><code>%a</code></td>
<td>L'adresse IP distante (voir le module
<code class="module"><a href="../mod/mod_remoteip.html">mod_remoteip</a></code>).</td></tr>
<tr><td><code>%{c}a</code></td>
<td>Adresse IP distante de la connexion(voir le module
<code class="module"><a href="../mod/mod_remoteip.html">mod_remoteip</a></code>)</td></tr>
<tr class="odd"><td><code>%A</code></td>
<td>L'adresse IP locale</td></tr>
<tr><td><code>%B</code></td>
<td>La taille de la rponse en octets, en excluant les en-ttes
HTTP.</td></tr>
<tr class="odd"><td><code>%b</code></td>
<td>La taille de la rponse en octets, en excluant les en-ttes
HTTP. Au format CLF , c'est dire un '<code>-</code>' la
place d'un 0 lorsqu'aucun octet n'est renvoy.</td></tr>
<tr><td><code>%{<var>NOMVAR</var>}C</code></td>
<td>Le contenu du cookie <var>NOMVAR</var> dans la requte
envoye au serveur. Seuls les cookies version 0 sont pleinement
supports.</td></tr>
<tr class="odd"><td><code>%D</code></td>
<td>Le temps mis servir la requte, en
microsecondes.</td></tr>
<tr><td><code>%{<var>NOMVAR</var>}e</code></td>
<td>Le contenu de la variable d'environnement
<var>NOMVAR</var></td></tr>
<tr class="odd"><td><code>%f</code></td>
<td>Nom de fichier</td></tr>
<tr><td><code>%h</code></td>
<td>Serveur distant. Contiendra l'adresse IP si la directive
<code class="directive"><a href="../mod/core.html#hostnamelookups">HostnameLookups</a></code> est dfinie
<code>Off</code>, ce qui est sa valeur par dfaut. Si cette
adresse IP n'est enregistre que pour certains serveurs, vous
avez probablement dfini des directives de contrle d'accs qui
mentionnent ces derniers par leurs noms. Voir la <a href="mod_authz_host.html#reqhost">documentation de Require
host</a>.</td></tr>
<tr class="odd"><td><code>%H</code></td>
<td>Le protocole de la requte</td></tr>
<tr><td><code>%{<var>NOMVAR</var>}i</code></td>
<td>Le contenu des lignes d'en-tte
<code><var>NOMVAR</var>:</code> dans la requte envoye au
serveur. Ces en-ttes sont ajouts par d'autres modules (par
exemple <code class="module"><a href="../mod/mod_headers.html">mod_headers</a></code>). Si vous tes intress
par ce qu'tait l'en-tte de la requte avant d'tre modifi
par la plupart des modules, utilisez
<code class="module"><a href="../mod/mod_setenvif.html">mod_setenvif</a></code> pour copier l'en-tte dans une
variable d'environnement interne et journaliser sa valeur via
le champ <code>%{<var>VARNAME</var>}e</code> dcrit plus haut.
</td></tr>
<tr class="odd"><td><code>%k</code></td>
<td>Nombre de requtes persistantes en cours pour cette
connexion. Interessant si la directive <code class="directive"><a href="../mod/core.html#keepalive">KeepAlive</a></code> est utilise ; par exemple,
'1' signifie la premire requte aprs la requte initiale, '2'
la seconde, etc... ; autrement, il s'agit toujours de 0
(indiquant la requte initiale).</td></tr>
<tr><td><code>%l</code></td>
<td>Le nom de connexion distant (en provenance d'identd, si
disponible). Affiche un tiret, sauf si
<code class="module"><a href="../mod/mod_ident.html">mod_ident</a></code> est prsent et si <code class="directive"><a href="../mod/mod_ident.html#identitycheck">IdentityCheck</a></code> est
<code>On</code>.</td></tr>
<tr class="odd"><td><code>%L</code></td>
<td>L'identifiant du message de journalisation de la requte
dans le journal des erreurs (ou '-' si aucun message n'a
t enregistr dans le journal des erreurs pour cette requte)</td></tr>
<tr><td><code>%m</code></td>
<td>La mthode de la requte</td></tr>
<tr class="odd"><td><code>%{<var>NOMVAR</var>}n</code></td>
<td>Le contenu de la note <var>NOMVAR</var> en provenance d'un
autre module.</td></tr>
<tr><td><code>%{<var>NOMVAR</var>}o</code></td>
<td>Le contenu de la ligne d'en-tte
<code><var>NOMVAR</var>:</code> de la rponse.</td></tr>
<tr class="odd"><td><code>%p</code></td>
<td>Le port canonique du serveur servant la requte</td></tr>
<tr><td><code>%{<var>format</var>}p</code></td>
<td>Le port canonique du serveur servant la requte ou le
vritable port du serveur ou le vritable port du client. les
formats valides sont <code>canonical</code>, <code>local</code>,
ou <code>remote</code>.
</td></tr>
<tr class="odd"><td><code>%P</code></td>
<td>Le numro de processus du processus enfant qui a servi la
requte.</td></tr>
<tr><td><code>%{<var>format</var>}P</code></td>
<td>Le numro de processus ou le numro de thread du processus
enfant qui a servi la requte. Les formats valides sont
<code>pid</code>, <code>tid</code>, et <code>hextid</code>.
<code>hextid</code> ncessite APR version 1.2.0 ou suprieure.
</td></tr>
<tr class="odd"><td><code>%q</code></td>
<td>La chane d'arguments (prfixe par un <code>?</code> si une
chane d'arguments existe, sinon une chane vide)</td></tr>
<tr><td><code>%r</code></td>
<td>La premire ligne de la requte</td></tr>
<tr class="odd"><td><code>%R</code></td>
<td>Le gestionnaire qui gnre la rponse (s'il y en a un).</td></tr>
<tr><td><code>%s</code></td>
<td>Statut. Pour les requtes rediriges en interne, il s'agit
du statut de la requte *originale* --- <code>%>s</code> pour
la dernire.</td></tr>
<tr class="odd"><td><code>%t</code></td>
<td>Date laquelle la requte a t reue (au format anglais
standard)</td></tr>
<tr><td><code>%{<var>format</var>}t</code></td>
<td>La date, sous la forme spcifie par format, qui devrait
tre au format tendu <code>strftime(3)</code> (ventuellement
localis). Si le format commence par <code>begin:</code> (valeur
par dfaut), la date est extraite au dbut du traitement de la
requte ; s'il commence par <code>end:</code>, la date
correspond au moment o l'entre du journal est inscrite, par
consquent vers la fin du traitement de la requte. Hormis les
formats supports par <code>strftime(3)</code>, les formats
suivants sont aussi disponibles :
<table>
<tr><td><code>sec</code></td><td>nombre de secondes depuis Epoch</td></tr>
<tr><td><code>msec</code></td><td>nombre de millisecondes depuis Epoch</td></tr>
<tr><td><code>usec</code></td><td>nombre de microsecondes depuis Epoch</td></tr>
<tr><td><code>msec_frac</code></td><td>fraction de milliseconde</td></tr>
<tr><td><code>usec_frac</code></td><td>fraction de microseconde</td></tr>
</table>
Ces symboles ne peuvent pas tre combins entre eux ou avec un
formatage <code>strftime(3)</code> dans la mme chane de
format. Par contre, vous pouvez utiliser plusieurs symboles
<code>%{<var>format</var>}t</code>.</td></tr>
<tr class="odd"><td><code>%T</code></td>
<td>Le temps mis pour servir la requte, en secondes.</td></tr>
<tr><td><code>%u</code></td>
<td>L'utilisateur distant (en provenance d'auth ; peut tre faux
si le statut de retour (<code>%s</code>) est 401).</td></tr>
<tr class="odd"><td><code>%U</code></td>
<td>Le chemin de la requte, l'exclusion de toute chane
d'arguments.</td></tr>
<tr><td><code>%v</code></td>
<td>Le nom canonique du serveur qui a servi la requte, dfini
par la directive <code class="directive"><a href="../mod/core.html#servername">ServerName</a></code>.</td></tr>
<tr class="odd"><td><code>%V</code></td>
<td>La nom du serveur en tenant compte de la dfinition de la
directive <code class="directive"><a href="../mod/core.html#usecanonicalname">UseCanonicalName</a></code>.</td></tr>
<tr><td><code>%X</code></td>
<td>Statut de la connexion lorsque la rponse a t renvoye
:
<table>
<tr><td><code>X</code> =</td>
<td>connexion abandonne avant l'envoi de la rponse.</td></tr>
<tr><td><code>+</code> =</td>
<td>la connexion peut rester ouverte aprs l'envoi de la
rponse.</td></tr>
<tr><td><code>-</code> = </td>
<td>la connexion sera ferme aprs l'envoi de la
rponse.</td></tr>
</table>
</td></tr>
<tr class="odd"><td><code>%I</code></td>
<td>Le nombre d'octets reus, en comptant la requte et les
en-ttes, ne peut tre nul. Ncessite l'activation de
<code class="module"><a href="../mod/mod_logio.html">mod_logio</a></code>.</td></tr>
<tr><td><code>%O</code></td>
<td>Nombre d'octets envoys, y compris les en-ttes, ne peut
tre nul. Ncessite l'activation de
<code class="module"><a href="../mod/mod_logio.html">mod_logio</a></code>.</td></tr>
<tr class="odd"><td><code>%S</code></td>
<td>Nombre d'octets transmis (en mission et rception), y
compris corps et en-ttes de requte. Ce nombre ne peut pas tre
nul, et il correspond la combinaison des formats %I et %O.
<code class="module"><a href="../mod/mod_logio.html">mod_logio</a></code> doit tre charg pour pouvoir
utiliser ce format.</td></tr>
<tr><td><code>%{<var>VARNAME</var>}^ti</code></td>
<td>Le contenu de <code><var>VARNAME</var>:</code> dans les
paramtres de la requte envoye au serveur.</td></tr>
<tr class="odd"><td><code>%{<var>VARNAME</var>}^to</code></td>
<td>Le contenu de <code><var>VARNAME</var>:</code> dans les
paramtres de la rponse envoye par le serveur.</td></tr>
</table>
<h3><a name="modifiers" id="modifiers">Modificateurs</a></h3>
<p>Il est possible de restreindre l'enregistrement de certains
lments
en fonction du code de statut de la rponse, en insrant une liste
de codes de statut spars par des virgules immdiatement aprs le
caractre "%". Par exemple, <code>"%400,501{User-agent}i"</code>
n'enregistrera l'en-tte <code>User-agent</code> que dans le cas
d'une erreur 400 ou 501. Avec les autres codes de statut, c'est la
chane littrale <code>"-"</code> qui sera enregistre. La liste
de codes peut tre prcde d'un "<code>!</code>" pour inverser la
condition : <code>"%!200,304,302{Referer}i"</code> enregistre
l'en-tte <code>Referer</code> pour toutes les requtes qui
<em>ne</em> renvoient <em>pas</em> un des trois codes spcifis.</p>
<p>Les modificateurs "<" et ">" peuvent tre utiliss pour
les requtes qui ont t rediriges en interne afin de choisir si
c'est respectivement la requte originale ou finale qui doit tre
consulte. Par dfaut, les directives <code>%s, %U, %T, %D,</code>
et <code>%r</code> consultent la requte originale, alors que
toutes les autres consultent la requte finale. Ainsi, par
exemple, on peut utiliser <code>%>s</code> pour enregistrer le
statut final de la requte, et <code>%<u</code> pour
enregistrer l'utilisateur authentifi l'origine pour une requte
redirige en interne vers une ressource sans authentification.</p>
<h3><a name="format-notes" id="format-notes">Quelques Notes</a></h3>
<p>Pour des raisons de scurit, partir de la version 2.0.46,
les caractres non imprimables et autres caractres spciaux dans
les directives <code>%r</code>, <code>%i</code> et <code>%o</code>
doivent tre chapps l'aide des squences
<code>\x<var>hh</var></code>,
o <var>hh</var> est le code hexadcimal du caractre spcial.
Comme exceptions cette rgle, les caractres <code>"</code> et
<code>\</code> doivent tre chapps par un anti-slash, et tous
les "blancs" doivent tre crits selon leur notation de style C
(<code>\n</code>, <code>\t</code>, etc...). Avant la version
2.0.46, aucun chappement n'tait effectu sur ces chanes, et il
fallait tre trs prudent lors de l'exploitation des journaux
bruts.</p>
<p>A la diffrence de la version 1.3, depuis httpd 2.0, les chanes
de format <code>%b</code> et <code>%B</code> ne reprsentent pas
le nombre d'octets envoys au client, mais simplement la taille en
octets de la rponse HTTP (les deux tant diffrents, par exemple,
si la connexion est abandonne, ou si SSL est utilis). Le format
<code>%O</code> fourni par <code class="module"><a href="../mod/mod_logio.html">mod_logio</a></code>,
enregistrera le nombre rel d'octets envoys sur le rseau.</p>
<p>Note : <code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code> est implment en tant que
gestionnaire basique et non en tant que gestionnaire standard.
C'est pourquoi la chane de format <code>%R</code> ne renverra pas
d'information propos du gestionnaire lorsqu'une mise en cache de
contenu entre en jeu.</p>
<h3><a name="examples" id="examples">Exemples</a></h3>
<p>Quelques chanes de format couramment utilises :</p>
<dl>
<dt>Format de journal courant (CLF)</dt>
<dd><code>"%h %l %u %t \"%r\" %>s %b"</code></dd>
<dt>Format de journal courant avec un serveur virtuel</dt>
<dd><code>"%v %h %l %u %t \"%r\" %>s %b"</code></dd>
<dt>Format de journal NCSA tandu/combin</dt>
<dd><code>"%h %l %u %t \"%r\" %>s %b \"%{Referer}i\"
\"%{User-agent}i\""</code></dd>
<dt>Format de journal de la page qui contient le lien vers la
page concerne (Referer)</dt>
<dd><code>"%{Referer}i -> %U"</code></dd>
<dt>Format de journal de l'agent (Navigateur)</dt>
<dd><code>"%{User-agent}i"</code></dd>
</dl>
<p>Vous pouvez utiliser plusieurs fois la directive
<code>%{format}t</code> pour construire un format de temps
utilisant les symboles de format tendus tels que
<code>msec_frac</code> :</p>
<dl>
<dt>Format de temps prenant en compte les milisecondes</dt>
<dd><code>"%{%d/%b/%Y %T}t.%{msec_frac}t %{%z}t"</code></dd>
</dl>
</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">Considrations concernant la
scurit</a></h2>
<p>Voir le document <a href="../misc/security_tips.html#serverroot">conseils matire de
scurit</a> pour plus de dtails sur les raisons pour lesquelles
votre scurit pourrait tre compromise, si le rpertoire o sont
stocks les fichiers journaux sont inscriptibles par tout autre
utilisateur que celui qui dmarre le serveur.</p>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="BufferedLogs" id="BufferedLogs">BufferedLogs</a> <a name="bufferedlogs" id="bufferedlogs">Directive</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enregistre les entres du journal dans un tampon en mmoire
avant de les crire sur disque</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>BufferedLogs On|Off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Dfaut:</a></th><td><code>BufferedLogs Off</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_log_config</td></tr>
</table>
<p>Lorsque la directive <code class="directive">BufferedLogs</code> est
"on", <code class="module"><a href="../mod/mod_log_config.html">mod_log_config</a></code> stocke de nombreuses entres
du journal en mmoire, et les crit d'un seul bloc sur disque,
plutt que de les crire aprs chaque requte. Sur certains
systmes, ceci peut amliorer l'efficacit des accs disque, et par
consquent les performances. La directive ne peut tre dfinie
qu'une seule fois pour l'ensemble du serveur ; elle ne peut pas tre
dfinie au niveau d'un serveur virtuel.</p>
<div class="note">Cette directive doit tre utilise avec
prcautions car un crash peut provoquer la perte de donnes de
journalisation.</div>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="CustomLog" id="CustomLog">CustomLog</a> <a name="customlog" id="customlog">Directive</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Dfinit le nom et le format du fichier
journal</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CustomLog <var>fichier</var>|<var>pipe</var>
<var>format</var>|<var>alias</var>
[env=[!]<var>variable-environnement</var>|
expr=<var>expression</var>]</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_log_config</td></tr>
</table>
<p>La directive <code class="directive">CustomLog</code> permet de contrler
la journalisation des requtes destines au serveur. Un format de
journal est spcifi, et la journalisation peut s'effectuer de
manire conditionnelle en fonction des caractristiques de la
requte en utilisant des variables d'environnement.</p>
<p>Le premier argument, qui spcifie l'emplacement o les journaux
seront crits, accepte deux types de valeurs :</p>
<dl>
<dt><var>fichier</var></dt>
<dd>Un nom de fichier, relatif au rpertoire dfini par la
directive <code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code>.</dd>
<dt><var>pipe</var></dt>
<dd>Le caractre pipe "<code>|</code>", suivi du chemin vers un
programme qui recevra les informations de la journalisation sur
son entre standard. Voir les notes propos de la <a href="../logs.html#piped">journalisation redirige</a> pour plus
d'informations.
<div class="warning"><h3>Scurit :</h3>
<p>Si les journaux sont redirigs vers un programme, ce dernier
s'excutera sous l'utilisateur qui a dmarr
<code class="program"><a href="../programs/httpd.html">httpd</a></code>. Ce sera l'utilisateur root si le serveur
a t dmarr par root ; vrifiez que le programme est
scuris.</p>
</div>
<div class="warning"><h3>Note</h3>
<p>Lors de la spcification d'un chemin de fichier sur les
plate-formes non-Unix, il faut prendre soin de ne pas oublier
que seuls les slashes directs doivent tre utiliss, mme si la
plate-forme autorise l'emploi d'anti-slashes. D'une manire
gnrale, c'est une bonne ide que de n'utiliser que des slashes
directs dans les fichiers de configuration.</p>
</div></dd>
</dl>
<p>Le second argument permet de dfinir ce qui va tre crit dans le
fichier journal. Il peut contenir soit un <var>alias</var> prdfini
par une directive <code class="directive"><a href="#logformat">LogFormat</a></code>, soit une chane de
<var>format</var> explicite comme dcrit dans la section <a href="#formats">formats de journaux</a>.</p>
<p>Par exemple, les deux blocs de directives suivants produisent le
mme effet :</p>
<pre class="prettyprint lang-config"># Journal personnalis avec alias de format
LogFormat "%h %l %u %t \"%r\" %>s %b" common
CustomLog logs/access_log common
# Journal personnalis avec chane de format explicite
CustomLog logs/access_log "%h %l %u %t \"%r\" %>s %b"</pre>
<p>Le troisime argument est optionnel et permet de contrler si une
requte doit tre ou non journalise. Dans le cas d'une clause
'<code>env=!<var>nom</var></code>', la condition peut tre la
prsence ou l'absence d'une variable particulire dans
l'<a href="../env.html">environnement du serveur</a>. Dans le cas
d'une clause 'expr=<var>expression</var>', la condition consiste
en une <a href="../expr.html">expression</a> boolenne
quelconque. Si la condition n'est pas vrifie, la requte ne sera
pas journalise. D'ventuelles rfrences des en-ttes HTTP dans
l'expression rationnelle n'entraneront pas l'ajout des noms
d'en-tte correspondants l'en-tte Vary.</p>
<p>Les variables d'environnement peuvent tre dfinies au niveau de
chaque requte en utilisant les modules
<code class="module"><a href="../mod/mod_setenvif.html">mod_setenvif</a></code> et/ou <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>.
Par exemple, si vous voulez enregistrer les requtes pour toutes les
images GIF sur votre serveur dans un fichier journal spar, et pas
dans votre journal principal, vous pouvez utiliser :</p>
<pre class="prettyprint lang-config">SetEnvIf Request_URI \.gif$ gif-image
CustomLog gif-requests.log common env=gif-image
CustomLog nongif-requests.log common env=!gif-image</pre>
<p>Ou, pour reproduire le comportement de l'ancienne directive
RefererIgnore, vous pouvez utiliser :</p>
<pre class="prettyprint lang-config">SetEnvIf Referer example\.com localreferer
CustomLog referer.log referer env=!localreferer</pre>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="LogFormat" id="LogFormat">LogFormat</a> <a name="logformat" id="logformat">Directive</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Dcrit un format utilisable dans un fichier
journal</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LogFormat <var>format</var>|<var>alias</var>
[<var>alias</var>]</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Dfaut:</a></th><td><code>LogFormat "%h %l %u %t \"%r\" %>s %b"</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_log_config</td></tr>
</table>
<p>Cette directive permet de spcifier le format du fichier journal
des accs.</p>
<p>La directive <code class="directive">LogFormat</code> se prsente sous
deux formes. Sous la premire forme, qui ne possde qu'un seul
argument, la directive dfinit le format qui sera utilis dans les
journaux spcifis par les directives
<code class="directive">TransferLog</code> ultrieures. L'argument unique
peut contenir un <var>format</var> explicite comme dcrit dans la
section <a href="#formats">formats de journaux personnaliss</a>
ci-dessus. Il peut aussi contenir un <var>alias</var> faisant
rfrence un format de journal prdfini par une directive
<code class="directive">LogFormat</code> comme dcrit plus loin.</p>
<p>Sous sa seconde forme, la directive
<code class="directive">LogFormat</code> associe un <var>format</var>
explicite un <var>alias</var>. Cet <var>alias</var> peut
ensuite s'utiliser dans les directives
<code class="directive">LogFormat</code> ou <code class="directive"><a href="#customlog">CustomLog</a></code> ultrieures, ce qui
vite d'avoir rpter l'ensemble de la chane de format. Une
directive <code class="directive">LogFormat</code> qui dfinit un alias
<strong>ne fait rien d'autre</strong> -- c'est dire qu'<em>elle ne
fait que</em> dfinir l'alias, elle n'applique pas le format et n'en
fait pas le format par dfaut. Par consquent, elle n'affecte pas
les directives <code class="directive"><a href="#transferlog">TransferLog</a></code> ultrieures. En
outre, la directive <code class="directive">LogFormat</code> ne peut pas
utiliser un alias pour en dfinir un autre. Notez que l'alias ne
doit pas contenir de caractre pourcent (<code>%</code>).</p>
<div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config">LogFormat "%v %h %l %u %t \"%r\" %>s %b" serveur_virtuel_commun</pre>
</div>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="TransferLog" id="TransferLog">TransferLog</a> <a name="transferlog" id="transferlog">Directive</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Spcifie l'emplacement d'un fichier journal</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>TransferLog <var>fichier</var>|<var>pipe</var></code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_log_config</td></tr>
</table>
<p>Cette directive possde exactement les mmes arguments et produit
les mmes effets que la directive <code class="directive"><a href="#customlog">CustomLog</a></code>, l'exception qu'elle
ne permet pas de spcifier un format de journal explicite ou la
journalisation conditionnelle des requtes. En l'occurrence, le
format de journal est dtermin par la dernire dfinition d'une
directive <code class="directive"><a href="#logformat">LogFormat</a></code>
qui ne dfinit pas d'alias. Si aucun format particulier n'a t
spcifi, c'est le Common Log Format qui sera utilis.</p>
<div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config">LogFormat "%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-agent}i\""
TransferLog logs/access_log</pre>
</div>
</div>
</div>
<div class="bottomlang">
<p><span>Langues Disponibles: </span><a href="../en/mod/mod_log_config.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/mod/mod_log_config.html" title="Franais"> fr </a> |
<a href="../ja/mod/mod_log_config.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="../ko/mod/mod_log_config.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/mod/mod_log_config.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/mod/mod_log_config.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>
|
