# logging.conf

You can specify a special logging configuration file in the `keystone.conf` configuration file. For example, `/etc/keystone/logging.conf`.

For details, see the Python logging module documentation.

    [loggers]
    keys=root,access

    [handlers]
    keys=production,file,access_file,devel

    [formatters]
    keys=minimal,normal,debug

    ###########
    # Loggers #
    ###########

    [logger_root]
    level=WARNING
    handlers=file

    [logger_access]
    level=INFO
    qualname=access
    handlers=access_file

    ################
    # Log Handlers #
    ################

    [handler_production]
    class=handlers.SysLogHandler
    level=ERROR
    formatter=normal
    args=(('localhost', handlers.SYSLOG_UDP_PORT), handlers.SysLogHandler.LOG_USER)

    [handler_file]
    class=handlers.WatchedFileHandler
    level=WARNING
    formatter=normal
    args=('error.log',)

    [handler_access_file]
    class=handlers.WatchedFileHandler
    level=INFO
    formatter=minimal
    args=('access.log',)

    [handler_devel]
    class=StreamHandler
    level=NOTSET
    formatter=debug
    args=(sys.stdout,)

    ##################
    # Log Formatters #
    ##################

    [formatter_minimal]
    format=%(message)s

    [formatter_normal]
    format=(%(name)s): %(asctime)s %(levelname)s %(message)s

    [formatter_debug]
    format=(%(name)s): %(asctime)s %(levelname)s %(module)s %(funcName)s %(message)s

this page last updated: 2026-06-11 21:45:03

Except where otherwise noted, this document is licensed under Creative Commons Attribution 3.0 License. See all OpenStack Legal Documents.

found an error? report a bug