granicus.if.org Git - apache/blob - docs/manual/programs/rotatelogs.html.fr.utf8

   1 <?xml version="1.0" encoding="UTF-8"?>
   2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
   3 <html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head>
   4 <meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
   5 <!--
   6         XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
   7               This file is generated from xml source: DO NOT EDIT
   8         XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
   9       -->
  10 <title>rotatelogs - Rotation des journaux d'Apache par redirection de
  11   ces derniers dans un "pipe" - Serveur HTTP Apache Version 2.5</title>
  12 <link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
  13 <link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
  14 <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" />
  15 <script src="../style/scripts/prettify.min.js" type="text/javascript">
  16 </script>
  17
  18 <link href="../images/favicon.ico" rel="shortcut icon" /></head>
  19 <body id="manual-page"><div id="page-header">
  20 <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.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>
  21 <p class="apache">Serveur HTTP Apache Version 2.5</p>
  22 <img alt="" src="../images/feather.png" /></div>
  23 <div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="../images/left.gif" /></a></div>
  24 <div id="path">
  25 <a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">Serveur HTTP</a> &gt; <a href="http://httpd.apache.org/docs/">Documentation</a> &gt; <a href="../">Version 2.5</a> &gt; <a href="./">Programmes</a></div><div id="page-content"><div id="preamble"><h1>rotatelogs - Rotation des journaux d'Apache par redirection de
  26   ces derniers dans un "pipe"</h1>
  27 <div class="toplang">
  28 <p><span>Langues Disponibles: </span><a href="../en/programs/rotatelogs.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
  29 <a href="../fr/programs/rotatelogs.html" title="Français">&nbsp;fr&nbsp;</a> |
  30 <a href="../ko/programs/rotatelogs.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a> |
  31 <a href="../tr/programs/rotatelogs.html" hreflang="tr" rel="alternate" title="Türkçe">&nbsp;tr&nbsp;</a></p>
  32 </div>
  33
  34      <p><code>rotatelogs</code> est un programme simple à utiliser en
  35      conjonction avec la fonctionnalité d'Apache de redirection dans un
  36      "pipe" des fichiers journaux. Il supporte une rotation basée sur un
  37      intervalle de temps ou une taille maximale du journal.</p>
  38 </div>
  39 <div id="quickview"><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#synopsis">Syntaxe</a></li>
  40 <li><img alt="" src="../images/down.gif" /> <a href="#options">Options</a></li>
  41 <li><img alt="" src="../images/down.gif" /> <a href="#examples">Exemples</a></li>
  42 <li><img alt="" src="../images/down.gif" /> <a href="#portability">Portabilité</a></li>
  43 </ul><h3>Voir aussi</h3><ul class="seealso"><li><a href="#comments_section">Commentaires</a></li></ul></div>
  44 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
  45 <div class="section">
  46 <h2><a name="synopsis" id="synopsis">Syntaxe</a><a title="Lien permanent" href="#synopsis" class="permalink">&para;</a></h2>
  47
  48      <p><code><strong>rotatelogs</strong>
  49      [ -<strong>l</strong> ]
  50      [ -<strong>L</strong> <var>nom-lien</var> ]
  51      [ -<strong>p</strong> <var>programme</var> ]
  52      [ -<strong>f</strong> ]
  53      [ -<strong>D</strong> ]
  54      [ -<strong>t</strong> ]
  55      [ -<strong>v</strong> ]
  56      [ -<strong>e</strong> ]
  57      [ -<strong>c</strong> ]
  58      [ -<strong>n</strong> <var>nombre-de-fichiers</var> ]
  59      <var>fichier-journal</var>
  60      <var>heure-de-rotation</var>|<var>taille-fichier</var>(B|K|M|G)
  61      [ <var>décalage</var> ]</code></p>
  62 </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
  63 <div class="section">
  64 <h2><a name="options" id="options">Options</a><a title="Lien permanent" href="#options" class="permalink">&para;</a></h2>
  65
  66 <dl>
  67
  68 <dt><code>-l</code></dt>
  69 <dd>Utilise le temps local plutôt que GMT comme base pour l'intervalle
  70 de temps ou pour le formatage de <code>strftime(3)</code> avec une
  71 rotation basée sur la taille.</dd>
  72
  73 <dt><code>-L</code> <var>nom-lien</var></dt>
  74 <dd>Etablit un lien physique entre le fichier journal courant et le lien
  75 spécifié. Cette option permet de consulter le journal de manière
  76 continue malgré les rotations via une commande du style <code>tail -F
  77 nom-lien</code>.</dd>
  78
  79 <dt><code>-p</code> <var>programme</var></dt>
  80 <dd>Avec cette option, <code>rotatelogs</code> exécutera le programme
  81 <var>programme</var> chaque fois qu'un nouveau fichier journal sera
  82 ouvert. Le nom du fichier nouvellement ouvert est passé comme premier
  83 argument au programme. Si l'exécution se produit après une rotation,
  84 l'ancien nom du fichier journal est passé au programme comme second
  85 argument. <code>rotatelogs</code>
  86 n'attend pas la fin du <var>programme</var> pour continuer son
  87 exécution, et cessera tout enregistrement de codes d'erreur lorsqu'il
  88 aura terminé son processus. Le <var>programme</var> utilise les mêmes
  89 canaux stdin, stdout, et stderr que rotatelogs, et hérite de son
  90 environnement.</dd>
  91
  92 <dt><code>-f</code></dt>
  93 <dd>Ouvre le fichier journal immédiatement, dès que
  94 <code>rotatelogs</code> démarre, au lieu d'attendre la lecture de la
  95 première entrée de journal (pour les sites peu chargés, il peut
  96 s'écouler un temps substantiel entre le démarrage du serveur et le
  97 traitement de la première requête, temps pendant lequel le fichier
  98 journal associé n'"existe" pas, ce qui peut causer des problèmes à
  99 certains utilitaires de journalisation automatiques).</dd>
 100
 101 <dt><code>-D</code></dt>
 102 <dd>Crée les répertoires parents du chemin du fichier journal s'ils
 103 n'existent pas déjà, ce qui permet d'utiliser le format
 104 <code>strftime(3)</code> dans les chemins au lieu du nom de fichier seul.</dd>
 105
 106 <dt><code>-t</code></dt>
 107 <dd>Provoque une troncature du fichier journal au lieu d'une rotation.
 108 Cela peut s'avérer utile lorsqu'un journal est élaboré en temps réel par
 109 une commande telle que tail, l'archivage des données n'étant ici pas
 110 nécessaire. Si aucun suffixe n'est ajouté au nom de fichier, les
 111 chaînes de format contenant des caractères '%' sont cependant
 112 respectées.
 113 </dd>
 114
 115 <dt><code>-v</code></dt>
 116 <dd>Affiche une sortie verbeuse sur STDERR. La sortie contient le
 117 résultat de l'interprétation de la configuration, ainsi que toutes les
 118 opérations d'ouverture et de fermeture de fichiers.</dd>
 119
 120 <dt><code>-c</code></dt>
 121 <dd>Crée un fichier journal pour chaque intervalle, même s'il est vide.</dd>
 122
 123 <dt><code>-e</code></dt>
 124 <dd>Envoie les messages de journalisation vers stdout. Ceci s'avère
 125 utile lorsque les journaux doivent être traités par un autre programme.</dd>
 126
 127 <dt><code>-n <var>nombre-de-fichiers</var></code></dt>
 128 <dd>Utilise une liste circulaire de fichiers sans repères de temps. Avec
 129 -n 3, la série de fichiers conservés sera "logfile",
 130 "logfile.1", "logfile.2" avec écrasement de "logfile".<br />
 131 Disponible à partir de la version 2.4.5 du serveur HTTP Apache.</dd>
 132
 133 <dt><code><var>fichier-journal</var></code></dt>
 134 <dd><p>Le chemin et le nom de base du fichier journal. Si
 135 <var>fichier-journal</var> contient des caractères '%', il est considéré
 136 comme une chaîne de formatage pour <code>strftime(3)</code>. Dans le cas
 137 contraire, le suffixe <var>.nnnnnnnnnn</var> est automatiquement ajouté
 138 et correspond au temps en secondes (sauf si l'option -t est spécifiée).
 139 Les deux formats calculent le temps
 140 de démarrage depuis le début de la période courante. Par exemple, si un
 141 temps de rotation de 86400 est spécifié, les champs heure, minute et
 142 seconde créés à partir du format <code>strftime(3)</code> auront tous
 143 pour valeur 0, en référence au début de la période de 24 heures courante
 144 (minuit).</p>
 145 <p>Si vous utilisez le formatage de noms de fichiers
 146 <code>strftime(3)</code>, assurez-vous que le format du fichier journal
 147 possède une granularité suffisamment importante pour générer un nom de
 148 fichier différent à chaque rotation des journaux. Si ce n'est pas le
 149 cas, la rotation va écraser le fichier existant au lieu d'en générer un
 150 nouveau. Par exemple, si <var>fichier-journal</var> était
 151 <code>/var/log/errorlog.%Y-%m-%d</code> avec une rotation à 5
 152 mégaoctets, et si la limite de 5 mégaoctets a été atteinte deux fois
 153 dans la même journée, le même nom de fichier va être généré, et la
 154 rotation va écraser le fichier existant.</p>
 155 </dd>
 156
 157 <dt><code><var>temps-rotation</var></code></dt>
 158
 159 <dd>Le temps entre deux rotations des fichiers journaux en secondes. La
 160 rotation intervient au début de cet intervalle. Par exemple, si le temps
 161 de rotation est de 3600, la rotation des fichiers journaux s'effectuera
 162 au début de chaque heure ; si le temps de rotation est de 86400, la
 163 rotation des fichiers journaux s'effectuera chaque nuit à minuit. (Si
 164 aucune donnée n'est enregistrée au cours d'un intervalle, aucun fichier
 165 ne sera créé).</dd>
 166
 167 <dt><code><var>taille-fichier</var>(B|K|M|G)</code></dt>
 168
 169 <dd>La taille maximale du fichier suivie par une des lettres
 170 <code>B</code> (Octets), <code>K</code> (KOctets), <code>M</code> (MOctets)
 171 ou <code>G</code> (GOctets).
 172 <p>
 173 Lorsque temps et taille sont spécifiés, la taille doit l'être après le
 174 temps. La rotation interviendra alors aussitôt que l'une des deux limites
 175 (temps ou taille) sera atteinte.
 176 </p>
 177 </dd>
 178
 179 <dt><code><var>décalage</var></code></dt>
 180
 181 <dd>Le décalage en minutes par rapport au temps UTC. Par défaut, le
 182 décalage est considéré comme nul et c'est le temps UTC qui est utilisé.
 183 Par exemple, pour utiliser le temps local de la zone UTC -5 heures,
 184 spécifiez une valeur de <code>-300</code> pour cette option. Dans la
 185 plupart des cas, il vaut mieux utiliser l'option <code>-l</code> que
 186 spécifier un décalage.</dd>
 187
 188 </dl>
 189 </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 190 <div class="section">
 191 <h2><a name="examples" id="examples">Exemples</a><a title="Lien permanent" href="#examples" class="permalink">&para;</a></h2>
 192
 193 <div class="example"><p><code>
 194      CustomLog "|bin/rotatelogs /var/log/fichier-journal 86400" common
 195 </code></p></div>
 196
 197      <p>Cette directive crée les fichiers /var/log/fichier-journal.nnnn
 198      où nnnn correspond au temps système auquel la journalisation
 199      démarre effectivement (ce temps sera toujours un multiple du temps
 200      de rotation, si bien que vous pouvez synchroniser les scripts cron
 201      avec lui). A la fin de chaque temps de rotation (ici après 24
 202      heures), une nouvelle journalisation démarre.</p>
 203
 204 <div class="example"><p><code>
 205      CustomLog "|bin/rotatelogs -l /var/log/fichier-journal.%Y.%m.%d 86400" common
 206 </code></p></div>
 207
 208      <p>Cette directive crée les fichiers
 209      /var/log/fichier-journal.yyyy.mm.dd où yyyy correspond à l'année,
 210      mm au mois et dd au jour du mois. La journalisation basculera vers
 211      un nouveau fichier chaque jour à minuit, temps local.</p>
 212
 213 <div class="example"><p><code>
 214      CustomLog "|bin/rotatelogs /var/log/fichier-journal 5M" common
 215 </code></p></div>
 216
 217      <p>Cette directive va effectuer une rotation du fichier journal
 218      chaque fois que la taille de ce dernier atteindra 5 MOctets.</p>
 219
 220 <div class="example"><p><code>
 221      ErrorLog "|bin/rotatelogs /var/log/journal-erreurs.%Y-%m-%d-%H_%M_%S 5M"
 222 </code></p></div>
 223      <p>Cette directive va effectuer une rotation du fichier journal des
 224      erreurs chaque fois que la taille de ce dernier atteindra 5
 225      MOctets, et le nom du fichier journal se présentera sous
 226      la forme <code>journal-erreurs.YYYY-mm-dd-HH_MM_SS</code>.</p>
 227
 228 <div class="example"><p><code>
 229      CustomLog "|bin/rotatelogs -t /var/log/journal 86400" common
 230 </code></p></div>
 231
 232      <p>Cet exemple crée le fichier /var/log/journal en le tronquant
 233      au démarrage, puis une fois par jour. Ce scénario implique qu'un
 234      processus séparé (tel que tail) traite le fichier en temps
 235      réel.</p>
 236
 237 </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 238 <div class="section">
 239 <h2><a name="portability" id="portability">Portabilité</a><a title="Lien permanent" href="#portability" class="permalink">&para;</a></h2>
 240
 241 <p>Les substitutions des chaînes de format du fichier journal suivantes
 242 doivent être supportées par toutes les implémentations de
 243 <code>strftime(3)</code> ; voir la page de manuel de
 244 <code>strftime(3)</code> pour les extensions spécifiques à une
 245 bibliothèque.</p>
 246
 247 <table class="bordered"><tr><td><code>%A</code></td><td>nom du jour de la semaine en entier
 248 (localisé)</td></tr>
 249 <tr class="odd"><td><code>%a</code></td><td>nom du jour de la semaine sur 3
 250 caractères (localisé)</td></tr>
 251 <tr><td><code>%B</code></td><td>nom du mois en entier (localisé)</td></tr>
 252 <tr class="odd"><td><code>%b</code></td><td>nom du mois sur 3 caractères (localisé)</td></tr>
 253 <tr><td><code>%c</code></td><td>date et heure (localisé)</td></tr>
 254 <tr class="odd"><td><code>%d</code></td><td>jour du mois sur 2 chiffres</td></tr>
 255 <tr><td><code>%H</code></td><td>heure sur 2 chiffres (de 0 à 24h)</td></tr>
 256 <tr class="odd"><td><code>%I</code></td><td>heure sur 2 chiffres (de 0 à 12h)</td></tr>
 257 <tr><td><code>%j</code></td><td>jour de l'année sur 3 chiffres</td></tr>
 258 <tr class="odd"><td><code>%M</code></td><td>minutes sur 2 chiffres</td></tr>
 259 <tr><td><code>%m</code></td><td>mois sur 2 chiffres</td></tr>
 260 <tr class="odd"><td><code>%p</code></td><td>suffixe am/pm pour l'heure de 0 à 12h
 261 (localisé)</td></tr>
 262 <tr><td><code>%S</code></td><td>secondes sur 2 chiffres</td></tr>
 263 <tr class="odd"><td><code>%U</code></td><td>semaine de l'année sur 2 chiffres
 264 (Dimanche est le premier jour de la semaine)</td></tr>
 265 <tr><td><code>%W</code></td><td> semaine de l'année sur 2 chiffres
 266 (Lundi est le premier jour de la semaine)</td></tr>
 267 <tr class="odd"><td><code>%w</code></td><td>jour de la semaine sur 1 chiffre
 268 (Dimanche est le premier jour de la semaine)</td></tr>
 269 <tr><td><code>%X</code></td><td>heure (localisée)</td></tr>
 270 <tr class="odd"><td><code>%x</code></td><td>date (localisée)</td></tr>
 271 <tr><td><code>%Y</code></td><td>année sur 4 chiffres</td></tr>
 272 <tr class="odd"><td><code>%y</code></td><td>année sur 2 chiffres</td></tr>
 273 <tr><td><code>%Z</code></td><td>nom de la zone de temps</td></tr>
 274 <tr class="odd"><td><code>%%</code></td><td>caractère littéral `%'</td></tr>
 275 </table>
 276
 277 </div></div>
 278 <div class="bottomlang">
 279 <p><span>Langues Disponibles: </span><a href="../en/programs/rotatelogs.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
 280 <a href="../fr/programs/rotatelogs.html" title="Français">&nbsp;fr&nbsp;</a> |
 281 <a href="../ko/programs/rotatelogs.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a> |
 282 <a href="../tr/programs/rotatelogs.html" hreflang="tr" rel="alternate" title="Türkçe">&nbsp;tr&nbsp;</a></p>
 283 </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&amp;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>
 284 <script type="text/javascript"><!--//--><![CDATA[//><!--
 285 var comments_shortname = 'httpd';
 286 var comments_identifier = 'http://httpd.apache.org/docs/trunk/programs/rotatelogs.html';
 287 (function(w, d) {
 288     if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
 289         d.write('<div id="comments_thread"><\/div>');
 290         var s = d.createElement('script');
 291         s.type = 'text/javascript';
 292         s.async = true;
 293         s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
 294         (d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
 295     }
 296     else {
 297         d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
 298     }
 299 })(window, document);
 300 //--><!]]></script></div><div id="footer">
 301 <p class="apache">Copyright 2018 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
 302 <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.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[//><!--
 303 if (typeof(prettyPrint) !== 'undefined') {
 304     prettyPrint();
 305 }
 306 //--><!]]></script>
 307 </body></html>