asyncio logging documentation clarifications

[hardkrash]

BPO	21443
Nosy	@gvanrossum, @pitrou, @vstinner, @giampaolo, @hardkrash, @1st1, @Mariatta
Files	issue21443.patch

^{Note: these values reflect the state of the issue at the time it was migrated and might not reflect the current state.}

Show more details

GitHub fields:

assignee = None
closed_at = <Date 2016-10-13.20:58:53.679>
created_at = <Date 2014-05-05.20:19:57.648>
labels = ['type-bug', 'docs', 'expert-asyncio']
title = 'asyncio logging documentation clarifications'
updated_at = <Date 2016-10-13.20:58:53.677>
user = 'https://github.com/hardkrash'

bugs.python.org fields:

activity = <Date 2016-10-13.20:58:53.677>
actor = 'gvanrossum'
assignee = 'docs@python'
closed = True
closed_date = <Date 2016-10-13.20:58:53.679>
closer = 'gvanrossum'
components = ['Documentation', 'asyncio']
creation = <Date 2014-05-05.20:19:57.648>
creator = 'hardkrash'
dependencies = []
files = ['44992']
hgrepos = []
issue_num = 21443
keywords = ['patch']
message_count = 5.0
messages = ['217952', '219312', '278226', '278615', '278616']
nosy_count = 9.0
nosy_names = ['gvanrossum', 'pitrou', 'vstinner', 'giampaolo.rodola', 'hardkrash', 'docs@python', 'python-dev', 'yselivanov', 'Mariatta']
pr_nums = []
priority = 'normal'
resolution = 'fixed'
stage = 'resolved'
status = 'closed'
superseder = None
type = 'behavior'
url = 'https://bugs.python.org/issue21443'
versions = ['Python 3.4', 'Python 3.5']

[hardkrash]

The asyncio documentation should comment on how to mute and increase some of it's logging.

18.5.7.3. Logging
The asyncio module logs information with the logging module in the logger 'asyncio'.

Adding a bit of text that mentions the following line would be great.
"""
The default verbosity will include messages at logging.INFO level.
To modify the verbosity of asyncio logging add a similar line to your application.
logging.getLogger('asyncio').setLevel(logging.WARNING)
"""

Note:
While this is clear to active users of the logging module, it is not clear to novices, who want INFO in their applications but not from asyncio.

[gvanrossum]

Good idea.

[Mariatta]

Hi, I added the paragraph explaining how to change the log level for asyncio.
Please check it out.
Thanks :)

[python-dev]

New changeset e68b1b2515e9 by Guido van Rossum in branch '3.5':
Issue bpo-21443: Show how to change log level for asyncio.
https://hg.python.org/cpython/rev/e68b1b2515e9

New changeset 660058d76788 by Guido van Rossum in branch '3.6':
Issue bpo-21443: Show how to change log level for asyncio. (Merge 3.5->3.6)
https://hg.python.org/cpython/rev/660058d76788

New changeset 861d22bd852d by Guido van Rossum in branch 'default':
Issue bpo-21443: Show how to change log level for asyncio. (Merge 3.6->3.7)
https://hg.python.org/cpython/rev/861d22bd852d

[gvanrossum]

Thanks! Applied to 3.5, 3.6, 3.7. (We don't change 3.4 any more except for security fixes.)