Category:Diagnostics: Difference between revisions

From Cumulus Wiki
Jump to navigationJump to search
225 bytes removed ,  14:08, 19 August 2021
m
mNo edit summary
 
(11 intermediate revisions by the same user not shown)
Line 5: Line 5:


The file contains a wealth of data including the raw data received from your weather station, connectivity attempts, file uploads, etc.
The file contains a wealth of data including the raw data received from your weather station, connectivity attempts, file uploads, etc.
==Turning debugging log on/off==
*By default, logging of debugging information is disabled.
*Restarting Cumulus (1, 2, or MX) will normally (you can manually change this) turn debug log off (because it is automatically turned off as Cumulus exits)
*Logging of debugging information can be enabled as Cumulus is started (see instructions below for your flavour)
*[[File:Badge vMx.png]] In MX only, you can turn the logging of debugging information on and off while it is running, using the admin interface (see below to identify which settings screen)


The file can grow very large very quickly so turn the Debug Log option off it not required. If the file grows too large it can cause Cumulus (up to version 3.8.1 - b3091) to crash.  (From Release 3.8.2 - b3092 adds MXdiags log rotation to avoid this).  
The file can grow very large very quickly so turn the Debug Log option off it not required. If the file grows too large it can cause Cumulus (up to version 3.8.1 - b3091) to crash.  (From Release 3.8.2 - b3092 adds MXdiags log rotation to avoid this).  
Line 20: Line 11:


*By default, logging of debugging information is disabled.
*By default, logging of debugging information is disabled.
*Restarting Cumulus (1, 2, or MX) will normally (you can manually change this) turn debug log off (because it is automatically turned off as Cumulus exits)
*Restarting Cumulus (1, 2, or MX) will normally (you can manually change this) mean the debug log is off (because it is automatically turned off as Cumulus exits)
*Logging of debugging information can be enabled as Cumulus is started (see instructions below for your flavour)
*Logging of debugging information can be enabled as Cumulus is started (see instructions below for your flavour) or at some point while it is running (except earliest builds)


{{Version badge 1}}Cumulus 1.x.y:  Depending on which version of Cumulus 1 you are using there is either one or two ways of turning logging of debugging data on and off:
{{Version badge 1}}Cumulus 1.x.y:  Depending on which version of Cumulus 1 you are using there is either one or two ways of turning logging of debugging data on and off:
* The only way to turn on the logging of debugging messages in all builds of Cumulus 1, is to stop Cumulus 1, edit the [[Cumulus.ini#Section:_Station|Cumulus.ini configuration file]], and add a line in the [Station] section: <tt>Logging = 1</tt>, then restart Cumulus 1.  
* The only way to turn on the logging of debugging messages in all builds of Cumulus 1, is to stop Cumulus 1, edit the [[Cumulus.ini_(Cumulus_1)#Section:_Station|Cumulus.ini_(Cumulus_1) configuration file]], and add a line in the [Station] section: <tt>Logging = 1</tt>, then restart Cumulus 1.  
* From build 1003 onwards, you can also turn it on/off using the '''Configuration''' menu (debug option is included in drop down of that menu).
* From build 1003 onwards, you can also turn it on/off using the '''Configuration''' menu (debug option is included in drop down of that menu).


[[File:Badge vMx.png]]Cumulus MX: There are three ways to '''turn on the logging''' of debugging messages in all versions of Cumulus MX:
[[File:Badge vMx.png]]Cumulus MX: There are three ways to '''turn on the logging''' of debugging messages in all versions of Cumulus MX:
# Close Cumulus MX, then edit [[Cumulus.ini#Read-Write_parameters_in_the_Station_section|Cumulus.ini configuration file]], and add a line in the [Station] section: <tt>Logging = 1</tt>, then restart Cumulus MX.
# Close Cumulus MX, then edit [[Cumulus.ini_(Cumulus_1)#Read-Write_parameters_in_the_Station_section|Cumulus.ini_(Cumulus_1) configuration file]], and add a line in the [Station] section: <tt>Logging = 1</tt>, then restart Cumulus MX.
# When you start Cumulus MX, use [[Cumulus_MX#Parameter_for_adding_debugging|Parameter for adding debugging]] as part of the command for starting
# When you start Cumulus MX, from Version 3.4.4 - Build 3068, you can use [[MX_on_Linux#-debug_parameter_for_adding_debugging]] as part of the command for starting
# Use the [[MX_Administrative_Interface#Changing_Settings|admin interface Settings menu]], next ''tick'' the 'Debug Logging' menu option, and finally click '''Save''', on the appropriate web page depending on which version of MX you are using (see below). You can untick the option to disable the logging of debugging information
# Use the [[MX_Administrative_Interface#Changing_Settings|admin interface Settings menu]], selecting the appropriate web page depending on which version of MX you are using (see below). Here you can next ''tick'' the 'Debug Logging' menu option.  You can untick the option to disable the logging of debugging information. Whenever you make a change on this page, it does not take effect until you click '''Save'''.
#* '''Program settings''' web page for version 3.9.4 - build 3099 onwards
#* [[MX_Administrative_Interface#Program_Settings|'''Program settings''']] web page for version 3.9.4 - build 3099 onwards
#* [[MX_Administrative_Interface#Station_Settings|'''Station settings''']] web page for earlier MX versions
#* [[MX_Administrative_Interface#Station_Settings|'''Station settings''']] web page for releases 3.3.0 to 3.9.3


= Further details =
= Further details =
Line 40: Line 31:
== Debugging in Cumulus MX ==
== Debugging in Cumulus MX ==


Please see [[MXDiags|MX Diagnostics article]]
Please see [[MXdiags_folder|MX Diagnostics article]]




== Debugging in Cumulus 1 ==
== Debugging in Cumulus 1 ==


Please see [[Debug.log]] article.
Please see all these pages: [[Bugreport.txt]], [[Debug.log]], and [[Diags_folder]].


[[Category: Cumulus Files‏‎]]
[[Category: Cumulus Files‏‎]]
5,838

edits

Navigation menu