5,838
edits
Monthly log files: Difference between revisions
From Cumulus Wiki
Jump to navigationJump to search
m
no edit summary
m (→File content) |
mNo edit summary |
||
| Line 3: | Line 3: | ||
= Introduction = | = Introduction = | ||
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: | 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 time between data logging lines 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 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. | *Cumulus MX: From settings tab, select the '''Station settings''' screen, and find '''Log interval''' after the ''Ecowitt GW1000 Settings'' section. | ||
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. | 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. There is no setting to change this format. | ||
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. | 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. | ||
| Line 19: | Line 19: | ||
= File content = | = File content = | ||
This file has one line added each time the Cumulus timer says the logging interval has passed. All data is logged in the units as selected by the user: | This file has one line added each time the Cumulus timer says the logging interval has passed. | ||
All data is logged in the units as selected by the user: | |||
*Cumulus 1: From Configuration menu, select the [[Cumulus_Screenshots#Station|station settings screen]], '''Units''' box is just below the centre of that screen. | |||
*Cumulus MX: From settings tab, select the '''Station settings''' screen, and find '''Units''' section at the start of that screen. | |||
Each line has a number of fields separated by whatever symbol is defined as the list separator on your device, typically a comma (,) or a semi-colon (;). | Each line has a number of fields separated by whatever symbol is defined as the list separator on your device, typically a comma (,) or a semi-colon (;). | ||
| Line 30: | Line 34: | ||
For ''more information'' on these files see in the '''Cumulus help''' file, in the section “The Data log file”. | For ''more information'' on these files see in the '''Cumulus help''' file, in the section “The Data log file”. This is installed with Cumulus 1, but can be read with Windows after downloading from [[Software#Resources]] page in this Wiki. | ||
= Accessing the monthly log file = | = Accessing the monthly log file = | ||
| Line 51: | Line 55: | ||
Select the required monthly log, click '''Open''' and you will see the contents in a neat table with column headings, rows striped, and the date/time on a lighter background. This is a text viewer, and works best when at full screen, but even then you are likely to need to scroll both horizontally and vertically to look at all the figures. If you click on an individual figure the cell will be highlighted, but you cannot edit the figures on a view screen. Cumulus 1 does not provide an editing facility for this file. | Select the required monthly log, click '''Open''' and you will see the contents in a neat table with column headings, rows striped, and the date/time on a lighter background. This is a text viewer, and works best when at full screen, but even then you are likely to need to scroll both horizontally and vertically to look at all the figures. If you click on an individual figure the cell will be highlighted, but you cannot edit the figures on a view screen. Cumulus 1 does not provide an editing facility for this file. | ||
=== Problems === | |||
If no logs seen, see [[FAQ#I_can.E2.80.99t_find_my_data_files.21|FAQ: I can't find my data files]]. Also note, this '''Data logs''' viewer is only for viewing standard log files (not any other files in the same ''data'' directory), the column headings for standard (monthly) log files will always be shown at the top of the screen. | |||
== Cumulus MX == | == Cumulus MX == | ||
In the admin interface, there is a "Data Logs" tab, from it select ''Data logs'' | In the admin interface, there is a "Data Logs" tab, from it select ''Data logs''. | ||
*On this screen,you see a box for selecting the log you want to display. The default month and year (shown on loading the web page) is taken from yesterday's date. No log is loaded at start up. You can '''either''' type in a period (one or two digit representing month, then hyphen, then four digits representing year) '''or''' select year then month in the data picker (this is produced by the bootstrap software MX uses, it is not the date picker provided by your browser), when you click on the month the box is updated with selected period. | |||
* Next to it is a "Load" button. Press it and the Cumulus MX engine will generate an application programming interface (api) table that will appear on the web page using datatables software. There is a "Refresh" button, for when you want that api to refresh the web page (without reloading the whole page). The table generated is paginated, it shows a fixed number of lines, and there are arrow icons to move to next, and back to previous page. | |||
When you click on any single line, two extra buttons (for editing that line and for deleting that line) are enabled. The Delete a line button brings up what the datatables software calls a modal, a pop up dialog where you see the fields on that row listed vertically and have two more buttons (Cancel and Delete) with obvious consequences. | |||
How to edit the log using this functionality has changed already for different MX versions and is planned to change again, so I am not describing it further for now. | |||
=== Problems === | |||
If you try to look at the current log, and it does not display in the MX admin interface, it | If you try to look at the current log, and it does not display in the MX admin interface, it might be because you are trying to view it at the same time as the MX engine is writing the next line to it. The exclusive locking stops the admin interface and the engine being able to both access the same file at the same time. So if your logging interval is every ten minutes, don't try to view it within 2 minutes of the hour and within 2 minutes of every ten minutes thereafter. That still gives you 6 minutes between each 10 minute update for viewing! Of course there is no conflict for past monthly logs. | ||
== Additional ideas for how Monthly log files can be used within Cumulus == | == Additional ideas for how Monthly log files can be used within Cumulus == | ||
