Development Team/Almanac/Python Standard Logging - Revision history

Johannesponader: _logger.setLevel(logging.DEBUG)

2010-04-23T00:46:13Z

_logger.setLevel(logging.DEBUG)

← Older revision		Revision as of 20:46, 22 April 2010
Line 12:		Line 12:
	import logging		import logging
	_logger = logging.getLogger('annotate-activity')		_logger = logging.getLogger('annotate-activity')
			_logger.setLevel(logging.DEBUG)

	...		...
	_logger.debug('starting activity')		_logger.debug('starting activity')
Line 24:		Line 26:
	import logging.config		import logging.config
	_logger = logging.getLogger('activity-annotate')		_logger = logging.getLogger('activity-annotate')
			_logger.setLevel(logging.DEBUG)
	...		...
	#### Method: __init__, initialize this AnnotateActivity instance		#### Method: __init__, initialize this AnnotateActivity instance

Patrol: moved Walter is a wanker 12/Almanac/Python Standard Logging to Development Team/Almanac/Python Standard Logging over redirect: revert

2010-02-24T01:32:56Z

moved Walter is a wanker 12/Almanac/Python Standard Logging to Development Team/Almanac/Python Standard Logging over redirect: revert

← Older revision	Revision as of 21:32, 23 February 2010
(No difference)

Page move vandal: moved Development Team/Almanac/Python Standard Logging to Walter is a wanker 12/Almanac/Python Standard Logging: Walter is a wanker

2010-02-24T00:21:12Z

moved Development Team/Almanac/Python Standard Logging to Walter is a wanker 12/Almanac/Python Standard Logging: Walter is a wanker

← Older revision	Revision as of 20:21, 23 February 2010
(No difference)

Patrol: moved Anal bleaching 15/Almanac/Python Standard Logging to Development Team/Almanac/Python Standard Logging over redirect: revert

2010-02-21T22:41:50Z

moved Anal bleaching 15/Almanac/Python Standard Logging to Development Team/Almanac/Python Standard Logging over redirect: revert

← Older revision	Revision as of 18:41, 21 February 2010
(No difference)

Anal bleaching: moved Development Team/Almanac/Python Standard Logging to Anal bleaching 15/Almanac/Python Standard Logging: Anal bleaching

2010-02-21T22:22:22Z

moved Development Team/Almanac/Python Standard Logging to Anal bleaching 15/Almanac/Python Standard Logging: Anal bleaching

← Older revision	Revision as of 18:22, 21 February 2010
(No difference)

FGrose: DevelopmentTeam/Almanac/Python Standard Logging moved to Development Team/Almanac/Python Standard Logging: deCamel casing

2009-03-17T20:44:59Z

DevelopmentTeam/Almanac/Python Standard Logging moved to Development Team/Almanac/Python Standard Logging: deCamel casing

← Older revision	Revision as of 16:44, 17 March 2009
(No difference)

Dfarning-bot: Robot: Automated text replacement (-{{Sugar Almanac}} +{{Almanac}})

2009-02-06T18:57:17Z

Robot: Automated text replacement (-{{Sugar Almanac}} +{{Almanac}})

← Older revision		Revision as of 14:57, 6 February 2009
Line 1:		Line 1:
	{{~~Sugar~~ Almanac}}		{{Almanac}}

	=== What is the overall structure of python standard logging that I will use in Sugar? ===		=== What is the overall structure of python standard logging that I will use in Sugar? ===

Dfarning-bot: Python Standard Logging in Sugar moved to DevelopmentTeam/Almanac/Python Standard Logging: Robot: moved page

2009-02-06T16:45:18Z

Python Standard Logging in Sugar moved to DevelopmentTeam/Almanac/Python Standard Logging: Robot: moved page

← Older revision	Revision as of 12:45, 6 February 2009
(No difference)

Dfarning: 15 revisions

2009-02-06T16:03:07Z

15 revisions

← Older revision	Revision as of 12:03, 6 February 2009
(No difference)

146.115.56.126 at 03:20, 2 October 2008

2008-10-02T03:20:14Z

New page

{{Sugar Almanac}}

=== What is the overall structure of python standard logging that I will use in Sugar? ===

Sugar uses Python's Standard Logging<ref>[http://www.onlamp.com/pub/a/python/2005/06/02/logging.html OnLamp.com-- Python Standard Logging]</ref><ref>Python Library Reference -- [http://docs.python.org/lib/module-logging.html Logging]</ref> pretty much without modification. The diagram below conceptualizes how logging generally works.

[[Image: Logging-Sugar-Almanac.jpg | Logging Diagram for Python]]

=== How do I write to a log in my activity code? ===
Sugar uses [http://www.onlamp.com/pub/a/python/2005/06/02/logging.html python's standard logging]. The following code shows how to output something at the debug log level. The log message will be written to the standard log output destination (usually the console).

import logging
_logger = logging.getLogger('annotate-activity')
...
_logger.debug('starting activity')

=== How do I send my log output to multiple destinations, including a file and the console? ===

The code example below sets up the activity to output its logs to several destinations. In particular, we output to a file called 'Annotate.activity.log' in sugar's standard logging directory and to the console. There are many [http://docs.python.org/lib/node409.html different types of handler objects] that you can output to at the same time, depending upon your debugging and tracking needs.

<pre>
from sugar import logger
import logging
import logging.config
_logger = logging.getLogger('activity-annotate')
...
#### Method: __init__, initialize this AnnotateActivity instance
def __init__(self, handle):
activity.Activity.__init__(self, handle)

#Get the standard logging directory.
std_log_dir = logger.get_logs_dir()

#First log handler: outputs to a file called 'Annotate.activity.log'
file_handler = logging.FileHandler(os.path.join(std_log_dir, 'Annotate.activity.log'))
file_formatter = logging.Formatter('%(name)s -- %(asctime)s %(levelname)s:\n %(message)s\n')
file_handler.setFormatter(file_formatter)
_logger.addHandler(file_handler)

#Second log handler: outputs to a the console, using a slightly different output structure
console_handler = logging.StreamHandler()
console_formatter = logging.Formatter('%(name)s %(levelname)s ||| %(message)s')
console_handler.setFormatter(console_formatter)
_logger.addHandler(console_handler)
...
_logger.debug('Creating annotate activity UI')
</pre>

=== How do I read the log output that I have generated in my activity code? ===

How you read your log output depends of course on how and where you wrote your log output using Python's standard logging tools. Typically, you will want your logs to go to the console or to the standard logging directory.

If your log is being output to the console, the best thing to do is to launch your activity from the terminal using the 'sugar-launch <activity-name>' command. Then, all console output will be printed to the terminal. The main drawback of this method is that, since a lot of code directs log output to the console, you will have to sift through a lot of output. For example, the output below is some initial console output (including log output) from running an activity.

<pre>
[fanwar@localhost ~]$ sugar-launch annotate
[u'sugar-activity', u'annotateactivity.AnnotateActivity', '-b', dbus.String(u'org.laptop.AnnotateActivity', variant_level=1), '-a', 'b10b76394c10bd511dec1f9d5ac20af5d82a27aa']
1215605658.958459 WARNING root: Activity directory lacks a MANIFEST file.
1215605659.144058 DEBUG root: *** Act b10b76394c10bd511dec1f9d5ac20af5d82a27aa, mesh instance None, scope private
1215605659.144233 DEBUG root: Creating a jobject.
1215605659.145405 DEBUG root: datastore.write
1215605659.153947 DEBUG root: dbus_helpers.create: 8681691c-1859-4507-85f8-33b3836a446f
1215605659.154164 DEBUG root: Written object 8681691c-1859-4507-85f8-33b3836a446f to the datastore.
activity-annotate DEBUG ||| Creating annotate activity UI
1215605659.154495 DEBUG activity-annotate: Creating annotate activity UI
activity-annotate INFO ||| In _createToolBox method
1215605659.154779 INFO activity-annotate: In _createToolBox method
1215605659.211541 WARNING root: No gtk.AccelGroup in the top level window.
1215605659.214685 WARNING root: No gtk.AccelGroup in the top level window.
activity-annotate DEBUG ||| execing _createCanvas
1215605659.222814 DEBUG activity-annotate: execing _createCanvas
activity-annotate DEBUG ||| finished creating UI
1215605659.244071 DEBUG activity-annotate: finished creating UI
1215605659.315145 DEBUG root: ActivityService.set_active: 1.
** (sugar-activity:5646): DEBUG: Got client ID "10dc3d8b3e662f5a22121560565936684800000051360010"
** (sugar-activity:5646): DEBUG: Setting initial properties
** (sugar-activity:5646): DEBUG: Received SaveYourself(SmSaveLocal, !Shutdown, SmInteractStyleNone, !Fast) in state idle
** (sugar-activity:5646): DEBUG: Sending SaveYourselfDone(True) for initial SaveYourself
** (sugar-activity:5646): DEBUG: Received SaveComplete message in state save-yourself-done
1215605661.104732 DEBUG root: Activity.save: dbus.String(u'8681691c-1859-4507-85f8-33b3836a446f')
</pre>

In this case, I was primarily interested in the lines starting with activity-annotate.

You may want to output to a designated logfile where you can control exactly what is output (so that extraneous sugar log output is not interspersed with your activity output). The entry on [[Python_Standard_Logging_in_Sugar#How_do_I_send_my_log_output_to_multiple_destinations.2C_including_a_file_and_the_console.3F | writing to multiple files]] explains how to accomplish output to a logfile. If you write to a logfile in the standard sugar log directory, you can look at your log by opening up the log activity. In the terminal, the command 'sugar-launch log' will accomplish this. Below is a screenshot of the log activity as I look at the specific log for my Annotate activity.

[[Image:log-activity-almanac.jpeg|Looking at log output]]

= Notes =
<references />