MailNews:Logging: Difference between revisions

Jump to navigation Jump to search
remove obsolete tools, better references to current Gecko logging capabilities, misc fixes
(remove obsolete tools, better references to current Gecko logging capabilities, misc fixes)
Line 143: Line 143:
* Do your log variables contain quotation marks or other invalid characters?
* Do your log variables contain quotation marks or other invalid characters?
* Are your log module names correctly '''CASE SENSITIVE'''?  (meaning mixed case, or camel case which is not all upper case, nor all lower case)
* Are your log module names correctly '''CASE SENSITIVE'''?  (meaning mixed case, or camel case which is not all upper case, nor all lower case)
== Reference Documents ==
* [http://www.mozilla.org/projects/nspr/reference/html/prlog.html NSPR Reference (logging)]


== Other Protocol Logging options within MailNews ==
== Other Protocol Logging options within MailNews ==
Line 152: Line 148:
The following modules may or may not be available in release builds, but are available in debug builds:
The following modules may or may not be available in release builds, but are available in debug builds:


# CMS (for S/MIME)
# IMAPAutoSync (before Thunderbird version 59: ImapAutoSync)
# IMAPAutoSync (before Thunderbird version 59: ImapAutoSync)
# IMAP_CS (for CONDSTORE)
# IMAP_CS (for CONDSTORE)
Line 166: Line 163:
# negotiateauth (Mozilla core option)
# negotiateauth (Mozilla core option)


== Other Important MailNews logging ==
The full list of modules available are listed in [https://searchfox.org/comm-central/search?q=LazyLogModule+.*\(%22&path=&case=true&regexp=true this searchfox query].
 
== Other MailNews logging ==


* Log Gloda activity to console (Thunderbird only) [https://wiki.mozilla.org/Thunderbird:Debugging_Gloda Debugging Gloda]
* [https://wiki.mozilla.org/Thunderbird:Debugging_Gloda Log Gloda Indexing (global search) activity to Error Console]
* [[Calendar:QA_CalDAV_Support#Diagnosis_hints|Calendar/Lightning logging]]
* [[Calendar:QA_CalDAV_Support#Diagnosis_hints|Calendar/Calendar logging]]
* To show chat logging in the console, set <code>PRPL_LOG=0</code> or the <code>purple.debug.loglevel</code> pref
* To show chat logging in the console, set <code>PRPL_LOG=0</code> or the <code>purple.debug.loglevel</code> pref
** Logging for OTR is controlled by the <code>chat.otr.trace</code> boolean pref
** Logging for OTR is controlled by the <code>chat.otr.trace</code> boolean pref


== Other Useful NSPR Logging Options ==
== More NSPR Logging Options ==
 
The following modules may or may not be available in release builds, but are available in debug builds:
 
* nsDragService
 
The following modules are not owned by Mail&News, but useful for problem analysis of Mail&News.
 
* For NSS, see [https://wiki.mozilla.org/NSS:Tracing TSS:Tracing] (SSL)
 
* pipnss - S/MIME (nsCMSMessage) debugging
 
* nsHostResolver, nsSocketTransport [https://firefox-source-docs.mozilla.org/networking/http/logging.html HTTP_Logging] (DNS lookup, Socket log)
 
* timestamp [http://www.mozilla.org/projects/nspr/reference/html/prlog.html#25328 NSPR Reference, Chapter 26 Logging ] (Timestamp is added to NSPR log)
 
== Logging Tools ==
 
These tools do not work with current versions of Thunderbird:
 
* [https://addons.mozilla.org/en-US/thunderbird/addon/tbtracer/ TBTracer addon] by Thundersomething author "derdoc"


* [https://addons.mozilla.org/en-US/thunderbird/addon/loghelper/ loghelper addon] by jtcranmer
Thunderbird gets its logging capabilities from Firefox core aka Gecko, whose logging capabilities are documented at https://firefox-source-docs.mozilla.org/xpcom/logging.html. The many modules available are listed in [https://searchfox.org/mozilla-central/search?q=LazyLogModule+.*%5C%28%22&path=&case=true&regexp=true this searchfox query].  Some examples:
* nsHostResolver  (for DNS)
* GetAddrInfo  (for DNS)
* nsSocketTransport  (basic networking)


* Log Parsing - Logs can be difficult to parse because of their size. Andrew Sutherland has written [http://hg.mozilla.org/users/bugmail_asutherland.org/tb-test-help/file/678da3990640/nspr_imap_log_parser.py a parsing script] in Python for analyzing these logs. The script may need to be tweaked to suit your needs. There is more information at this [https://bugzilla.mozilla.org/show_bug.cgi?id=517466#c4 bug comment].
Miscellaneous [http://www.mozilla.org/projects/nspr/reference/html/prlog.html NSPR Reference (logging)].


== Enhancement Ideas ==  
== Enhancement Ideas ==  
canmove, Confirmed users
2,230

edits

Navigation menu