Take the 2-minute tour ×

Somewhere in the bowels of my code I have something like:

logger = logging.getLogger('debug0.x')

The way I understand it, this should only respond when I have previously done something like:

logging.basicConfig(filename='10Nov2010a.txt',level=logging.DEBUG, name='debug0')

note that name has been defined as debug0. However, I have discovered that if do


without the name keyword, then the debug0.x logger defined above reacts, and writes to the log file. I was thinking it would only react in the first case, when the logger had been named.

I'm confused.

share|improve this question
You say the logger reacts. What to? It will react if you log to it. –  Sven Marnach Nov 10 '10 at 23:45
logging.basicConfig() has no name keyword argument. –  Sven Marnach Nov 10 '10 at 23:46

2 Answers 2

up vote 25 down vote accepted

The Python logging module organises logger in a hierarchy. All loggers are descendants of the root logger. Each logger passes log messages on to its parent.

New loggers are created with the getLogger() function. The function call logging.getLogger('debug0.x') creates a logger x which is a child of debug0 which itself is a child of the root logger. When logging to this logger, it will pass on the message to its parent, and its parent will pass the message to the root logger. You configured the root logger to log to a file by the basicConfig() function, so your message will end up there.

share|improve this answer
+1 sorry your comment was true; i think it's time for me to sleep :) –  mouad Nov 11 '10 at 0:09
Thank you! This answers my question about the hierarchy, even though I posed it poorly. –  reckoner Nov 11 '10 at 0:57

If you check out the code or the doc:

>>> print logging.basicConfig.__doc__

    Do basic configuration for the logging system.

    This function does nothing if the root logger already has handlers
    A number of optional keyword arguments may be specified, which can alter
    the default behaviour.

    filename  Specifies that a FileHandler be created, using the specified
              filename, rather than a StreamHandler.
              (if filemode is unspecified, it defaults to 'a').
    format    Use the specified format string for the handler.
    datefmt   Use the specified date/time format.
    level     Set the root logger level to the specified level.
    stream    Use the specified stream to initialize the StreamHandler. Note
              that this argument is incompatible with 'filename' - if both
              are present, 'stream' is ignored.

logging.basicConfig does not use name argument at all. It initializes the root logger. While getLogger takes a "name" argument

>>> print logging.getLogger.__doc__

    Return a logger with the specified name, creating it if necessary.

    If no name is specified, return the root logger.
share|improve this answer
Thanks. I guess I got confused because it did not complain about the 'name' keyword argument. –  reckoner Nov 11 '10 at 0:57
@reckoner: It happens to all of us :) –  pyfunc Nov 11 '10 at 0:59

Your Answer


