diff options
author | nicolargo <nicolas@nicolargo.com> | 2016-10-22 13:37:23 +0200 |
---|---|---|
committer | nicolargo <nicolas@nicolargo.com> | 2016-10-22 13:37:23 +0200 |
commit | e9da136f4dd9036f1a705bda379f394815dc0a55 (patch) | |
tree | f2964a84493dd9e3593704d75a6f8826ac29fcab /docs | |
parent | 9374e0c9a9631af64a975127d236c84f25e47369 (diff) |
Make the logger configurable (issue #900)
Diffstat (limited to 'docs')
-rw-r--r-- | docs/config.rst | 73 |
1 files changed, 73 insertions, 0 deletions
diff --git a/docs/config.rst b/docs/config.rst index a72f5be7..5e1060c9 100644 --- a/docs/config.rst +++ b/docs/config.rst @@ -110,3 +110,76 @@ By default, the ``glances.log`` file is under the temporary directory: If ``glances.log`` is not writable, a new file will be created and returned to the user console. + +If you want to use another system path or change the log message, you can use +your own logger configuration. First of all you have to create a glances.json +file with (for example) the following content (JSON format): + +.. code-block:: json + + { + "version": 1, + "disable_existing_loggers": "False", + "root": { + "level": "INFO", + "handlers": ["file", "console"] + }, + "formatters": { + "standard": { + "format": "%(asctime)s -- %(levelname)s -- %(message)s" + }, + "short": { + "format": "%(levelname)s: %(message)s" + }, + "free": { + "format": "%(message)s" + } + }, + "handlers": { + "file": { + "level": "DEBUG", + "class": "logging.handlers.RotatingFileHandler", + "formatter": "standard", + "filename": "/var/tmp/glances.log" + }, + "console": { + "level": "CRITICAL", + "class": "logging.StreamHandler", + "formatter": "free" + } + }, + "loggers": { + "debug": { + "handlers": ["file", "console"], + "level": "DEBUG" + }, + "verbose": { + "handlers": ["file", "console"], + "level": "INFO" + }, + "standard": { + "handlers": ["file"], + "level": "INFO" + }, + "requests": { + "handlers": ["file", "console"], + "level": "ERROR" + }, + "elasticsearch": { + "handlers": ["file", "console"], + "level": "ERROR" + }, + "elasticsearch.trace": { + "handlers": ["file", "console"], + "level": "ERROR" + } + } + } + +and start Glances using the following command line: + +.. code-block:: console + + LOG_CFG=<path>/glances.json glances + +Note: Replace <path> by the folder where your glances.json file is hosted. |