MXdiags folder - Revision history

Sfws: add category

2021-08-19T14:09:33Z

add category

← Older revision		Revision as of 14:09, 19 August 2021
Line 1:		Line 1:
	=Introduction=		=Introduction=
			[[Category:Diagnostics]]

	The introduction to [[:Category:Diagnostics\|Diagnostics article]] is the place to look for general information about the files described here for Cumulus MX.		The introduction to [[:Category:Diagnostics\|Diagnostics article]] is the place to look for general information about the files described here for Cumulus MX.

Sfws: /* How to change the content of the diagnostics log file */

2021-06-13T11:39:58Z

How to change the content of the diagnostics log file

← Older revision		Revision as of 11:39, 13 June 2021
Line 17:		Line 17:
	The "CreateMissing.exe" utility program will also store a log of what it does in this folder, see [[Calculate_Missing_Values#CreateMissing.exe]] for details.		The "CreateMissing.exe" utility program will also store a log of what it does in this folder, see [[Calculate_Missing_Values#CreateMissing.exe]] for details.

	= ~~How~~ to change the content of the diagnostics log file =		= Parameter when Starting MX to change the content of the diagnostics log file =

	The contents stored in these diagnostic log files can be enhanced by turning '''debugging on''' and/or by turning '''data logging''' on (see later sections for details of these).		The contents stored in these diagnostic log files can be enhanced by turning '''debugging on''' and/or by turning '''data logging''' on (see later sections for details of these).

	When starting MX, add '''CumulusMX.exe -debug''' (to have full debugging turned on as MX starts), '''CumulusMX.exe -Logging=1''' (for the weather station specific logging). For example, <pre>sudo mono CumulusMX.exe -debug -Logging=1</pre> for both options described below.		When starting MX beta, add '''CumulusMX.exe -debug''' (to have full debugging turned on as MX starts), '''CumulusMX.exe -Logging=1''' (for the weather station specific logging). For example, <pre>sudo mono CumulusMX.exe -debug -Logging=1</pre> for both options described below.

			Since MX came out of beta, the two options have been combined, only '''-debug''' is now required.

	You can also switch logging on/off using the admin interface as described below.		You can also switch logging on/off using the admin interface as described below.


	== Standard diagnostic Logging ==		== Standard diagnostic Logging ==

Sfws: Text replacement - "[[Diagnostics" to "[[:Category:Diagnostics"

2021-06-13T08:44:57Z

Text replacement - "[[Diagnostics" to "[[:Category:Diagnostics"

← Older revision		Revision as of 08:44, 13 June 2021
Line 1:		Line 1:
	=Introduction=		=Introduction=

	The introduction to [[Diagnostics\|Diagnostics article]] is the place to look for general information about the files described here for Cumulus MX.		The introduction to [[:Category:Diagnostics\|Diagnostics article]] is the place to look for general information about the files described here for Cumulus MX.

	This article is about the MX diagnostic log file. Please see the [[Debug.log]] article for Cumulus 1 specific equivalent.		This article is about the MX diagnostic log file. Please see the [[Debug.log]] article for Cumulus 1 specific equivalent.

Sfws: Update category

2021-06-11T09:57:52Z

Update category

← Older revision		Revision as of 09:57, 11 June 2021
Line 100:		Line 100:
	</pre>		</pre>

	[[Category:~~Log~~ Files]][[Category:Cumulus MX]]		[[Category:Cumulus Files]][[Category:Cumulus MX]]

Sfws: /* File naming, and content */ CreateMissing.exe

2021-06-09T15:14:50Z

File naming, and content: CreateMissing.exe

← Older revision		Revision as of 15:14, 9 June 2021
Line 12:		Line 12:
	These logging files are in sub-folder '''MXdiags''' within the '''CumulusMX''' root directory. It is a text (*.txt) file named by the date and time that the CumulusMX session began, for example: '''20210112-171450.txt'''		These logging files are in sub-folder '''MXdiags''' within the '''CumulusMX''' root directory. It is a text (*.txt) file named by the date and time that the CumulusMX session began, for example: '''20210112-171450.txt'''

	Entries are timestamped by date and time e.g. ''2020-09-07 14:26:21.793''.		Entries are timestamped by date and time e.g. ''2020-09-07 14:26:21.793''.


			The "CreateMissing.exe" utility program will also store a log of what it does in this folder, see [[Calculate_Missing_Values#CreateMissing.exe]] for details.

	= How to change the content of the diagnostics log file =		= How to change the content of the diagnostics log file =

Sfws: Sfws moved page MXDiags folder to MXdiags folder without leaving a redirect: correcting case of folder name

2021-05-22T20:52:50Z

Sfws moved page MXDiags folder to MXdiags folder without leaving a redirect: correcting case of folder name

← Older revision

Revision as of 20:52, 22 May 2021

Sfws: /* Data Logging */

2021-05-20T10:33:42Z

Data Logging

← Older revision		Revision as of 10:33, 20 May 2021
Line 37:		Line 37:
	#* (Example was given earlier)		#* (Example was given earlier)
	# Use the[[MX_Administrative_Interface#Changing_Settings\| admin interface Settings menu]], next tick the 'Data Logging' menu option, and finally click Save, on the appropriate web page depending on which version of MX you are using (see below).		# Use the[[MX_Administrative_Interface#Changing_Settings\| admin interface Settings menu]], next tick the 'Data 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		#* You can untick the option to disable the logging of data transfer information
	#** Program settings web page for version 3.9.4 - build 3099 onwards		#** Program settings web page for version 3.9.4 - build 3099 onwards
	#** Station settings web page for earlier MX versions		#** Station settings web page for earlier MX versions

Sfws: /* Data Logging */

2021-05-20T10:33:00Z

Data Logging

← Older revision		Revision as of 10:33, 20 May 2021
Line 36:		Line 36:
	# When you start Cumulus MX, use Parameter for adding debugging as part of the command for starting		# When you start Cumulus MX, use Parameter for adding debugging as part of the command for starting
	#* (Example was given earlier)		#* (Example was given earlier)
	# Use the[[MX_Administrative_Interface#Changing_Settings\| admin interface Settings menu]], next tick the 'Data 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]], next tick the 'Data 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
	#** Program settings web page for version 3.9.4 - build 3099 onwards		#** Program settings web page for version 3.9.4 - build 3099 onwards
	#** Station settings web page for earlier MX versions		#** Station settings web page for earlier MX versions

Sfws: /* Debug Logging */

2021-05-20T10:32:39Z

Debug Logging

← Older revision		Revision as of 10:32, 20 May 2021
Line 53:		Line 53:
	# Close Cumulus MX, then edit Cumulus.ini configuration file, and add a line in the [Station] section: Logging = 1, then restart Cumulus MX.		# Close Cumulus MX, then edit Cumulus.ini configuration file, and add a line in the [Station] section: Logging = 1, then restart Cumulus MX.
	# When you start Cumulus MX, use Parameter for adding debugging as part of the command for starting		# When you start Cumulus MX, use Parameter for adding debugging as part of the command for starting
	# Use the 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 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
⚫	#** ~~Program~~ settings web page for ~~version 3.9.4 - build~~ ~~3099~~ ~~onwards~~
	#** ~~Station~~ settings web page for ~~earlier~~ MX ~~versions~~		#** Use Program settings web page for version 3.9.4 - build 3099 onwards
		⚫	#** Use Station settings web page for earlier MX versions

	Up to release 3.11.1, any change made using the admin interface was not saved into [[Cumulus.ini]], and therefore when you restarted MX it reverted to setting in that file.		Up to release 3.11.1, any change made using the admin interface was not saved into [[Cumulus.ini]], and therefore when you restarted MX it reverted to setting in that file.

Sfws: /* Debug Logging */

2021-05-20T10:31:54Z

Debug Logging

← Older revision		Revision as of 10:31, 20 May 2021
Line 57:		Line 57:
	#** Station settings web page for earlier MX versions		#** Station settings web page for earlier MX versions

			Up to release 3.11.1, any change made using the admin interface was not saved into [[Cumulus.ini]], and therefore when you restarted MX it reverted to setting in that file.

			From release 3.11.2, any change made using the admin interface is now saved into [[Cumulus.ini]], and therefore when you restart MX, it continues to follow what was last set, over-ridden by any debug parameter added to the starting command.