Monthly log files: Difference between revisions

From Cumulus Wiki
Jump to navigationJump to search
257 bytes added ,  09:58, 31 May 2020
m
m (1) added reference to MX api, and 2) added that special log is not available in MX)
Line 3: Line 3:
= Introduction =
= Introduction =


This article is about the log file that contains the values at whatever interval you have set for Cumulus to keep detailed logging. The main files are automatically created with names in the form <Month><Year>log.txt (for example, the file for August 2009 is often called <tt>Aug09log.txt</tt>), but the month can be in another language or a different abbreviation depending on your locale; an entry is made to the current month's file every ''ten'' (default value; you can change this on the station settings screen) minutes, recording the current sensor values. The file is in comma-separated format with one line per entry. Being comma separated does not mean the fields in this log are always separated by commas, they might use semi-colon (;) for example.
This article is about the standard logging file that stores the full set of current (read and derived) values at whatever interval you have set for Cumulus to keep detailed logging. The default is every 10 minutes, but you can change this:
*Cumulus 1: From Configuration menu, select the [[Cumulus_Screenshots#Station|station settings screen]], '''Data log interval''' box on extreme RH side.
*Cumulus MX: From settings tab, select the '''Station settings''' screen, and find '''Log interval''' after the ''Ecowitt GW1000 Settings'' section.


There is an equivalent log file for [[Extra_Sensor_Files|extra sensor]] values.  In fact, in Cumulus MX, the processing of this extra sensor logging file shares a lot of the code with the processing of the standard logging file, as they both are updated at same interval, and they both take values processed following a read from your weather station. The applications programming interface (api) that sends values between the MX engine and the MX admin interface is also identical (with a parameter "Extra" that swaps between true and false depending on the log file involved).
These files are automatically created with names in the form <Month><Year>log.txt (for example, the file for August 2009 is often called <tt>Aug09log.txt</tt>), but the month can be in another language or a different abbreviation depending on your locale.  


See [[speciallog.txt]] for the equivalent log file for detailed logging of internal temperature and humidity, but it is not split into separate files for each month.  Although this exists in Cumulus 1, it appears this functionality is missing from MX.
The standard logging file is in comma-separated format with one line per entry. Being comma separated does not mean the fields in this log are always separated by commas, they might use semi-colon (;) for example.
 
There is an equivalent logging file for [[Extra_Sensor_Files|extra sensor]] values.  In fact, in Cumulus MX, the processing of this extra sensor logging file shares a lot of the code with the processing of the standard logging file, as they both are updated at same interval, and they both take values processed following a read from your weather station. The applications programming interface (api) that sends values between the MX engine and the MX admin interface is also identical (with a parameter "Extra" that swaps between true and false depending on the log file involved).
 
There is another logging file, [[speciallog.txt]], for detailed logging of internal temperature and humidity, but it is not split into separate files for each month.  Although this exists in Cumulus 1, it appears this functionality is missing from MX.


{{TOCright}}
{{TOCright}}


= File content =
= File content =
5,838

edits

Navigation menu