Debug.log - Revision history

Sfws: add category

2021-08-19T14:13:26Z

add category

@@ Line 1: / Line 1: @@
 The debug logging feature is extremely useful in troubleshooting problems with Cumulus.
 == File growth and deletion ==
@@ Line 59: / Line 61: @@
 * 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|configuration file]], and add a line in the [Station] section: <tt>Logging = 1</tt>, then restart Cumulus 1.
 * From build 1003 onward, you can also turn it on/off using the '''Configuration''' menu (debug option is included in drop down of that menu).

Sfws: /* Turning debugging logging on/off */

2021-04-29T06:27:26Z

Turning debugging logging on/off

← Older revision		Revision as of 06:27, 29 April 2021
Line 50:		Line 50:
	9175.328 : TD = 0.0833333358168602 Lastval = 618 Firstval = 618 rate = 0		9175.328 : TD = 0.0833333358168602 Lastval = 618 Firstval = 618 rate = 0

	==Turning debugging logging on/off==		=Turning debugging logging on/off=

	*By default, logging of debugging information is disabled.		*By default, logging of debugging information is disabled.

Sfws: Protected "Debug.log": Experimentor removed Cumulus 1 details, and inserted MX stuff on wrong page ([Edit=Allow only administrators] (indefinite) [Move=Allow only administrators] (indefinite))

2021-04-29T06:26:50Z

Protected "Debug.log": Experimentor removed Cumulus 1 details, and inserted MX stuff on wrong page ([Edit=Allow only administrators] (indefinite) [Move=Allow only administrators] (indefinite))

← Older revision

Revision as of 06:26, 29 April 2021

Sfws: Remove text that was MX specific, this is a Cumulus 1 only page

2021-04-29T06:24:39Z

Remove text that was MX specific, this is a Cumulus 1 only page

@@ Line 1: / Line 1: @@
-The debug logging feature is extremely useful in troubleshooting problems with Cumulus and/or connectivity to your weather station or FTP upload communications.
+The debug logging feature is extremely useful in troubleshooting problems with Cumulus.
-Note:  Logging is turned on when you 'Save' the chnage in settings. It is automatically turned off if Cumulus is restarted. 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 to crash.
+To avoid loss (or inaccuracy) of readings being processed from your weather station, it is best if Cumulus is left running, and not restarted except when unavoidable. Consequently, the '''debug.log''' file will continually grow in size. If the file is left to grow too large, Cumulus will crash. Therefore, you '''should''' delete this file periodically .
 =File Location, Name and Format=
 =Sample File=
@@ Line 42: / Line 49: @@
 .328 : Adding LH entry, ts = 14:24:00 raintot = 618
 .328 : TD = 0.0833333358168602 Lastval = 618 Firstval = 618 rate = 0

Sfws: Reverted edits by Sfws (talk) to last revision by ExperiMentor

2021-04-29T06:04:43Z

Reverted edits by Sfws (talk) to last revision by ExperiMentor

@@ Line 1: / Line 1: @@
 .735 : 14:23:54 Realtime FTP Put attempt
@@ Line 63: / Line 42: @@
 .328 : Adding LH entry, ts = 14:24:00 raintot = 618
 .328 : TD = 0.0833333358168602 Lastval = 618 Firstval = 618 rate = 0

Sfws: Text replacement - "[[MXDiags" to "[[MXDiags_folder"

2021-02-01T09:21:25Z

Text replacement - "[[MXDiags" to "[[MXDiags_folder"

← Older revision		Revision as of 09:21, 1 February 2021
Line 3:		Line 3:
	The introduction to [[Diagnostics\|Diagnostics article]] is the place to look for general information about the files described here for Cumulus 1.		The introduction to [[Diagnostics\|Diagnostics article]] is the place to look for general information about the files described here for Cumulus 1.

	This article is only for Cumulus 1 users, please see [[~~MXDiags~~]] for equivalent file if you use Cumulus MX.		This article is only for Cumulus 1 users, please see [[MXDiags_folder]] for equivalent file if you use Cumulus MX.

	=Details=		=Details=

Sfws: /* File growth and deletion */

2021-01-24T11:59:27Z

File growth and deletion

← Older revision		Revision as of 11:59, 24 January 2021
Line 32:		Line 32:
	== File growth and deletion ==		== File growth and deletion ==

	~~A new file is created each time Cumulus is restarted, after deleting the oldest and renaming the other old files to maintain the naming sequence.~~ If debugging is switched off, periodically a message, confirming that as shown earlier, is added to the '''debug.log''' file, so it grows in size even when full diagnostics are not being stored.		If debugging is switched off, periodically a message, confirming that as shown earlier, is added to the '''debug.log''' file, so it grows in size even when full diagnostics are not being stored.

			If debugging is switched on, extensive messages of the format shown are added to the file and it will rapidly grow in size.
	Entries are added to the '''cumulus.~og''' file while Cumulus is left running, regardless of whether debugging is on or off (see example above).

	To avoid loss (or inaccuracy) of readings being processed from your weather station, it is best if Cumulus is left running, and not restarted except when unavoidable. Consequently, the ~~current~~ ~~diagnostic files~~ will grow in size. If the file is left to grow too large, Cumulus will crash. Therefore, you ~~may~~ ~~want~~ to ~~delete~~ ~~these~~ ~~files~~.		To avoid loss (or inaccuracy) of readings being processed from your weather station, it is best if Cumulus is left running, and not restarted except when unavoidable. Consequently, the '''debug.log''' file will continually grow in size. If the file is left to grow too large, Cumulus will crash. Therefore, you '''should''' delete this file periodically .

	Any diagnostic file can be deleted at any time as Cumulus does not read from them. Cumulus creates a new file if necessary to continue its logging.		Any diagnostic file can be deleted, at any time, as Cumulus does not read from them. Cumulus creates a new file if necessary to continue its logging.

	==Sample File for Cumulus 1==		==Sample File for Cumulus 1==

Sfws: /* File type, and content */

2021-01-24T11:54:36Z

File type, and content

← Older revision		Revision as of 11:54, 24 January 2021
Line 26:		Line 26:

	Entries in '''debug.log''' are identified by date as fraction, and time e.g. ''9173.516 : 14:23:59''.		Entries in '''debug.log''' are identified by date as fraction, and time e.g. ''9173.516 : 14:23:59''.


			if you need help with a Cumulus 1 problem, then it can be useful to place this file, and those in the [[Diags_folder#Solving Cumulus 1 Errors\|diags sub-folder]] into a zip and add that file to your post in the support forum.

	== File growth and deletion ==		== File growth and deletion ==

Sfws: cut

2021-01-24T11:50:14Z

cut

← Older revision		Revision as of 11:50, 24 January 2021
Line 36:		Line 36:

	Any diagnostic file can be deleted at any time as Cumulus does not read from them. Cumulus creates a new file if necessary to continue its logging.		Any diagnostic file can be deleted at any time as Cumulus does not read from them. Cumulus creates a new file if necessary to continue its logging.

	== Solving Cumulus 1 Errors ==

	The diagnostic file '''cumulus.~og''' also logs error messages, often with extra information compared to the error window (accessed by clicking ''error'' light/indicator), and that file may help you if you have a problem.

	When you ask for support via the forum, you often need to upload (as a zip) one, or all, of the diagnostic files in the '''Diags''' folder especially for problems that occur when you start or restart Cumulus. Include all files in the folder, unless you definitely know that a single diags file contains all the information for ''both when'' Cumulus 1 is running normally, ''and when'' it encountered the problem and failed.

	In Windows Explorer, open the Cumulus installation folder (default is C:\Cumulus). Right-click on the 'Diags' folder, and from the pop-up menu, select 'Send to -> Compressed (zipped) Folder' (available in most Windows versions). This will create a file called Diags.zip. Add '''debug.log''' from the folder above into the zip.

	Post your message in the forum, and attach the zip file using the 'Attachment' section below the area where you have typed your message (browse for the file, then click 'Add the file').

	==Sample File for Cumulus 1==		==Sample File for Cumulus 1==

Sfws: /* File type, and content */

2021-01-24T11:49:49Z

File type, and content

← Older revision		Revision as of 11:49, 24 January 2021
Line 26:		Line 26:

	Entries in '''debug.log''' are identified by date as fraction, and time e.g. ''9173.516 : 14:23:59''.		Entries in '''debug.log''' are identified by date as fraction, and time e.g. ''9173.516 : 14:23:59''.

	Entries in '''cumulus.~og''' are identified by a date (in your selected Windows locale format) and time (to milliseconds) e..g. 28/01/2017 14:29:31.083 : Reading cumulus.ini file

	These latter files log many of the actions performed by Cumulus 1. They will show the [[:Category:Cumulus Files\|Cumulus specific files]] that have been accessed, values found (or calculated) from log files, before and after values for updates to highs and lows for monthly and annual extreme records, rejected spikes, and much more.

	== File growth and deletion ==		== File growth and deletion ==