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
|
<?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>rotatelogs - Rotation des journaux d'Apache par redirection de
ces derniers dans un "pipe" - 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> > <a href="./">Programmes</a></div><div id="page-content"><div id="preamble"><h1>rotatelogs - Rotation des journaux d'Apache par redirection de
ces derniers dans un "pipe"</h1>
<div class="toplang">
<p><span>Langues Disponibles: </span><a href="../en/programs/rotatelogs.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/programs/rotatelogs.html" title="Franais"> fr </a> |
<a href="../ko/programs/rotatelogs.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/programs/rotatelogs.html" hreflang="tr" rel="alternate" title="Trke"> tr </a></p>
</div>
<p><code>rotatelogs</code> est un programme simple utiliser en
conjonction avec la fonctionnalit d'Apache de redirection dans un
"pipe" des fichiers journaux. Il supporte une rotation base sur un
intervalle de temps ou une taille maximale du journal.</p>
</div>
<div id="quickview"><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#synopsis">Syntaxe</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#options">Options</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#examples">Exemples</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#portability">Portabilit</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="synopsis" id="synopsis">Syntaxe</a></h2>
<p><code><strong>rotatelogs</strong>
[ -<strong>l</strong> ]
[ -<strong>L</strong> <var>nom-lien</var> ]
[ -<strong>p</strong> <var>programme</var> ]
[ -<strong>f</strong> ]
[ -<strong>v</strong> ]
[ -<strong>e</strong> ]
[ -<strong>c</strong> ]
[ -<strong>n</strong> <var>nombre-de-fichiers</var> ]
<var>fichier-journal</var>
<var>heure-de-rotation</var>|<var>taille-fichier</var>(B|K|M|G)
[ <var>dcalage</var> ]</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="options" id="options">Options</a></h2>
<dl>
<dt><code>-l</code></dt>
<dd>Utilise le temps local plutt que GMT comme base pour l'intervalle
de temps ou pour le formatage de <code>strftime(3)</code> avec une
rotation base sur la taille.</dd>
<dt><code>-L</code> <var>nom-lien</var></dt>
<dd>Etablit un lien physique entre le fichier journal courant et le lien
spcifi. Cette option permet de consulter le journal de manire
continue malgr les rotations via une commande du style <code>tail -F
nom-lien</code>.</dd>
<dt><code>-p</code> <var>programme</var></dt>
<dd>Avec cette option, <code>rotatelogs</code> excutera le programme
<var>programme</var> chaque fois qu'un nouveau fichier journal sera
ouvert. Le nom du fichier nouvellement ouvert est pass comme premier
argument au programme. Si l'excution se produit aprs une rotation,
l'ancien nom du fichier journal est pass au programme comme second
argument. <code>rotatelogs</code>
n'attend pas la fin du <var>programme</var> pour continuer son
excution, et cessera tout enregistrement de codes d'erreur lorsqu'il
aura termin son processus. Le <var>programme</var> utilise les mmes
canaux stdin, stdout, et stderr que rotatelogs, et hrite de son
environnement.</dd>
<dt><code>-f</code></dt>
<dd>Ouvre le fichier journal immdiatement, ds que
<code>rotatelogs</code> dmarre, au lieu d'attendre la lecture de la
premire entre de journal (pour les sites peu chargs, il peut
s'couler un temps substantiel entre le dmarrage du serveur et le
traitement de la premire requte, temps pendant lequel le fichier
journal associ n'"existe" pas, ce qui peut causer des problmes
certains utilitaires de journalisation automatiques).</dd>
<dt><code>-t</code></dt>
<dd>Provoque une troncature du fichier journal au lieu d'une rotation.
Cela peut s'avrer utile lorsqu'un journal est labor en temps rel par
une commande telle que tail, l'archivage des donnes n'tant ici pas
ncessaire. Si aucun suffixe n'est ajout au nom de fichier, les
chanes de format contenant des caractres '%' sont cependant
respectes.
</dd>
<dt><code>-v</code></dt>
<dd>Affiche une sortie verbeuse sur STDERR. La sortie contient le
rsultat de l'interprtation de la configuration, ainsi que toutes les
oprations d'ouverture et de fermeture de fichiers.</dd>
<dt><code>-c</code></dt>
<dd>Cre un fichier journal pour chaque intervalle, mme s'il est vide.</dd>
<dt><code>-e</code></dt>
<dd>Envoie les messages de journalisation vers stdout. Ceci s'avre
utile lorsque les journaux doivent tre traits par un autre programme.</dd>
<dt><code>-n <var>nombre-de-fichiers</var></code></dt>
<dd>Utilise une liste circulaire de fichiers sans repres de temps. Avec
-n 3, la srie de fichiers conservs sera "logfile",
"logfile.1", "logfile.2" avec crasement de "logfile".
Disponible partir de la version 2.4.5 du serveur HTTP Apache.</dd>
<dt><code><var>fichier-journal</var></code></dt>
<dd><p>Le chemin et le nom de base du fichier journal. Si
<var>fichier-journal</var> contient des caractres '%', il est considr
comme une chane de formatage pour <code>strftime(3)</code>. Dans le cas
contraire, le suffixe <var>.nnnnnnnnnn</var> est automatiquement ajout
et correspond au temps en secondes (sauf si l'option -t est spcifie).
Les deux formats calculent le temps
de dmarrage depuis le dbut de la priode courante. Par exemple, si un
temps de rotation de 86400 est spcifi, les champs heure, minute et
seconde crs partir du format <code>strftime(3)</code> auront tous
pour valeur 0, en rfrence au dbut de la priode de 24 heures courante
(minuit).</p>
<p>Si vous utilisez le formatage de noms de fichiers
<code>strftime(3)</code>, assurez-vous que le format du fichier journal
possde une granularit suffisamment importante pour gnrer un nom de
fichier diffrent chaque rotation des journaux. Si ce n'est pas le
cas, la rotation va craser le fichier existant au lieu d'en gnrer un
nouveau. Par exemple, si <var>fichier-journal</var> tait
<code>/var/log/errorlog.%Y-%m-%d</code> avec une rotation 5
mgaoctets, et si la limite de 5 mgaoctets a t atteinte deux fois
dans la mme journe, le mme nom de fichier va tre gnr, et la
rotation va craser le fichier existant.</p>
</dd>
<dt><code><var>temps-rotation</var></code></dt>
<dd>Le temps entre deux rotations des fichiers journaux en secondes. La
rotation intervient au dbut de cet intervalle. Par exemple, si le temps
de rotation est de 3600, la rotation des fichiers journaux s'effectuera
au dbut de chaque heure ; si le temps de rotation est de 86400, la
rotation des fichiers journaux s'effectuera chaque nuit minuit. (Si
aucune donne n'est enregistre au cours d'un intervalle, aucun fichier
ne sera cr).</dd>
<dt><code><var>taille-fichier</var>(B|K|M|G)</code></dt>
<dd>La taille maximale du fichier suivie par une des lettres
<code>B</code> (Octets), <code>K</code> (KOctets), <code>M</code> (MOctets)
ou <code>G</code> (GOctets).
<p>
Lorsque temps et taille sont spcifis, la taille doit l'tre aprs le
temps. La rotation interviendra alors aussitt que l'une des deux limites
(temps ou taille) sera atteinte.
</p>
</dd>
<dt><code><var>dcalage</var></code></dt>
<dd>Le dcalage en minutes par rapport au temps UTC. Par dfaut, le
dcalage est considr comme nul et c'est le temps UTC qui est utilis.
Par exemple, pour utiliser le temps local de la zone UTC -5 heures,
spcifiez une valeur de <code>-300</code> pour cette option. Dans la
plupart des cas, il vaut mieux utiliser l'option <code>-l</code> que
spcifier un dcalage.</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="examples" id="examples">Exemples</a></h2>
<div class="example"><p><code>
CustomLog "|bin/rotatelogs /var/log/fichier-journal 86400" common
</code></p></div>
<p>Cette directive cre les fichiers /var/log/fichier-journal.nnnn
o nnnn correspond au temps systme auquel la journalisation
dmarre effectivement (ce temps sera toujours un multiple du temps
de rotation, si bien que vous pouvez synchroniser les scripts cron
avec lui). A la fin de chaque temps de rotation (ici aprs 24
heures), une nouvelle journalisation dmarre.</p>
<div class="example"><p><code>
CustomLog "|bin/rotatelogs -l /var/log/fichier-journal.%Y.%m.%d 86400" common
</code></p></div>
<p>Cette directive cre les fichiers
/var/log/fichier-journal.yyyy.mm.dd o yyyy correspond l'anne,
mm au mois et dd au jour du mois. La journalisation basculera vers
un nouveau fichier chaque jour minuit, temps local.</p>
<div class="example"><p><code>
CustomLog "|bin/rotatelogs /var/log/fichier-journal 5M" common
</code></p></div>
<p>Cette directive va effectuer une rotation du fichier journal
chaque fois que la taille de ce dernier atteindra 5 MOctets.</p>
<div class="example"><p><code>
ErrorLog "|bin/rotatelogs /var/log/journal-erreurs.%Y-%m-%d-%H_%M_%S 5M"
</code></p></div>
<p>Cette directive va effectuer une rotation du fichier journal des
erreurs chaque fois que la taille de ce dernier atteindra 5
MOctets, et le nom du fichier journal se prsentera sous
la forme <code>journal-erreurs.YYYY-mm-dd-HH_MM_SS</code>.</p>
<div class="example"><p><code>
CustomLog "|bin/rotatelogs -t /var/log/journal 86400" common
</code></p></div>
<p>Cet exemple cre le fichier /var/log/journal en le tronquant
au dmarrage, puis une fois par jour. Ce scnario implique qu'un
processus spar (tel que tail) traite le fichier en temps
rel.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="portability" id="portability">Portabilit</a></h2>
<p>Les substitutions des chanes de format du fichier journal suivantes
doivent tre supportes par toutes les implmentations de
<code>strftime(3)</code> ; voir la page de manuel de
<code>strftime(3)</code> pour les extensions spcifiques une
bibliothque.</p>
<table class="bordered"><tr><td><code>%A</code></td><td>nom du jour de la semaine en entier
(localis)</td></tr>
<tr class="odd"><td><code>%a</code></td><td>nom du jour de la semaine sur 3
caractres (localis)</td></tr>
<tr><td><code>%B</code></td><td>nom du mois en entier (localis)</td></tr>
<tr class="odd"><td><code>%b</code></td><td>nom du mois sur 3 caractres (localis)</td></tr>
<tr><td><code>%c</code></td><td>date et heure (localis)</td></tr>
<tr class="odd"><td><code>%d</code></td><td>jour du mois sur 2 chiffres</td></tr>
<tr><td><code>%H</code></td><td>heure sur 2 chiffres (de 0 24h)</td></tr>
<tr class="odd"><td><code>%I</code></td><td>heure sur 2 chiffres (de 0 12h)</td></tr>
<tr><td><code>%j</code></td><td>jour de l'anne sur 3 chiffres</td></tr>
<tr class="odd"><td><code>%M</code></td><td>minutes sur 2 chiffres</td></tr>
<tr><td><code>%m</code></td><td>mois sur 2 chiffres</td></tr>
<tr class="odd"><td><code>%p</code></td><td>suffixe am/pm pour l'heure de 0 12h
(localis)</td></tr>
<tr><td><code>%S</code></td><td>secondes sur 2 chiffres</td></tr>
<tr class="odd"><td><code>%U</code></td><td>semaine de l'anne sur 2 chiffres
(Dimanche est le premier jour de la semaine)</td></tr>
<tr><td><code>%W</code></td><td> semaine de l'anne sur 2 chiffres
(Lundi est le premier jour de la semaine)</td></tr>
<tr class="odd"><td><code>%w</code></td><td>jour de la semaine sur 1 chiffre
(Dimanche est le premier jour de la semaine)</td></tr>
<tr><td><code>%X</code></td><td>heure (localise)</td></tr>
<tr class="odd"><td><code>%x</code></td><td>date (localise)</td></tr>
<tr><td><code>%Y</code></td><td>anne sur 4 chiffres</td></tr>
<tr class="odd"><td><code>%y</code></td><td>anne sur 2 chiffres</td></tr>
<tr><td><code>%Z</code></td><td>nom de la zone de temps</td></tr>
<tr class="odd"><td><code>%%</code></td><td>caractre littral `%'</td></tr>
</table>
</div></div>
<div class="bottomlang">
<p><span>Langues Disponibles: </span><a href="../en/programs/rotatelogs.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/programs/rotatelogs.html" title="Franais"> fr </a> |
<a href="../ko/programs/rotatelogs.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/programs/rotatelogs.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/programs/rotatelogs.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>
|
