From e0bb6b3dc17a5cbaaf8ca1b0290a37740c190417 Mon Sep 17 00:00:00 2001 From: Tom Keffer Date: Fri, 4 Mar 2022 08:17:56 -0800 Subject: [PATCH] Clarifies how logging overrides work. --- docs/usersguide.htm | 91 +++++++++++++++++++++++++++++++-------------- weewx.conf | 24 ++++++------ 2 files changed, 76 insertions(+), 39 deletions(-) diff --git a/docs/usersguide.htm b/docs/usersguide.htm index edf1585b..61770086 100644 --- a/docs/usersguide.htm +++ b/docs/usersguide.htm @@ -1669,7 +1669,7 @@ longitude = -77.0366 or CWOP.

-

log_success

+

log_success

If you set a value for log_success here, it will override the value set at the top-level and will apply only to RESTful services. In addition, subsection (e.g., [[CWOP]]).

-

log_failure

+

log_failure

If you set a value for log_failure here, it will override the value set at the top-level and will apply only to RESTful services. In addition,

log_success

-

In case of success, make a note in the system log. The default is True.

+

+ If you set a value here, it will apply only to the station registry. +

log_failure

-

In case of failure, make a note in the system log. The default is True.

+

+ If you set a value here, it will apply only to the station registry. +

+

[[AWEKAS]]

@@ -1771,11 +1776,15 @@ longitude = -77.0366

log_success

-

In case of success, make a note in the system log. The default is True.

+

+ If you set a value here, it will apply only to logging for AWEKAS. +

log_failure

-

In case of failure, make a note in the system log. The default is True.

+

+ If you set a value here, it will apply only to logging for AWEKAS. +

retry_login

@@ -1844,11 +1853,16 @@ longitude = -77.0366

log_success

-

In case of success, make a note in the system log. The default is True.

+

+ If you set a value here, it will apply only to logging for CWOP. +

log_failure

-

In case of failure, make a note in the system log. The default is True.

+

+ If you set a value here, it will apply only to logging for CWOP. +

+

[[PWSweather]]

@@ -1879,11 +1893,15 @@ longitude = -77.0366

log_success

-

In case of success, make a note in the system log. The default is True.

+

+ If you set a value here, it will apply only to logging for PWSweather. +

log_failure

-

In case of failure, make a note in the system log. The default is True.

+

+ If you set a value here, it will apply only to logging for PWSweather. +

retry_login

@@ -1931,11 +1949,15 @@ longitude = -77.0366

log_success

-

In case of success, make a note in the system log. The default is True.

+

+ If you set a value here, it will apply only to logging for WOW. +

log_failure

-

In case of failure, make a note in the system log. The default is True.

+

+ If you set a value here, it will apply only to logging for WOW. +

retry_login

@@ -2019,15 +2041,14 @@ longitude = -77.0366

log_success

- -

In case of success, make a note in the system log. The default is False for - Rapidfire mode, True for PWS mode. +

+ If you set a value here, it will apply only to logging for the Weather Underground.

log_failure

-

In case of failure, make a note in the system log. The default is False for - Rapidfire mode, True for PWS mode. +

+ If you set a value here, it will apply only to logging for the Weather Underground.

retry_login

@@ -2126,6 +2147,22 @@ longitude = -77.0366 class="symcode">WEEWX_ROOT. Generated files and images will be put here.

+

log_success

+

+ If you set a value for log_success here, it will override the value set at the top-level and will apply only to reporting. In addition, log_success can be set for individual reports by putting them under the appropriate + subsection (e.g., [[Seasons]]). +

+ +

log_failure

+

+ If you set a value for log_failure here, it will override the value set at the top-level and will apply only to reporting. In addition, log_failure can be set for individual reports by putting them under the appropriate + subsection (e.g., [[Seasons]]). +

+

data_binding

@@ -2816,22 +2853,22 @@ longitude = -77.0366 class="code">True.

-

data_binding

- -

The data binding to be used to store the data. This should match one of the bindings in the [DataBindings] section, below. Optional. Default is wx_binding. -

-

log_success

- Set to True to log successful insertions into the database. Otherwise, - False. Default is True. + If you set a value for log_success here, it will override the value set at the top-level and will apply only to archiving operations.

log_failure

- Set to True to log unsuccessful insertions into the database. Otherwise, - False. Default is True. + If you set a value for log_failure here, it will override the value set at the top-level and will apply only to archiving operations. +

+ +

data_binding

+ +

The data binding to be used to store the data. This should match one of the bindings in the [DataBindings] section, below. Optional. Default is wx_binding.

[StdTimeSynch]

diff --git a/weewx.conf b/weewx.conf index acd15517..f3050fd0 100644 --- a/weewx.conf +++ b/weewx.conf @@ -64,6 +64,10 @@ version = 4.7.0 [StdRESTful] + # Uncomment and change to override logging for uploading services. + # log_success = True + # log_failure = True + [[StationRegistry]] # To register this weather station with weewx, set this to true, # then fill out option 'station_url' above. @@ -138,15 +142,13 @@ version = 4.7.0 # Where the generated reports should go, relative to WEEWX_ROOT HTML_ROOT = public_html + # Uncomment and change to override logging for reports + # log_success = True + # log_failure = True + # The database binding indicates which data should be used in reports. data_binding = wx_binding - # Whether to log a successful operation - log_success = True - - # Whether to log an unsuccessful operation - log_failure = True - # Each of the following subsections defines a report that will be run. # See the customizing guide to change the units, plot types and line # colors, modify the fonts, display additional sensor data, and other @@ -408,15 +410,13 @@ version = 4.7.0 # Whether to include LOOP data in hi/low statistics loop_hilo = True + # Uncomment and change to override logging for archive operations + # log_success = True + # log_failure = True + # The data binding used to save archive records data_binding = wx_binding - # Whether to log successful archive operations - log_success = True - - # Whether to log unsuccessful archive operations - log_failure = True - ############################################################################## # This section binds a data store to a database.