From 70ad7cd8bb6b8f7ef291d78c8882b264f5bcf162 Mon Sep 17 00:00:00 2001 From: Peter Silva Date: Sat, 11 Nov 2023 02:17:37 -0500 Subject: [PATCH] documenting that metrics are affected by logRotate options #817 --- docs/source/How2Guides/subscriber.rst | 19 +++++++++++-------- docs/source/Reference/sr3_options.7.rst | 4 ++-- docs/source/fr/CommentFaire/subscriber.rst | 10 +++++----- docs/source/fr/Reference/sr3_options.7.rst | 3 ++- 4 files changed, 20 insertions(+), 16 deletions(-) diff --git a/docs/source/How2Guides/subscriber.rst b/docs/source/How2Guides/subscriber.rst index a7bbb8e4b..52990a66d 100644 --- a/docs/source/How2Guides/subscriber.rst +++ b/docs/source/How2Guides/subscriber.rst @@ -927,27 +927,30 @@ logLevel, and logReject: At the end of the day (at midnight), these logs are rotated automatically by the components, and the old log gets a date suffix. The directory in which -the logs are stored can be overridden by the **log** option, the number of -rotated logs to keep are set by the **logRotate** parameter. The oldest log -file is deleted when the maximum number of logs has been reach and this -continues for each rotation. An interval takes a duration of the interval and -it may takes a time unit suffix, such as 'd\|D' for days, 'h\|H' for hours, -or 'm\|M' for minutes. If no unit is provided logs will rotate at midnight. +the logs and metrics are stored can be overridden by the **log** option, the +number of rotated logs to keep are set by the **logRotate** parameter. The +oldest log file is deleted when the maximum number of logs and metrics has been +reached and this continues for each rotation. An interval takes a duration of +the interval and it may takes a time unit suffix, such as 'd\|D' for days, 'h\|H' +for hours, or 'm\|M' for minutes. If no unit is provided logs will rotate at midnight. Here are some settings for log file management: - log ( default: ~/.cache/sarra/log ) (on Linux) The directory to store log files in. +- logMetrics ( default: True ) + whether to accumulate multiple metrics files at all. + - statehost ( default: False ) In large data centres, the home directory can be shared among thousands of nodes. Statehost adds the node name after the cache directory to make it unique to each node. So each node has it's own statefiles and logs. example, on a node named goofy, ~/.cache/sarra/log/ becomes ~/.cache/sarra/goofy/log. -- logRotate ( default: 5 , alias: lr_backupCount) +- logRotateCount ( default: 5 , alias: lr_backupCount) Maximum number of logs archived. -- logRotate_interval [] ( default: 1, alias: lr_interval) +- logRotateInterval [] ( default: 1, alias: lr_interval) The duration of the interval with an optional time unit (ie 5m, 2h, 3d) - permLog ( default: 0600 ) diff --git a/docs/source/Reference/sr3_options.7.rst b/docs/source/Reference/sr3_options.7.rst index 3c49c93af..f41f7d677 100644 --- a/docs/source/Reference/sr3_options.7.rst +++ b/docs/source/Reference/sr3_options.7.rst @@ -1060,12 +1060,12 @@ writing to stdout. logRotateCount ( default: 5 ) ---------------------------------------- -Maximum number of logs archived. +Maximum number of logs (both messages and metrics) archived. logRotateInterval [] ( default: 1d ) --------------------------------------------------------- -The duration of the interval with an optional time unit (ie 5m, 2h, 3d) +The duration of the interval with an optional time unit (ie 5m, 2h, 3d) for rotation of logs and metrics. messageCountMax (default: 0) diff --git a/docs/source/fr/CommentFaire/subscriber.rst b/docs/source/fr/CommentFaire/subscriber.rst index a95334fe2..f4a8ae0ac 100644 --- a/docs/source/fr/CommentFaire/subscriber.rst +++ b/docs/source/fr/CommentFaire/subscriber.rst @@ -898,9 +898,9 @@ logLevel et logReject : À la fin de la journée (à minuit), ces fichiers de journalisations sont pivotées automatiquement par les composants, et l’ancien journal obtient un suffixe de date. Le répertoire dans lequel les journaux sont stockés peut être remplacé par l’option **log**, le nombre -de journaux pivotés à conserver sont définis par le paramètre **logRotate**. Le journal le plus ancien -est supprimé lorsque le nombre maximal de journaux a été atteint et que cela -poursuit pour chaque rotation. Un intervalle prend une durée de l’intervalle et +de journaux pivotés à conserver sont définis par le paramètre **logRotate**. Le journal (et metriques) +le plus ancien est supprimé lorsque le nombre maximal de journaux (en messages et statistiques) a été +atteint et que cela poursuit pour chaque rotation. Un intervalle prend une durée de l’intervalle et cela peut prendre un suffixe d’unité de temps, tel que 'd\|D' pour les jours, 'h\|H' pour les heures, ou 'm\|M' pour les minutes. Si aucune unité n’est fournie, les journaux tourneront à minuit. Voici quelques paramètres pour la gestion des fichiers journaux : @@ -914,10 +914,10 @@ Voici quelques paramètres pour la gestion des fichiers journaux : unique à chaque nœud. Ainsi, chaque nœud a ses propres fichiers d’état et journaux. Par exemple, sur un nœud nommé goofy, ~/.cache/sarra/log/ devient ~/.cache/sarra/goofy/log. -- logRotate ( par défaut: 5 , alias: lr_backupCount) +- logRotateCount ( par défaut: 5 , alias: lr_backupCount) Nombre maximal de journaux archivés. -- logRotate_interval [] ( par défaut: 1, alias: lr_interval) +- logRotateInterval [] ( par défaut: 1, alias: lr_interval) La durée de l’intervalle avec une unité de temps optionnelle (ex. 5m, 2h, 3d) - permLog ( par défaut: 0600 ) diff --git a/docs/source/fr/Reference/sr3_options.7.rst b/docs/source/fr/Reference/sr3_options.7.rst index 19bed1dc3..8d6a831d9 100644 --- a/docs/source/fr/Reference/sr3_options.7.rst +++ b/docs/source/fr/Reference/sr3_options.7.rst @@ -1045,12 +1045,13 @@ la vitesse d’exécution de tous les processus qui écrivent à stdout. logRotateCount ( défaut: 5 ) --------------------------------------- -Nombre maximal de journaux archivés. +Nombre maximal de journaux de messages (logs) et statistiques (metrics) archivés. logRotateInterval [] ( défaut: 1d ) --------------------------------------------------------------- La durée de l’intervalle avec une unité de temps optionnel (soit 5m, 2h, 3d) +entre chaque changement de fichier journal (de messages et statistiques) messageCountMax (défaut: 0) -----------------------------------