.. _topics-logs:

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

Without any configuration, trytond write INFO messages to standard output.

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
