Difference between revisions of "Application:Lumberjack"

From WebOS Internals
Jump to navigation Jump to search
m
Line 11: Line 11:
  
 
Its goal is to make debugging apps without a workstation better and easier.
 
Its goal is to make debugging apps without a workstation better and easier.
 +
 +
 
== FAQ ==
 
== FAQ ==
 
[[File:main_screen.png|200px|right]]
 
[[File:main_screen.png|200px|right]]
Line 28: Line 30:
 
The DBus Capture button is to follow service requests in real time. It will show which applications are sending out requests and what the service returns.
 
The DBus Capture button is to follow service requests in real time. It will show which applications are sending out requests and what the service returns.
  
For example an application will request GPS services, the log will show this request and how the service responds to the request.
+
For example an application will request GPS services, the log will show this request and what data the service responds to the request.
  
  
Line 35: Line 37:
 
• Mojo.log events to document and debug their apps. For more information on this technique see Palm's API documentation here [http://developer.palm.com/index.php?option=com_content&view=article&id=1864&Itemid=253 Mojo.Log]
 
• Mojo.log events to document and debug their apps. For more information on this technique see Palm's API documentation here [http://developer.palm.com/index.php?option=com_content&view=article&id=1864&Itemid=253 Mojo.Log]
  
• Logging can also be displayed with javascripts alert() function
+
• Logging can also be displayed with javascripts alert() function, and can by viewed in lumberjack by selecting "Alerts" in the "What to look for" list.
  
  
Line 41: Line 43:
  
 
• Raw log, copies the exact row from the messages file
 
• Raw log, copies the exact row from the messages file
 +
 +
<pre>2010-10-17T10:51:20.712188Z [1070190] palm-webos-device user.crit LunaSysMgr: {LunaSysMgrJS}: org.webosinternals.lumberjack: Error: Test Error Message, palmInitFramework346:2520</pre>
  
 
&bull; Cleaned log is formatted
 
&bull; Cleaned log is formatted
 +
<pre>[2010-10-17 10:51:20] (Lumberjack) Error: Test Error Message</pre>
  
  
 
+
By default the device is at mojo.log.error level. so lumberjack changes LunaSysMgrJS to debug from error when it starts. then back to error when it closes. It is best to test your applications with lumberjack already open.
 
 
 
 
By default the device is at mojo.log.error level. so lumberjack changes LunaSysMgrJS to debug from error when it starts. then back to error when it closes.  
 
  
  

Revision as of 11:58, 17 October 2010

« Go Back to the Utilities application list
Lumberjack ss1.png

Lumberjack - 0.1.1 Beta


Summary

Icon WebOSInternals Lumberjack.png

Lumberjack is an on-device logging tool. It allows you to view and follow the logs for specific applications from the /var/log/messages file.

Its goal is to make debugging apps without a workstation better and easier.


FAQ

Main screen.png
Lumberjack logView.png

How is the "Retrieve Log" different from the "Follow Log"?

Applications are always logging, the Retrieve Log button gets the entire log since it was last cleared. Where as the Follow Log displays the log in real-time.

• The Follow Log displays logs in real-time.

• The Retrieve Log displays a static once look, but this can be updated by selecting the refresh button.


What is DBus Capture?

The DBus Capture button is to follow service requests in real time. It will show which applications are sending out requests and what the service returns.

For example an application will request GPS services, the log will show this request and what data the service responds to the request.


How do you write to logs?

• Mojo.log events to document and debug their apps. For more information on this technique see Palm's API documentation here Mojo.Log

• Logging can also be displayed with javascripts alert() function, and can by viewed in lumberjack by selecting "Alerts" in the "What to look for" list.


What's the difference between cleaned and raw log scene formats?

• Raw log, copies the exact row from the messages file

2010-10-17T10:51:20.712188Z [1070190] palm-webos-device user.crit LunaSysMgr: {LunaSysMgrJS}: org.webosinternals.lumberjack: Error: Test Error Message, palmInitFramework346:2520

• Cleaned log is formatted

[2010-10-17 10:51:20] (Lumberjack) Error: Test Error Message


By default the device is at mojo.log.error level. so lumberjack changes LunaSysMgrJS to debug from error when it starts. then back to error when it closes. It is best to test your applications with lumberjack already open.



Preferences screen.png