MailNews:Logging: Difference between revisions

Jump to navigation Jump to search
m
fix several anchor link names, better Thunderbird module searchfox
m (→‎Thunderbird Logging: hotkey for Error Console)
m (fix several anchor link names, better Thunderbird module searchfox)
Line 13: Line 13:
Also, we have two types of logging:
Also, we have two types of logging:
* [[MailNews:Logging#Thunderbird_Logging|Thunderbird logging]], for calendar, chat, gloda indexing and seach, ldap, nntp (news), pop, and smtp (sending mail)
* [[MailNews:Logging#Thunderbird_Logging|Thunderbird logging]], for calendar, chat, gloda indexing and seach, ldap, nntp (news), pop, and smtp (sending mail)
* [[MailNews:Logging#gecko_logging|Gecko logging]], which uses [[MailNews:Logging#Thunderibrd_Module_names|module names]], such as imap and imap autosync
* [[MailNews:Logging#gecko_logging|Gecko logging]], which uses [[MailNews:Logging#Thunderbird_Module_Names|module names]], such as imap and imap autosync


== Thunderbird Logging ==
== Thunderbird Logging ==


Modern logging is specified by [[MailNews:Logging#setting_a_preference|setting a preference]] in Thunderbird.  
Modern logging is specified by [[MailNews:Logging#Setting_a_Preference|setting a preference]] in Thunderbird.  


Unless otherwise specified, logging output goes to the Error Console, at Tools > Developer > Error Console or use the hotkey Control+Shift+J (Command+Shift+J on macOS).
Unless otherwise specified, logging output goes to the Error Console, at Tools > Developer > Error Console or use the hotkey Control+Shift+J (Command+Shift+J on macOS).
Line 98: Line 98:


Notes:
Notes:
* The current, full list of Thunderbird module names is seen in [https://searchfox.org/comm-central/search?q=LazyLogModule+.*\(%22&path=&case=true&regexp=true this searchfox query]. (which includes Firefox-specific and Core module names)
* The current, full list of Thunderbird module names is seen in [https://searchfox.org/comm-central/search?q=LazyLogModule.*%5C%28&path=mailnews&case=false&regexp=true this searchfox query].  
* Gecko modules potentially useful to Thunderbird users:  
* Gecko modules potentially useful to Thunderbird users:  
** nsHostResolver (for DNS)
** nsHostResolver (for DNS)
Line 134: Line 134:


'''MOZ_LOG''' syntax is a list of terms, separated by commas. There are two types of terms:  
'''MOZ_LOG''' syntax is a list of terms, separated by commas. There are two types of terms:  
* A '''CASE SENSITIVE''' module name and its [[MailNews:Logging#Logging_level|log level]], separated by a colon (:), such as '''example_module:5''' to enable the module example_module at logging level 5 (verbose).  
* A '''CASE SENSITIVE''' module name and its [[MailNews:Logging#Logging_Level|log level]], separated by a colon (:), such as '''example_module:5''' to enable the module example_module at logging level 5 (verbose).  
* Optional special strings (switches) to configure the logging behaviour. Some configuration switches take an integer parameter, in which case the integer is separated from the string by a colon (:). Most switches only apply in a specific output context. Full documentation at [https://firefox-source-docs.mozilla.org/xpcom/logging.html#the-moz-log-syntax].
* Optional special strings (switches) to configure the logging behaviour. Some configuration switches take an integer parameter, in which case the integer is separated from the string by a colon (:). Most switches only apply in a specific output context. Full documentation at [https://firefox-source-docs.mozilla.org/xpcom/logging.html#the-moz-log-syntax].


Line 141: Line 141:
''',timestamp''' adds a timestamp to all log lines - generally recommended, and required for all timeouts and issues which need to be correlated to an action at a given time of day  
''',timestamp''' adds a timestamp to all log lines - generally recommended, and required for all timeouts and issues which need to be correlated to an action at a given time of day  


===== Logging level =====
===== Logging Level =====


'''NOTE - do not use this section for ldap, nntp, pop3 and smtp. They are configured per [[MailNews:Logging#Thunderbird_Logging|Thunderbird logging]].
'''NOTE - do not use this section for ldap, nntp, pop3 and smtp. They are configured per [[MailNews:Logging#Thunderbird_Logging|Thunderbird logging]].
Line 158: Line 158:
=== Generating a Gecko Log ===
=== Generating a Gecko Log ===


'''NOTE - do not use this section for ldap, nntp, pop3 and smtp. They are configured in Thunderbird Settings, and log to the Thunderbird Error Console.''' Please refer to [[MailNews:Logging#Main_module_options_within_MailNews|module options]].
'''NOTE - do not use this section for ldap, nntp, pop3 and smtp. They are configured in Thunderbird Settings, and log to the Thunderbird Error Console.''' Please refer to [[MailNews:Logging#Thunderbird_Module_Names|module options]].


==== Windows ====
==== Windows ====
canmove, Confirmed users
2,230

edits

Navigation menu