MXdiags folder: Difference between revisions

322 bytes added ,  14:09, 19 August 2021
m
add category
m (add category)
 
(5 intermediate revisions by the same user not shown)
Line 1: Line 1:
=Introduction=
=Introduction=
 
[[Category:Diagnostics]]
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.
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 =
= 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 ==
Line 97: Line 100:
</pre>  
</pre>  


[[Category:Log Files]][[Category:Cumulus MX]]
[[Category:Cumulus Files]][[Category:Cumulus MX]]
5,838

edits