Category:Log Files: Difference between revisions
From Cumulus Wiki
Jump to navigationJump to search
m (→TYPES: update count) |
|||
| (17 intermediate revisions by the same user not shown) | |||
| Line 1: | Line 1: | ||
This category is to be deprecated. Currently, it is only for legacy Cumulus 1 |
|||
Below is a list of the Log files within Cumulus. |
|||
| ⚫ | |||
| ⚫ | |||
== CAUTIONS == |
|||
Remember, if you edit any of these log files to obey cautions in the individual articles: |
|||
* stop cumulus before editing any file that Cumulus might be updating, |
|||
* don't use a word processor (that adds lots of unwanted control characters), |
|||
* don't change the format of files for example don't change format of dates or real numbers (using a spreadsheet, like Microsoft Office Excel or Libre Office Calc, don't let dates or special numbers be recognised), |
|||
* don't add 'Byte Order Mark' (many pieces of software on Microsoft Windows such as Notepad treat a BOM as a required magic number and add a BOM when saving text as UTF-8. Google Docs also adds a BOM when converting a document to a plain text file for download.), |
|||
* don't add blank lines to any Comma Separated Value files(the only 'blank' line in a log file is the final one, where Cumulus will later append the next item), (you can add blank lines to log files that contain "attribute=value" lines such as 'today.ini') |
|||
* don't add any header lines to any log files where Cumulus needs to read the file as well as update it (Cumulus reads all log files except Alltimelog.txt). |
|||
| ⚫ | |||
| ⚫ | |||
| ⚫ | |||
| ⚫ | |||
| ⚫ | |||
# '''.log''' file - cumulus 1 writes either "Logging Disabled" messages or logs its actions in detail for debugging purposes into [[debug.log]]. |
|||
# diagnostics files, see [[Diags|Cumulus 1 diagnostics]] and [[MXDiags|Cumulus MX diagnostics]] |
|||
=Explanation= |
|||
== CUMULUS 1 and MX differences == |
|||
*This sub-category provides links to pages that give explanations for all of the Log files within Cumulus 1. |
|||
Some files apply to both Cumulus 1 and Cumulus MX, some are only used by one flavour. See individual articles for such details. |
|||
| ⚫ | |||
* Note that in MX all file names are case-sensitive, please read documentation to see where capital letters are required in those file names. Be aware that wiki pages change first letter to a capital even when a file that must be all lower-case is being described. |
|||
* Cumulus 1 is reasonably tolerant of numbers using a comma to separate the integer and decimal part of real number. |
|||
** MX will accept both decimal commas and decimal full stops in the standard log files, the extra sensor log files, and the daily summary log file. |
|||
**MX always expects periods/full stops in .ini files regardless of the locale in use, please see the [https://cumulus.hosiene.co.uk/viewtopic.php?f=27&t=12908 Cumulus MX Announcements and Download - PLEASE READ FIRST] for details, but generally if you want to transfer these files from Cumulus 1 to MX, it is best if '''you edit them so all decimal numbers have a "." between the integer and decimal parts'''. |
|||
* Cumulus 1 is tolerant of various separators for dates and times. Cumulus MX insists all times use a colon separator, and all dates are in ISO format. |
|||
**However, MX will read the date/time entries in the Cumulus 1 format, and it will only change them to the new format when it needs to update a particular entry (e.g. an extreme) in that particular file. Consequently some files will have a different formats for the extremes that have existed for a while and for any new ones, meaning both formats will co-exist in those files. |
|||
* In individual articles, any differences in the precise content or format within individual files will be highlighted. |
|||
= Correcting Log files = |
|||
Cumulus MX also has some JSON files with data for its trends web page. See MX announcements for more details. |
|||
| ⚫ | |||
[[Calculate Missing Values]], [[Amending dayfile]], and [[Correcting Extremes]], are the pages to look at. |
|||
| ⚫ | |||
| ⚫ | |||
| ⚫ | |||
| ⚫ | |||
#* '''[[Speciallog.txt]]''' is only Cumulus 1. |
|||
| ⚫ | |||
# '''.log''' files, see both [[Debug.log|this page]] and [[Diags_folder|this page]] for Cumulus 1 diagnostics |
|||
Latest revision as of 10:03, 11 June 2021
This category is to be deprecated. Currently, it is only for legacy Cumulus 1
Explanation
- This sub-category provides links to pages that give explanations for all of the Log files within Cumulus 1.
- Descriptions, and tips, can also be found in the Help file within the Cumulus 1 software.
Correcting Log files
Calculate Missing Values, Amending dayfile, and Correcting Extremes, are the pages to look at.
TYPES
Essentially, there are 4 types:
- .ini files - these hold values that represent sums, counts, or extremes, for cumulus to read, and update, as it reads the weather observations, click on links below for details
- .txt files - these are the logs that Cumulus updates at defined intervals to hold details of what has happened, but it can also read these files when requested, click on links below for details
- Speciallog.txt is only Cumulus 1.
- .xml file - this holds the Cumulus 1 Weather_Diary. Although it uses standard XML, the component that Cumulus 1 uses also writes a special value that other XML editors will not understand.
- .log files, see both this page and this page for Cumulus 1 diagnostics
Pages in category "Log Files"
The following 5 pages are in this category, out of 5 total.
