.. _topics-logs:

=====================
Logging configuration
=====================

Without any configuration, trytond writes ERROR messages to standard output.
For each verbose flag set, the log level decreases.

Logs can be configured using a `configparser-format`_ file. The filename can
be specified using trytond ``logconf`` parameter.

.. _`configparser-format`: https://docs.python.org/2/library/logging.config.html#configuration-file-format

Example
=======

This example allows to write INFO messages on standard output and on a disk log
file rotated every day.

.. highlight:: ini

::

    [formatters]
    keys=simple

    [handlers]
    keys=rotate,console

    [loggers]
    keys=root

    [formatter_simple]
    format=[%(asctime)s] %(levelname)s:%(name)s:%(message)s
    datefmt=%a %b %d %H:%M:%S %Y

    [handler_rotate]
    class=handlers.TimedRotatingFileHandler
    args=('/tmp/tryton.log', 'D', 1, 30)
    formatter=simple

    [handler_console]
    class=StreamHandler
    formatter=simple
    args=(sys.stdout,)

    [logger_root]
    level=INFO
    handlers=rotate,console